READ/SCALARS Command
| Syntax: |
READ\SCALARS file{\n} s1{\c1} { s2{\c2} ... } |
| Qualifiers: | \ERRFILL, |
| Defaults: | \-ERRFILL |
By default, the first record is read from an ASCII file, and, if no errors
are encountered on the read, the Ith number is placed into
scalar sI. New scalar variables are created. By default, no scalars will be made if an
invalid field is encountered on the read.
A scalar appended to the file name, file\n,
specifies the starting record. The first n-1 records will be skipped.
By default, the Ith number field is placed into scalar
sI. The field number can be specified by appending a scalar, cI,
to the scalar name as a qualifier. In this case, the
cIth field can be placed into the
sIth scalar. For example, after the command:
READ\SCALARS DUM.DAT W\2 X\4 Y Z\1W would contain field 2,
X would contain field 4,
Y would default to field 3, and
Z would contain field 1.
If the \ERRFILL qualifier is used, an invalid
field causes that field to be set to ERRORFILL.
By default, ERRORFILL=0, but it's value can
be controlled with the ERRORFILL
characteristic.
Examples
Suppose you have file DUM.DAT as below:
1 23.7 0.1000E-5 2 -31.4 0.2000E-3 3 9.09 0.3000E-1
READ\SCALARS DUM.DAT A B
results in: A = 1, B = 23.7
READ\SCALARS DUM.DAT A/3 B
results in: A = .000001, B = 23.7
READ\SCALARS DUM.DAT\3 A B
results in: A = 3, B = 9.09
READ\SCALARS DUM.DAT\2 A/3 B
results in: A = .0002, B = -31.4