Push (Stringlist function)

From m204wiki
Revision as of 14:17, 24 November 2010 by Admin (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Add string as new Stringlist item

This callable method adds arbitrary string data to the end of a Stringlist. Available in Sirius Mods version 7.0 and later, the Push method accepts one argument and returns a numeric result.

Push is a member of the Stringlist class.

Push Syntax

[%rc =] %sl:Push(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

  • All errors result in request cancellation.
  • Before Sirius Mods Version 6.6, it was a request canceling 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.
  • The Add (Stringlist function) is the same as the Push method; Push was designed as a convenience for use with the Pop (Stringlist function).