IBM Books

Reference

DTW_CHARTOHEX


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT




X X


Purpose

Converts each character in a string to two hexadecimal characters.

Format

@DTW_CHARTOHEX(stringIn, stringOut)

@DTW_rCHARTOHEX(stringIn)

Parameters

Table 74. DTW_CHARTOHEX 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 hexadecimal format.

Return Codes

Table 75. DTW_CHARTOHEX Return Codes

Return Code Explanation
-1001 The server could not process a Net.Data request to allocate memory.
1003 The number of parameters passed on a function call either exceeded the maximum number allowed, or was less than the minimum number required by the function.
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.

Usage Notes

Each hexadecimal character represents 4-bits of the input character (a character is represented by 8 bits).

Examples

Example 1: EBCDIC operating systems

@DTW_rCHARTOHEX("12345")

Example 2: ASCII operating systems

@DTW_rCHARTOHEX("12345")


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