$Lstr C2X: Difference between revisions

Revision as of 20:54, 18 July 2013

Convert byte string to hexadecimal

Note: 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

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

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

@@ Line 2: / Line 2: @@
 <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 <var>[[StringToHex (String function)|StringToHex]]</var> function.</p>
+<p class="warn"><b>Note: </b>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.