$ListNew

From m204wiki
Revision as of 17:35, 15 February 2018 by ELowell (talk | contribs) (→‎Syntax)
Jump to navigation Jump to search

Create empty $list

Note: Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $ListNew function is the New constructor.

This function creates an empty $list.

The $ListNew function accepts one argument and returns a numeric result.

The 1st argument, if set to the string NOREL, indicates that the contents of the $list are not to be emptied when a RELEASE ALL RECORDS statement is executed.

Syntax

%result = $ListNew([option])

%result is set to the identifier of the created empty $list.

There are no error codes associated with $ListNew.

All invocations of a particular call to $ListNew will always return the same value. Each time that call is executed, any previous $list created by that call is deleted, and a new list is created.

Usage notes

$ListNew is not allowed in the Initial clause of a declaration statement.

Products authorizing $ListNew