next up previous
Next: CHR_ATOM - Translate a string from ASCII to the machine's character set
Up: Routine Descriptions
Previous: CHR_APPND - Copy one string into anotherignoring trailing blanks

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.



next up previous
Next: CHR_ATOM - Translate a string from ASCII to the machine's character set
Up: Routine Descriptions
Previous: CHR_APPND - Copy one string into anotherignoring trailing blanks



CHR Character Handling Routines
Starlink User Note 40
A C Charles
P C T Rees
A J Chipperfield
2 August 1995
E-mail:ussc@star.rl.ac.uk