View source for $Lstr

{{DISPLAYTITLE:$Lstr}}
<span class="pageSubtitle">Treat a string as longstring</span>

<p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $Lstr function.</p>

This function takes a <var>String</var> or <var>Longstring</var> input and produces a <var>Longstring</var> output. 

==Syntax==
<p class="syntax"><span class="term">%longstr</span> = <span class="literal">$Lstr</span>(<span class="term">longstring</span>)
</p>

<p>
<var class="term">%longstr</var> is a copy of <var class="term">longstring</var>.</p>

The <var class="term">longstring</var> argument is an arbitrary string or longstring.

==Usage notes==
<ul>
<li>The main utility of the <var>$Lstr</var> function is to force a STRING WITH expression that is its argument to be upgraded to a LONGSTRING WITH expression.
</ul>

==Example==
For example,
<p class="code">IF %COMEDIANS EQ (%WHO WITH ' Costello')
</p>
truncates <code>%WHO WITH 'Costello'</code> at 255 bytes before the comparison, even if <code>%COMEDIANS</code> is a LONGSTRING %variable.
However, this statement does not:
<p class="code">IF %COMEDIANS EQ $Lstr(%WHO WITH ' Costello')</p>

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