User manual

Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL)
3700S-901-01 Rev. C / July 2008 13-311
userstring.catalog()
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 13-310) 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.
Also see
userstring.add() (on page 13-310)
userstring.catalog() (on page 13-310)
userstring.get() (on page 13-311)
Example
Deletes user-defined strings from nonvolatile memory:
userstring.delete("assetnumber")
userstring.delete("department")
userstring.delete("contact")
userstring.get()
Function
Retrieves a user-defined string from nonvolatile memory.
Usage
value = userstring.get(name)
name: Name of the user string.
value: Returns the string value associated with name.
Remarks
This function will retrieve from non- volatile memory the string that is associated with
the string name.