Next: CAT_FGT0t - Get the value of a scalar expression or field for a given row
Up: Detailed subroutine specifications
Previous: CAT_EXIST - Attempt to open a catalogue, the name being taken from the ADAM parameter system
CAT_FGT0F
- Get the formatted value of a scalar expression or field for a given row
- Description:
- Get the formatted value of a scalar expression or field for a
given row. The row may be in either a catalogue, selection or
index.
- Invocation:
- CALL CAT_FGT0F (CI, ROWNO, GI; VALUE, NULFLG; STATUS)
- Arguments:
-
CI = INTEGER (Given)
-
Catalogue, selection or index identifier. The row number,
ROWNO (below), refers to the row number in the catalogue,
selection or index, as appropriate.
-
ROWNO = INTEGER (Given)
-
Number of the row to be read.
-
GI = INTEGER (Given)
-
Identifier for either an expression, field or parameter.
-
VALUE = CHARACTER
(
) (Returned)
-
Value to which the expression evaluates for the current row
buffer. If the expression evaluates to null the string
returned is '
null
' if VALUE contains six or more characters,
otherwise it is '?'.
-
NULFLG = LOGICAL (Returned)
-
A flag indicating whether or not the expression evaluates to
the null value or not:
.TRUE. - The expression is null,
.FALSE. - The expression is not null; a genuine value is
available.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
-
Copyright
- Copyright (C) 1999 Central Laboratory of the Research Councils
- Bugs:
- None known
Next: CAT_FGT0t - Get the value of a scalar expression or field for a given row
Up: Detailed subroutine specifications
Previous: CAT_EXIST - Attempt to open a catalogue, the name being taken from the ADAM parameter system
CAT [1ex
Starlink User Note 181
A.C. Davenhall
4th April 2001
E-mail:ussc@star.rl.ac.uk
Copyright © 2001 Council for the Central Laboratory of the Research Councils