StringToHex (String function): Difference between revisions
Jump to navigation
Jump to search
m (→Syntax terms) |
m (printtext) |
||
| Line 15: | Line 15: | ||
==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. | <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. | ||
<var>StringToHex</var> is available as of <var class="product">[[Sirius Mods]]</var> | <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 | <ol><li>The following statement displays <code>D581A8A281A88599</code>: | ||
<p class="code">printText {'Naysayer':stringToHex} | <p class="code">[[PrintText statement|printText]] {'Naysayer':stringToHex} | ||
</p></ol> | </p></ol> | ||
==See also== | ==See also== | ||
<ul><li>The inverse of <var>StringToHex</var> is [[HexToString (String function)|HexToString]] | <ul><li>The inverse of <var>StringToHex</var> is [[HexToString (String function)|HexToString]].</ul> | ||
{{Template:String:StringToHex footer}} | {{Template:String:StringToHex footer}} | ||
Revision as of 09:26, 23 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
- The following statement displays
D581A8A281A88599:printText {'Naysayer':stringToHex}
See also
- The inverse of StringToHex is HexToString.