$ListNew: Difference between revisions
m (1 revision) |
mNo edit summary |
||
Line 2: | Line 2: | ||
<span class="pageSubtitle"><section begin="desc" />Create empty $list<section end="desc" /></span> | <span class="pageSubtitle"><section begin="desc" />Create empty $list<section end="desc" /></span> | ||
<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $ListNew function is [[ | <p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $ListNew function is the [[New (Stringlist constructor)]].</p> | ||
This function creates an empty $list. | This function creates an empty $list. | ||
Line 8: | Line 8: | ||
The $ListNew function accepts one argument and returns a numeric result. | The $ListNew function accepts one argument and returns a numeric result. | ||
The first argument, if set to the string | The first argument, if set to the string <tt>NOREL</tt>, 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== | ==Syntax== | ||
<p class="syntax"><section begin="syntax" /> %RESULT = $ListNew(option) | <p class="syntax"><section begin="syntax" /> %RESULT = $ListNew(option) |
Revision as of 15:37, 10 February 2011
<section begin="desc" />Create empty $list<section end="desc" />
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.