$ListNew: Difference between revisions
m (1 revision) |
m (1 revision) |
||
Line 16: | Line 16: | ||
</p> | </p> | ||
<p class="caption">%RESULT is set to the identifier of the created empty $list.</p> | <p class="caption">%RESULT is set to the identifier of the created empty $list.</p> | ||
There are no error codes associated with $ListNew. | There are no error codes associated with <var>$ListNew</var>. | ||
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.<p> | 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.<p> |
Revision as of 21:17, 19 October 2012
Create empty $list
Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $ListNew function is the New (Stringlist constructor).
This function creates an empty $list.
The $ListNew function accepts one argument and returns a numeric result.
The first 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. This is an optional argument.
Syntax
<section begin="syntax" /> %RESULT = $ListNew(option) <section end="syntax" />
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.