HexToString (String function): Difference between revisions
Jump to navigation
Jump to search
m (Full stop) |
m (printtext) |
||
| Line 28: | Line 28: | ||
<li><var>HexToString</var> requires a method object string with an even number of bytes. | <li><var>HexToString</var> requires a method object string with an even number of bytes. | ||
<li><var>HexToString</var> displays a question mark (<code>?</code>) in cases where a converted hex value has no displayable character representation. | <li><var>HexToString</var> displays a question mark (<code>?</code>) in cases where a converted hex value has no displayable character representation. | ||
<li><var>HexToString</var> is available as of <var class="product">Sirius Mods</var> version 7.2.</ul> | <li><var>HexToString</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>Saint Marie</code>: | <ol><li>The following statement displays <code>Saint Marie</code>: | ||
<p class="code">printText {'E2818995A340D481998985':hexToString} | <p class="code">[[PrintText statement|printText]] {'E2818995A340D481998985':hexToString} | ||
</p> | </p> | ||
<li>The following statement displays <code>??</code>' because no displayable characters exist for the specified hex values: | <li>The following statement displays <code>??</code>' because no displayable characters exist for the specified hex values: | ||
| Line 41: | Line 41: | ||
==See also== | ==See also== | ||
<ul><li>[[X (String function)|X]] is a compile-time only equivalent of the <var>HexToString</var> method. | <ul><li>[[X (String function)|X]] is a compile-time only equivalent of the <var>HexToString</var> method. | ||
<li>The inverse of <var>HexToString</var> is <var>[[StringToHex (String function)|StringToHex | <li>The inverse of <var>HexToString</var> is <var>[[StringToHex (String function)|StringToHex]]</var>.</ul> | ||
{{Template:String:HexToString footer}} | {{Template:String:HexToString footer}} | ||
Revision as of 11:38, 22 February 2011
Convert a hexadecimal string to Ebcdic (String class)
HexToString is an intrinsic function that returns the unencoded value of a hex encoded string.
Syntax
%outString = string:HexToString Throws InvalidHexData
Syntax terms
| %outString | A string variable to receive the unencoded value of the method object string. |
|---|---|
| string | A hex-encoded string value. |
Exceptions
This intrinsic function can throw the following exceptions:
- InvalidHexData
- If the method object string does not contain a properly encoded hexadecimal value. The exception object indicates the position of the first invalid character in the method object string, or it indicates a zero if the method object string had an odd number of characters.
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.
- HexToString requires a method object string with an even number of bytes.
- HexToString displays a question mark (
?) in cases where a converted hex value has no displayable character representation. - HexToString is available as of "Sirius Mods" version 7.2.
Examples
- The following statement displays
Saint Marie:printText {'E2818995A340D481998985':hexToString}
- The following statement displays
??' because no displayable characters exist for the specified hex values:printText {'FFFE':hexToString(signed=true)}
See also
- X is a compile-time only equivalent of the HexToString method.
- The inverse of HexToString is StringToHex.