The CHAR-NATIONAL Function

The CHAR-NATIONAL (national character) function returns a one-character value that is a character in the national program collating sequence having the ordinal position equal to the value of the argument.

Restriction: This function is supported for native COBOL only.

The type of the function is national.

General Format

Arguments

Argument-1 must be an integer.
The value of argument-1 must be greater than zero and less than or equal to the number of positions in the national program collating sequence.

Returned Values

The returned value is the character in the national program collating sequence having the ordinal position specifed by argument-1.
If more than one character has the same ordinal positon in the current national program collating sequence, the returned value is the first character defined for that position.