next up previous
Next: CHR_BTOI - Read an INTEGER value from a binary string
Up: Routine Descriptions
Previous: CHR_ATOK - Return the character for a given ASCII character token

CHR_ATOM  -  Translate a string from ASCII to the machine's character set

Description:
The string STR1, which has been written on a machine which uses the ASCII character set and subsequently read on another machine is returned in STR2 translated into the correct character set for that machine.

Invocation:
CALL CHR_ATOM( STR1, STR2 )

Arguments:
STR1 = CHARACTER ( ) (Given)
The character string written on a machine with an ASCII character set and read on a machine which may not use ASCII.
STR2 = CHARACTER ( ) (Returned)
The character string translated into the machine's character set. If STR2 is shorter than STR1, the translated string will be truncated; if STR2 is longer than STR1, STR2 will be padded with blanks beyond the translated string.



next up previous
Next: CHR_BTOI - Read an INTEGER value from a binary string
Up: Routine Descriptions
Previous: CHR_ATOK - Return the character for a given ASCII character token



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