next up previous 225
Next: CAT_EGT0t - Get the value of a scalar expression, field or parameter
Up: Detailed subroutine specifications
Previous: CAT_CREAT - Create a new catalogue; the name of the catalogue is obtained from an ADAM parameter


CAT_EGT0F - Get the formatted value of a scalar exprn. field or parameter

Description:
Get the formatted value of a scalar expression, evaluated from the current row buffer, field or parameter. The value is formatted into a CHARACTER string using the appropriate external format specifier.

Remember that parameter and column identifiers correspond to valid expressions.

Invocation:
CALL CAT_EGT0F (GI; VALUE, NULFLG; STATUS)
Arguments:
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_EGT0t - Get the value of a scalar expression, field or parameter
Up: Detailed subroutine specifications
Previous: CAT_CREAT - Create a new catalogue; the name of the catalogue is obtained from an ADAM parameter

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