TmListAppend Procedure
Adds a new item at the end of the specified list.
Usage
TmListAppend, tool_name, list_name, item
Input Parameters
tool_name—A string specifying the unique name of a VDA Tool.
list_name—A string specifying the unique name of a list.
item—Item to append to the list. This can be any PV‑WAVE variable.
Keywords
None.
Discussion
If a new item is required elsewhere in the list, use TmListInsert instead of TmListAppend. If the list is not long enough to accept another item, the list is extended by the number of items specified when the list was created.
This procedure defines the behavior of the TM_LIST_APPEND method.
Example
The following code adds a string and an array to the end of a list.
; Adds the string 'My String' at the end of the list.
list_name = TmList(tool_name)
TmListAppend, tool_name, list_name, 'My String'
INFO, TmListRetrieve(tool_name, list_name), /Full
; <Expression> LIST = List(1)
; STRING = 'My String'
; Adds the array [1,2,3] at the end of the list.
TmListAppend, tool_name, list_name, [1,2,3]
INFO, TmListRetrieve(tool_name, list_name), /Full
; <Expression> LIST = List(2)
; STRING = 'My String'
; INT = Array(3)
See Also
