StringToHex (String function): Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
m (→See also) |
||
| (21 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
{{Template:String:StringToHex subtitle}} | {{Template:String:StringToHex subtitle}} | ||
The <var>StringToHex</var> [[Intrinsic classes|intrinsic]] function returns the hex encoded value of the method object string. | |||
==Syntax== | ==Syntax== | ||
{{Template:String:StringToHex syntax}} | {{Template:String:StringToHex syntax}} | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>% | <tr><th>%outString</th> | ||
<td>A string variable to receive the hex encoded value of the method object string. | <td>A string variable to receive the hex encoded value of the method object <var class="term">string</var>.</td></tr> | ||
<tr><th>string | <tr><th>string</th> | ||
<td>The string to be hex encoded.</td></tr> | <td>The string to be hex encoded.</td></tr> | ||
</table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
<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> is available as of <var class="product">[[Sirius Mods|Sirius Mods]]</var> Version 7.2.</ul> | |||
==Examples== | ==Examples== | ||
The following statement displays <code>D581A8A281A88599</code>: | |||
The following statement displays | <p class="code">[[PrintText statement|printText]] {'Naysayer':stringToHex} | ||
</p> | |||
==See also== | ==See also== | ||
[[ | <ul> | ||
<li>The inverse of <var>StringToHex</var> is <var>[[HexToString (String function)|HexToString]]</var>. | |||
</ul> | |||
{{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
- The inverse of StringToHex is HexToString.