$Lstr C2X: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
mNo edit summary
Line 2: Line 2:
<span class="pageSubtitle"><section begin="desc" />Convert byte string to hexadecimal<section end="desc" /></span>
<span class="pageSubtitle"><section begin="desc" />Convert byte string to hexadecimal<section end="desc" /></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 [[to be entered]].</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 [[StringToHex (String function)]].</p>


 
This function converts a byte string into its hexadecimal encoding. It is identical to [[$C2X]] (see the ''"Model 204 User Language Manual"''), except it is longstring capable.  
 
This function converts a byte string into its hexadecimal encoding. It is identical to $C2X (see the ''"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 $Lstr_C2X function accepts one argument and returns a string result which is the hexadecimal encoding of that argument.  
Line 13: Line 11:


The returned value is the hexadecimal encoding of the argument string.
The returned value is the hexadecimal encoding of the argument string.
==Syntax==
==Syntax==
<p class="syntax"><section begin="syntax" /> %CODED = $Lstr_C2X(string)
<p class="syntax"><section begin="syntax" /> %CODED = $Lstr_C2X(string)
Line 18: Line 17:
<p class="caption">$Lstr_C2X Function
<p class="caption">$Lstr_C2X Function
</p>
</p>
<p class="caption">%CODED is set to the hexadecimal encoding of :hp1.string:ehp1..</p>
<p class="caption">%CODED is set to the hexadecimal encoding of ''string''</p>


For example, the following code


For example, the following code
<p class="code"> PRINT $Lstr_C2X('Red rum')
<p class="code"> PRINT $Lstr_C2X('Red rum')
</p>
</p>
would print <tt>D985844099A494</tt>, which is the hexadecimal representation of the EBCDIC characters "Red rum".  
would print <tt>D985844099A494</tt>, which is the hexadecimal representation of the EBCDIC characters "Red rum".  


$Lstr_X2C (:hdref refid=x2cl.) is the inverse of $Lstr_C2X.  
[[$Lstr_X2C]] is the inverse of $Lstr_C2X.  


This $function is new in Version 6.8 of the ''[[Sirius Mods]]''.<p>
This $function is new in Version 6.8 of the ''[[Sirius Mods]]''.<p>

Revision as of 21:27, 10 February 2011

<section begin="desc" />Convert byte string to hexadecimal<section end="desc" />

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).

This function converts a byte string into its hexadecimal encoding. It is identical to $C2X (see the "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

<section begin="syntax" /> %CODED = $Lstr_C2X(string) <section end="syntax" />

$Lstr_C2X Function

%CODED is set to the hexadecimal encoding of string

For example, the following code

PRINT $Lstr_C2X('Red rum')

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

$Lstr_X2C is the inverse of $Lstr_C2X.

This $function is new in Version 6.8 of the Sirius Mods.

Products authorizing $Lstr_C2X