StringToHex (String function): Difference between revisions
Jump to navigation
Jump to search
m (match syntax diagram to revised template; fix tags.) |
m (→See also) |
||
| (6 intermediate revisions by 4 users not shown) | |||
| 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> | ||
| 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== | ||
The following statement displays <code>D581A8A281A88599</code>: | |||
<p class="code">printText {'Naysayer':stringToHex} | <p class="code">[[PrintText statement|printText]] {'Naysayer':stringToHex} | ||
</p | </p> | ||
==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 <var>[[HexToString (String function)|HexToString]]</var>. | |||
</ul> | |||
{{Template:String:StringToHex footer}} | {{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.