Next: NDF_ANORM - Obtain the logical value of an NDF axis normalisation flag
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_AMAP - Obtain mapped access to an NDF axis array
- Description:
The routine annuls the NDF identifier supplied so that it is no
longer recognised as a valid identifier by the NDF_ routines.
Any resources associated with it are released and made available
for re-use. If any NDF components are mapped for access, then
they are automatically unmapped by this routine.
- Invocation:
CALL NDF_ANNUL( INDF, STATUS )
- Arguments:
-
INDF = INTEGER (Given and Returned)
-
The NDF identifier to be annulled. A value of NDF__NOID is
returned (as defined in the include file NDF_PAR).
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
-
This routine attempts to execute even if STATUS is set on
entry, although no further error report will be made if it
subsequently fails under these circumstances. In particular, it
will fail if the identifier supplied is not initially valid, but
this will only be reported if STATUS is set to SAI__OK on entry.
-
An error will result if an attempt is made to annul the last
remaining identifier associated with an NDF whose DATA component
has not been defined (unless it is a temporary NDF, in which case
it will be deleted at this point).
Next: NDF_ANORM - Obtain the logical value of an NDF axis normalisation flag
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_AMAP - Obtain mapped access to an NDF axis array
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