IS-X-LITERAL( ) Check X literal

Domain: String functions/test functions

The IS-X-LITERAL( ) function checks whether the specified string expression contains an X literal and can be converted with FROM-X-LITERAL( ).

Format

IS-X-LITERAL( )

IS-X-LIT( )

STRING = string_expression

Result type

BOOLEAN

Input parameters

STRING = string_expression
Designates the string expression to be checked.

Result

TRUE
“string_expression” contains an X literal.

FALSE
“string_expression” does not contain an X literal.

Error messages

No error messages

Example

/A = 'X''01FF'''
/B = X'01FF'
/C = IS-X-LITERAL(STRING = A)
/SHOW-VARIABLE C
C = TRUE
/C = IS-X-LITERAL(STRING = B)
/SHOW-VARIABLE C
C = FALSE 

In the first case (variable A), the string to be checked contains an X literal. In the second case (variable B), it does not, since the internal value of the variable is 01FF, which is not an X literal.