StringToHex (String function)

From m204wiki
Revision as of 06:05, 2 February 2011 by Goff (talk | contribs) (match syntax diagram to revised template; fix tags.)
Jump to navigation Jump to search

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