$Lstr: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Created page with "{{DISPLAYTITLE:$Lstr}} <span class="pageSubtitle"><section begin="desc" />Treat a string as longstring<section end="desc" /></span> <p class="warning">Most Sirius $functions hav...")
 
m (1 revision)
(No difference)

Revision as of 22:28, 8 February 2011

<section begin="desc" />Treat a string as longstring<section end="desc" />

Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Lstr function is to be entered.

This function takes a string or longstring input and produces a longstring output.

The $Lstr function accepts one argument and returns a longstring result.

The first argument is an arbitrary string or longstring.

Syntax

<section begin="syntax" /> %STR = $Lstr(longstring) <section end="syntax" />

$Lstr Function

%STR is a copy of longstring.


The main utility of the $Lstr function is to force a STRING WITH expression that is its argument to be upgraded to a LONGSTRING WITH expression. For example,

IF %COMEDIANS EQ (%WHO WITH ' Costello')

would truncate (%WHO WITH 'Costello') at 255 bytes before the comparison even if %COMEDIANS is a LONGSTRING %variable but

IF %COMEDIANS EQ $Lstr(%WHO WITH ' Costello')

would not.

For more information see :hdref refid=lstr..

$Lstr is only available in Sirius Mods Version 6.2 and later.

Products authorizing $Lstr