Section 9
:
Instrument Control Library (ICL)
Series 3700 System Switch/Multimeter Reference Manual
9-220
Document Number: 3700S-901-01 Rev. A / August 2007
userstring.add
Example
Stores user-defined strings in non- volatile memory:
userstring.add("assetnumber", "236")
userstring.add("department", "Widgets")
userstring.add("contact", "John Doe")
userstring.catalog
Function
Creates an iterator for the user string catalog.
Usage
for name in userstring.catalog() do
... end
Remarks
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.
Also see
userstring.add
(on page 9-219)
userstring.delete
(on page 9-220)
userstring.get
(on page 9-221)
Example
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
userstring.add
(on page 9-219) function. Notice that they are not listed in the order that they were
added.
userstring.delete
Function
Deletes a user-defined string from nonvolatile memory.
Usage
userstring.delete(name)
name
: Name of the user string.
Remarks
This function will delete from non- volatile memory the string that is associated with the
string name.