Add (Stringlist function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (Undo revision 6463 by Dme (talk))
Line 5: Line 5:
Add is a member of the [[Stringlist class]].
Add is a member of the [[Stringlist class]].


==Syntax==
==Add syntax==
{{Template:Stringlist:Add syntax}}
<pre>
===Syntax terms===
[%rc =] %sl:Add(string)
<table class="syntaxTable">
</pre>
<tr><th>%rc<dd>A numeric variable to contain the number of items in the indicated Stringlist after the string has been added. '''%rc''' is also the item number associated with the added string in the Stringlist.<dt>%sl<dd>A Stringlist object.<dt>string<dd>A string that is to be added to the Stringlist. </th>
</table>


==Usage notes==
===Syntax Terms===
<dl>
<dt>%rc<dd>A numeric variable to contain the number of items in the indicated Stringlist after the string has been added. '''%rc''' is also the item number associated with the added string in the Stringlist.<dt>%sl<dd>A Stringlist object.<dt>string<dd>A string that is to be added to the Stringlist. </dl>
 
===Usage Notes===
<ul><li>All errors result in request cancellation.<li>Before ''[[Sirius Mods]]'' Version 6.6, it was a request cancelling error to try to add a longstring longer than the size limit of a Stringlist item: 6124 bytes. This limitation was eliminated in ''[[Sirius Mods]]'' Version 6.6.<li>The [[Push (Stringlist function)]] and [[Enqueue (Stringlist function)]] are the same as the Add method. Push was designed as a convenience for use with [[Pop (Stringlist function)]]. Enqueue was designed as a convenience for use with [[Dequeue (Stringlist function)]].
<ul><li>All errors result in request cancellation.<li>Before ''[[Sirius Mods]]'' Version 6.6, it was a request cancelling error to try to add a longstring longer than the size limit of a Stringlist item: 6124 bytes. This limitation was eliminated in ''[[Sirius Mods]]'' Version 6.6.<li>The [[Push (Stringlist function)]] and [[Enqueue (Stringlist function)]] are the same as the Add method. Push was designed as a convenience for use with [[Pop (Stringlist function)]]. Enqueue was designed as a convenience for use with [[Dequeue (Stringlist function)]].
</ul>
</ul>


==Examples==
===Examples===
In the following example, four comma-delimited field values are added to a Stringlist for each record in a Recordset:<pre>
In the following example, four comma-delimited field values are added to a Stringlist for each record in a Recordset:<pre>
%list is object stringList
%list is object stringList

Revision as of 04:58, 16 January 2011

Add string as new Stringlist item

This callable method adds arbitrary string data to a Stringlist. The Add method accepts one argument and returns a numeric result.

Add is a member of the Stringlist class.

Add syntax

[%rc =] %sl:Add(string)

Syntax Terms

%rc
A numeric variable to contain the number of items in the indicated Stringlist after the string has been added. %rc is also the item number associated with the added string in the Stringlist.
%sl
A Stringlist object.
string
A string that is to be added to the Stringlist.

Usage Notes

Examples

In the following example, four comma-delimited field values are added to a Stringlist for each record in a Recordset:

%list is object stringList
...
%list = new
for each record in %recset
%data = ssn with ',' with lname with ',' -
fname with ',' with mi
%list:add(%data)
end for