DTW_HEXTOCHAR

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")


[ Top of Page | Previous Page | Next Page | Index ]