8: TSP command reference Model DMM7510 7½ Digit Graphical Sampling Multimeter
8-366 DMM7510-901-01 Rev. B / May 2015
userstring.add()
This function adds a user-defined string to nonvolatile memory.
Type TSP-Link accessible
Affected by Where saved Default value
Usage
userstring.add(name, value)
The name of the string; the key of the key-value pair
The string to associate with
name
; the value of the key-value pair
Details
This function associates the string value with the string name and stores this key-value pair in
nonvolatile memory.
Use the userstring.get() function to retrieve the value associated with the specified name.
You can use the userstring functions to store custom, instrument-specific information in the
instrument, such as department number, asset number, or manufacturing plant location.
Example
userstring.add("assetnumber", "236")
userstring.add("product", "Widgets")
userstring.add("contact", "John Doe")
for name in userstring.catalog() do
print(name .. " = " ..
userstring.get(name))
Stores user-defined strings in nonvolatile
memory and recalls them from the
instrument using a for loop.
Also see
userstring.catalog() (on page 8-366)
userstring.delete() (on page 8-367)
userstring.get() (on page 8-368)
userstring.catalog()
This function creates an iterator for the user-defined string catalog.
Type TSP-Link accessible
Affected by Where saved Default value
Function No
Usage
for name in userstring.catalog() do body end
The name of the string; the key of the key-value pair
Code to execute in the body of the for loop
Details
The catalog provides access for user-defined string pairs, allowing you to manipulate all the key-value
pairs in nonvolatile memory. The entries are enumerated in no particular order.