Section 9: Instrument Control Library (ICL)
userstring.add
Example
userstring.catalog
Function
Usage
Remarks
Also see
Example
userstring.delete
Function
Usage
Remarks
9-220
Stores user-defined strings in non- volatile memory:
userstring.add("assetnumber", "236")
userstring.add("department", "Widgets")
userstring.add("contact", "John Doe")
Creates an iterator for the user string catalog.
for name in userstring.catalog() do
... end
Accessing the catalog for user string names allows the user to print or delete all string
name values in nonvolatile memory. The entries will be enumerated in no particular
order.
userstring.add
(on page 9-219)
userstring.delete
(on page 9-220)
userstring.get
(on page 9-221)
To delete all user strings in non- volatile memory:
for name in userstring.catalog() do
userstring.delete(name)
end
To print all user string name value pairs in nonvolatile memory:
for name in userstring.catalog() do
print(name .. " = " .. userstring.get(name))
end
Output: department = Widgets
assetnumber = 236
contact = John Doe
The above output lists the user strings added in the "Example" for the
(on page 9-219) function. Notice that they are not listed in the order that they were
added.
Deletes a user-defined string from nonvolatile memory.
userstring.delete(name)
name: Name of the user string.
This function will delete from non- volatile memory the string that is associated with the
string name.
Series 3700 System Switch/Multimeter Reference Manual
Document Number: 3700S-901-01 Rev. A / August 2007
userstring.add