TmListDestroy Procedure

Clears all items and destroys the list.

Usage

TmListDestroy, tool_name, list_name

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.

Keywords

None.

Discussion

Once a list is destroyed, do not access the list instance again without creating it using the TmList routine.

This procedure defines the behavior of the TM_LIST_DESTROY method.

Example

These commands destroy a list so that list_name is no longer a valid list handle.

list_name = TmList(tool_name)

TmListAppend, tool_name, list_name, 'First Item'

TmListDestroy, tool_name, list_name