$ListNew: Difference between revisions
(Automatically generated page update) |
(→Syntax) |
||
| Line 20: | Line 20: | ||
All invocations of a particular call to <var>$ListNew</var> 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. | All invocations of a particular call to <var>$ListNew</var> 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== | |||
<var>$ListNew</var> is not allowed in the <var>Initial</var> clause of a [[Using_variables_and_values_in_computation#Declare_statements_for_.25variables|declaration statement]]. | |||
==Products authorizing {{PAGENAMEE}}== | ==Products authorizing {{PAGENAMEE}}== | ||
Revision as of 17:35, 15 February 2018
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.