StringToHex (String function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (printtext)
 
(3 intermediate revisions by 3 users not shown)
Line 16: Line 16:
<ul><li>Hex (short for hexadecimal) encoding is usually used for debugging when there is a concern that non-displayable characters (including trailing blanks) might be present in a string. By hex encoding such a string, all non-displayable bytes are converted to displayable hexadecimal equivalents.
<ul><li>Hex (short for hexadecimal) encoding is usually used for debugging when there is a concern that non-displayable characters (including trailing blanks) might be present in a string. By hex encoding such a string, all non-displayable bytes are converted to displayable hexadecimal equivalents.
<li><var>StringToHex</var> always returns an even number of bytes.
<li><var>StringToHex</var> always returns an even number of bytes.
<li><var>StringToHex</var> is available as of <var class="product">[[Sirius Mods|"Sirius Mods"]]</var> Version 7.2.</ul>
<li><var>StringToHex</var> is available as of <var class="product">[[Sirius Mods|Sirius Mods]]</var> Version 7.2.</ul>


==Examples==
==Examples==
<ol><li>The following statement displays <code>D581A8A281A88599</code>:
The following statement displays <code>D581A8A281A88599</code>:
<p class="code">[[PrintText statement|printText]] {'Naysayer':stringToHex}
<p class="code">[[PrintText statement|printText]] {'Naysayer':stringToHex}
</p></ol>
</p>


==See also==
==See also==
<ul><li>The inverse of <var>StringToHex</var> is [[HexToString (String function)|HexToString]].</ul>
<ul>
<li>The inverse of <var>StringToHex</var> is <var>[[HexToString (String function)|HexToString]]</var>.
</ul>
 
{{Template:String:StringToHex footer}}
{{Template:String:StringToHex footer}}

Latest revision as of 21:16, 5 November 2012

Convert an Ebcdic string to hexadecimal (String class)


The StringToHex intrinsic function returns the hex encoded value of the method object string.

Syntax

%outString = string:StringToHex

Syntax terms

%outString A string variable to receive the hex encoded value of the method object string.
string The string to be hex encoded.

Usage notes

  • Hex (short for hexadecimal) encoding is usually used for debugging when there is a concern that non-displayable characters (including trailing blanks) might be present in a string. By hex encoding such a string, all non-displayable bytes are converted to displayable hexadecimal equivalents.
  • StringToHex always returns an even number of bytes.
  • StringToHex is available as of Sirius Mods Version 7.2.

Examples

The following statement displays D581A8A281A88599:

printText {'Naysayer':stringToHex}

See also