StringToHex (String function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
 
(14 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Template:String:StringToHex subtitle}}
{{Template:String:StringToHex subtitle}}


This [[Intrinsic classes|intrinsic]] function returns the hex encoded value of the method object string.
The <var>StringToHex</var> [[Intrinsic classes|intrinsic]] function returns the hex encoded value of the method object string.


<var>StringToHex</var> is available as of version 7.2 of the <var class=product>Sirius Mods</var>.
==Syntax==
==Syntax==
{{Template:String:StringToHex syntax}}
{{Template:String:StringToHex syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%outStr</th>
<tr><th>%outString</th>
<td>A string variable to receive the hex encoded value of the method object string.                     </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 14:


==Usage notes==
==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.
<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.
*The <var>StringToHex</var> function always returns an even number of bytes.
<li><var>StringToHex</var> always returns an even number of bytes.
*The inverse of <var>StringToHex</var> is [[HexToString (String function)|HexToString]].
<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 ''''D581A8A281A88599'''':
<p class="code">[[PrintText statement|printText]] {'Naysayer':stringToHex}
    [[Intrinsic classes#printtext|printText]] {'Naysayer':stringToHex}
</p>


==See also==
==See also==
[[List of intrinsic String methods]]
<ul>
<li>The inverse of <var>StringToHex</var> is <var>[[HexToString (String function)|HexToString]]</var>.
</ul>


[[Category:String methods|StringToHex function]]
{{Template:String:StringToHex footer}}
[[Category:Intrinsic methods]]

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