SCULIB_READ_NUMBERS

routine to read numbers from an ASCII file

Description:

This routine reads a file of ASCII numbers. The name of the file is specified by FILENAME, and the routine assumes that the numbers are in NARRAY columns each containing SIZE numbers. The maximum value for NARRAY is 3. The read operation itself is free format. An error will be returned if there is trouble reading from the file. A warning will be given if there are more numbers in the file than can be read into the arrays.

Invocation

CALL SCULIB_READ_NUMBERS (FILENAME, NARRAY, SIZE, ARRAY1, ARRAY2, ARRAY3, LENGTH, STATUS)

Arguments

FILENAME = CHARACTER() (Given)
Name of file containing numbers
NARRAY = INTEGER (Given)
Number of columns in file ( <=3)
SIZE = INTEGER (Given)
Dimension of arrays
ARRAY1 (SIZE) = REAL (Returned)
Output array to contain first column of numbers
ARRAY2 (SIZE) = REAL (Returned)
Output array to contain second column of numbers (if present)
ARRAY3 (SIZE) = REAL (Returned)
Output array to contain third column of numbers (if present)
LENGTH = INTEGER (Returned)
Number of items read into output arrays
STATUS = INTEGER (Given and returned)
Global status

Copyright

Copyright ©1995,1996,1997,1998,1999 Particle Physics and Astronomy Research Council. All Rights Reserved.