KPG1_FFRx

Reads free-format floating-point data from a string

Description:

A buffer containing free-format values separated by spaces or commas is decoded and the numerical values extracted. It packages up the equivalent SLALIB calls (SLA_FLOTIN and SLA_DFLTIN) in order to obtain an array of values with a single line of code, and provides standard error handling. See SUN/67 for more details of the parsing technique and limitations.

If the desired number of values cannot be decoded from the string an error status SAI__ERROR is set.

Invocation

CALL KPG1_FFRx( STRING, NVAL, ORIGIN, VALUES, STATUS )

Arguments

STRING = CHARACTER ∗ ( ∗ ) (Given)
The string containing the values to be decoded and extracted.
NVAL = INTEGER (Given)
The number of values to extract from the string.
ORIGIN = INTEGER (Given and Returned)
On input this is the column or pointer in the string from where the decoding commences. On output it is advanced to the next number or the end of the buffer if there are no more numbers.
VALUES( NVAL ) = ? (Returned)
The decoded values. These are initialised to zero before decoiding commences.
STATUS = INTEGER (Given and Returned)
The global status.

Notes: