StringToHex (String function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (Full stop)
 
(5 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.
<li><var>StringToHex</var> always returns an even number of bytes.
<var>StringToHex</var> is available as of <var class="product">[[Sirius Mods]]</var> version 7.2.</ul>
<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 ''''D581A8A281A88599'''':
The following statement displays <code>D581A8A281A88599</code>:
<p class="code">printText {'Naysayer':stringToHex}
<p class="code">[[PrintText statement|printText]] {'Naysayer':stringToHex}
</p></ol>
</p>


==See also==
==See also==
<ul><li>The inverse of <var>StringToHex</var> is [[HexToString (String function)|HexToString]].
<ul>
<li>For details of the <var>printtext</var> statement, please see <var>[[Intrinsic classes#printtext|printText]]</var>.</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