$Lstr C2X: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
mNo edit summary
Line 2: Line 2:
<span class="pageSubtitle">Convert byte string to hexadecimal</span>
<span class="pageSubtitle">Convert byte string to hexadecimal</span>


<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Lstr_C2X function is the [[StringToHex (String function)]].</p>
<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Lstr_C2X function is the <var>[[StringToHex (String function)|StringToHex]]</var> function.</p>


This function converts a byte string into its hexadecimal encoding. It is identical to [[$C2X]] (see the <i>[http://www.rocketsoftware.com/m204/products/index/documentation/v7r4/M204-User-Language/view Rocket Model 204 User Language Manual]</i>), except it is longstring capable.  
This function converts a byte string into its hexadecimal encoding. It is identical to [[$C2X]] (see the <i>[http://www.rocketsoftware.com/m204/products/index/documentation/v7r4/M204-User-Language/view Rocket Model 204 User Language Manual]</i>), except it is longstring capable.  
Line 15: Line 15:
<p class="syntax"><span class="term">%CODED</span> = <span class="literal">$Lstr_C2X</span>(<span class="term">string</span>)
<p class="syntax"><span class="term">%CODED</span> = <span class="literal">$Lstr_C2X</span>(<span class="term">string</span>)
</p>
</p>
<p>
<p>
</p>
<var class="term">%CODED</var> is set to the hexadecimal encoding of <var class="term">string</var></p>
<p>%CODED is set to the hexadecimal encoding of ''string''</p>


For example, the following code
==Usage notes==
<ul>
<li><var>[[$Lstr_X2C]]</var> is the inverse of $Lstr_C2X.


<p class="code"> PRINT $Lstr_C2X('Red rum')
<li>This $function is new in Version 6.8 of the <var class="product">[[Sirius Mods]]</var>.
</p>
</ul>


would print <tt>D985844099A494</tt>, which is the hexadecimal representation of the EBCDIC characters "Red rum".  
==Example==
The following code would print <code>D985844099A494</code>, which is the hexadecimal representation of the EBCDIC characters "Red rum".  


[[$Lstr_X2C]] is the inverse of $Lstr_C2X.
<p class="code">PRINT $Lstr_C2X('Red rum')
 
</p>
This $function is new in Version 6.8 of the <var class="product">[[Sirius Mods]]</var>.<p>


==Products authorizing {{PAGENAMEE}}==  
==Products authorizing {{PAGENAMEE}}==  
Line 40: Line 42:
<li>[[Japanese functions]]</li>
<li>[[Japanese functions]]</li>
<li>[[Sir2000 Field Migration Facility]]</li>
<li>[[Sir2000 Field Migration Facility]]</li>
</ul>
</ul>
   
   
</p>
<p>2X
</p>
[[Category:$Functions|$Lstr_C2X]]
[[Category:$Functions|$Lstr_C2X]]

Revision as of 23:36, 15 April 2013

Convert byte string to hexadecimal

Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Lstr_C2X function is the StringToHex function.

This function converts a byte string into its hexadecimal encoding. It is identical to $C2X (see the Rocket Model 204 User Language Manual), except it is longstring capable.

The $Lstr_C2X function accepts one argument and returns a string result which is the hexadecimal encoding of that argument.

The first argument is a longstring.

The returned value is the hexadecimal encoding of the argument string.

Syntax

%CODED = $Lstr_C2X(string)

%CODED is set to the hexadecimal encoding of string

Usage notes

Example

The following code would print D985844099A494, which is the hexadecimal representation of the EBCDIC characters "Red rum".

PRINT $Lstr_C2X('Red rum')

Products authorizing $Lstr_C2X