$ListNew: Difference between revisions

From m204wiki
Jump to navigation Jump to search
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 [[to be entered]].</p>
<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 &OSQ.NOREL&CSQ., 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.
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" />

$ListNew Function

%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.

Products authorizing $ListNew