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'