$ListNew: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
m (misc cleanup)
 
(2 intermediate revisions by 2 users not shown)
Line 2: Line 2:
<span class="pageSubtitle">Create empty $list</span>
<span class="pageSubtitle">Create empty $list</span>


<p class="warn"><b>Note: </b>Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $ListNew function is the <var>[[New (Stringlist constructor)|New]]</var> constructor.</p>
<p class="warn"><b>Note:</b> Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the <var>$ListNew</var> function is the <var>[[New (Stringlist constructor)|New]]</var> constructor.</p>


This function creates an empty $list.
The <var>$ListNew</var> function creates an empty $list. It
 
accepts one argument and returns a numeric result.  
The <var>$ListNew</var> function accepts one argument and returns a numeric result.
 
The 1st 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.  


==Syntax==
==Syntax==
Line 14: Line 11:
</p>
</p>


<table>
<tr><th>%result</th>
<td>A numeric variable that is set to the identifier of the created empty $list.
<p>
<p>
<var class="term">%result</var> is set to the identifier of the created empty $list.</p>
No error codes are associated with <var>$ListNew</var>. </p></td></tr>
 
<tr><th>option</th>
<td>The string <code>NOREL</code> indicates that the contents of the $list are not to be emptied if a <var>Release All Records</var> statement is executed. </td></tr>
</table>  


There are no error codes associated with <var>$ListNew</var>.  
==Usage notes==
<ul>
<li>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. </li>


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.
<li><var>$ListNew</var> is not allowed in the <var>Initial</var> clause of a [[Using variables and values in computation#Declare statements for %variables|declaration statement]]. </li>
</ul>


==Products authorizing {{PAGENAMEE}}==  
==Products authorizing {{PAGENAMEE}}==  
<ul class="smallAndTightList">
<ul class="smallAndTightList">
<li>[[List of $functions|Sirius functions]]</li>
<li>[[Sirius Functions]]</li>
<li>[[Fast/Unload User Language Interface]]</li>
<li>[[Fast/Unload User Language Interface]]</li>
<li>[[Media:JoclrNew.pdf|Janus Open Client]]</li>
<li>[[Media:JoclrNew.pdf|Janus Open Client]]</li>
Line 30: Line 37:
<li>[[Janus Web Server]]</li>
<li>[[Janus Web Server]]</li>
<li>Japanese functions</li>
<li>Japanese functions</li>
<li>[[Media:SirfieldNew.pdf|Sir2000 Field Migration Facility]</li>
<li>[[Media:SirfieldNew.pdf|Sir2000 Field Migration Facility]]</li>
</ul>
</ul>
   
   
[[Category:$Functions|$ListNew]]
[[Category:$Functions|$ListNew]]

Latest revision as of 21:21, 15 February 2018

Create empty $list

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

The $ListNew function creates an empty $list. It accepts one argument and returns a numeric result.

Syntax

%result = $ListNew([option])

%result A numeric variable that is set to the identifier of the created empty $list.

No error codes are associated with $ListNew.

option The string NOREL indicates that the contents of the $list are not to be emptied if a Release All Records statement is executed.

Usage notes

  • 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.
  • $ListNew is not allowed in the Initial clause of a declaration statement.

Products authorizing $ListNew