StringToHex (String function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (Full stop)
Line 8: Line 8:
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%outString</th>
<tr><th>%outString</th>
<td>A string variable to receive the hex encoded value of the method object <var class="term>string</var>.</td></tr>
<td>A string variable to receive the hex encoded value of the method object <var class="term">string</var>.</td></tr>
<tr><th>string</th>
<tr><th>string</th>
<td>The string to be hex encoded.</td></tr>
<td>The string to be hex encoded.</td></tr>

Revision as of 16:11, 8 February 2011

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

  1. The following statement displays 'D581A8A281A88599':

    printText {'Naysayer':stringToHex}

See also

  • The inverse of StringToHex is HexToString.
  • For details of the printtext statement, please see printText.