next up previous
Next: NDF_CHUNK - Obtain an NDF section containing a chunk of contiguous pixels
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_BOUND - Enquire the pixel-index bounds of an NDF

   
NDF_CGET - Obtain the value of an NDF character component

Description:
The routine obtains the value of the specified character component of an NDF (i.e. the value of the LABEL, TITLE or UNITS component).

Invocation:
CALL NDF_CGET( INDF, COMP, VALUE, STATUS )

Arguments:
INDF = INTEGER (Given)
NDF identifier.
COMP = CHARACTER * ( * ) (Given)
Name of the character component whose value is required: 'LABEL', 'TITLE' or 'UNITS'.
VALUE = CHARACTER * ( * ) (Given and Returned)
The component's value.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • If the requested component is in an undefined state, then the VALUE argument will be returned unchanged. A suitable default should therefore be established before calling this routine.
  • If the length of the VALUE argument is too short to accommodate the returned result without losing significant (non-blank) trailing characters, then this will be indicated by an appended ellipsis, i.e. '...'. No error will result.



next up previous
Next: NDF_CHUNK - Obtain an NDF section containing a chunk of contiguous pixels
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_BOUND - Enquire the pixel-index bounds of an NDF


Starlink User Note 33
R.F. Warren-Smith
11th January 2000
E-mail:rfws@star.rl.ac.uk

Copyright © 2000 Council for the Central Laboratory of the Research Councils