AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X | X | X | X | X | X | X | X |
Purpose
Converts each hexadecimal character in a string to a character value.
Format
@DTW_HEXTOCHAR(stringIn, stringOut)
@DTW_rHEXTOCHAR(stringIn)
Parameters
Table 82. DTW_HEXTOCHAR Parameters
Data Type | Parameter | Use | Description |
---|---|---|---|
string | stringIn | IN | A variable or literal string that is to be converted. |
string | stringOut | OUT | A variable that contains stringIn represented in character format. |
Return Codes
Table 83. DTW_HEXTOCHAR Return Codes
Return Code | Explanation |
---|---|
-1001 | The server could not process a Net.Data request to allocate memory. |
1003 | An incorrect number of parameters were passed on a function call. |
1005 | A parameter passed on a function call, required to be a string variable, was of a different variable type. |
1006 | A literal string was passed on a function call for a parameter which was required to be an output parameter. |
1007 | A parameter contains a value which is not valid. |
Usage Notes
Each hexadecimal character in the input string represents 4 bits in the resultant character string (a character is represented by 8 bits). The input string must contain an even number of hexadecimal characters and can contain the following characters: 0-9, A-F, and a-f.
Examples
Example 1: EBCDIC operating systems
@DTW_rHEXTOCHAR("F1F2F3")
Example 2: ASCII operating systems
@DTW_rHEXTOCHAR("313233")