Processing math: 100%

CHR_ATOK

Return the character for a given ASCII character token

Description:

The given ASCII character token is converted to a single returned character in the machine’s character set. All non-printable ASCII characters are represented by their equivalent token strings. If no such ASCII character exists, the character code 0 (the ASCII NUL character) is returned. The routine is intended for the portable initialisation of unprintable characters.

Invocation

RESULT = CHR_ATOK( TOKEN )

Arguments

TOKEN = CHARACTER ( ) (Given)
A printable character string representing the character to be returned, e.g., ’BEL’, ’BS’, etc.

Returned Value

CHR_ATOK = CHARACTER 1
The character code within the ASCII character set.