next up previous
Next: NDF_ACMSG - Assign the value of an NDF axis character component to a message token
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_ACGET - Obtain the value of an NDF axis character component

   
NDF_ACLEN - Determine the length of an NDF axis character component

Description:
The routine returns the length of the specified axis character component of an NDF (i.e. the number of characters in the LABEL or UNITS component of an NDF axis).

Invocation:
CALL NDF_ACLEN( INDF, COMP, IAXIS, LENGTH, STATUS )

Arguments:
INDF = INTEGER (Given)
NDF identifier.
COMP = CHARACTER * ( * ) (Given)
Name of the axis character component whose length is required: 'LABEL' or 'UNITS'.
IAXIS = INTEGER (Given)
Number of the NDF axis.
LENGTH = INTEGER (Returned)
The component's length in characters.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • The length of an NDF axis character component is normally determined by the length of the VALUE string assigned to it by a previous call to NDF_ACPUT (note that this could include trailing blanks).
  • If the requested axis component is in an undefined state, then the length returned will be the number of characters in the default value which would be returned by the NDF_ACGET routine.
  • A value of zero may be supplied for the IAXIS argument, in which case the routine will return the maximum component length for all the NDF axes.



next up previous
Next: NDF_ACMSG - Assign the value of an NDF axis character component to a message token
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_ACGET - Obtain the value of an NDF axis character component


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