Add (Stringlist function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (consistent links)
m (consistent links)
Line 25: Line 25:
%list = new
%list = new
for each record in %recset
for each record in %recset
  %data = ssn with ',' with lname with ',' -
<p class="code">%data = ssn with ',' with lname with ',' -
          fname with ',' with mi
        fname with ',' with mi
  %list:add(%data)
%list:add(%data)
</p>
end for
end for
</pre>
</pre>

Revision as of 22:35, 6 February 2011

Add strings to Stringlist (Stringlist class)


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

Syntax

[%number =] sl:Add( itemList)

Syntax terms

%number A numeric variable to contain the number of items in the indicated Stringlist after the string has been added. %number 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

  • All errors result in request cancellation.
  • Before Sirius Mods Version 6.6, it was a request cancelling error to try to add a string longer than the size limit of a Stringlist item: 6124 bytes. This limitation was eliminated in Sirius Mods Version 6.6.
  • The Push and Enqueue stringlist methods are the same as the Add method. Push was designed as a convenience for use with Pop. Enqueue was designed as a convenience for use with Dequeue.

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
<p class="code">%data = ssn with ',' with lname with ',' -
        fname with ',' with mi
%list:add(%data)
</p>
end for

See also