TO-X-LITERAL( ) Convert string to X literal

Domain: Conversion functions

The TO-X-LITERAL( ) function converts the hexadecimal value of the specified string into the external representation: it places single quotes at the beginning and end of the string and also places an X in front of the string.

The FROM-X-LITERAL( ) function is the inverse of the TO-X-LITERAL( ) function.

Format

TO-X-LITERAL( )

TO-X-LIT( )

STRING = string_expression

Result type

STRING

Input parameters

STRING = string_expression
Designates the string to be converted.

Result

X literal in the form of a string.

Error messages

No error messages

Example

/T = 'HELLO'
/B = TO-X-LITERAL(T)
/SHOW-VARIABLE B
B = X'C8C5D3D3D6'