next up previous 225
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 up previous 225
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