StringToHex (String function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (1 revision)
Line 7: Line 7:
{{Template:String:StringToHex syntax}}
{{Template:String:StringToHex syntax}}
===Syntax terms===
===Syntax terms===
<dl>                                                                                                  
<table class="syntaxTable">
<dt>%outStr                                                                                             
<tr><th>%outStr                                                                                            </th>
<dd>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 string.                    </td></tr>
<dt>string                                                                                               
<tr><th>string                                                                                              </th>
<dd>The string to be hex encoded.                                                                      
<td>The string to be hex encoded.</td></tr>
                                                                                                       
</table>
</dl>                                                                                                  
                                                                                                 
==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.                                       
*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.                                       

Revision as of 05:39, 19 January 2011

Convert an Ebcdic string to hexadecimal (String class)


This intrinsic function returns the hex encoded value of the method object string.

StringToHex is available as of version 7.2 of the Sirius Mods.

Syntax

%outString = string:StringToHex

Syntax terms

%outStr 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.
  • The StringToHex function always returns an even number of bytes.
  • The inverse of StringToHex is HexToString.

Examples

The following statement displays 'D581A8A281A88599':

   printText {'Naysayer':stringToHex}

See also

List of intrinsic String methods