NM and CM callable.
Operation Notes |
 |
Reads an ASCII string from $STDIN into
an array. This is similar to calling the FREAD intrinsic
against the file $STDIN. This intrinsic is limited;
full capability of the file system is not available. For
example, FILE commands are not allowed and some file intrinsics
cannot be used because the filenum parameter, obtained
from the FOPEN/HPFOPEN intrinsic, is not
normally available to users of the READ intrinsic.
Basic line editing, such as cancellation of lines and backspacing,
are performed automatically by the I/O driver. If the
input device is a terminal in full-duplex mode with the ECHO
facility on, or if the terminal is in half-duplex mode, the
characters read are printed.
READ interprets the following to be end-of-file (EOF) markers
when they begin in the fist column of a record:
For sessions, a colon (:).
For jobs, a colon (:) or the actual EOF.
When one of these indicators are encountered, CCG (0) is returned and no
transfer occurs.
If $STDIN is redirected, only the file's actual EOF is
interpreted as the valid EOF indicator.
