IRQ_NXTQN

Return the next quality name

Description:

This routine returns the next quality name defined in the NDF specified by LOCS, together with supplementary information. The next quality name is determined by the value of CONTXT. If CONTXT is zero on entry then the first quality name is returned. On exit, CONTXT is set to a value which indicates where the next quality name is stored within the NDF. This value can be passed to a subsequent call to this routine to retrieve information about the next quality name.

Invocation

CALL IRQ_NXTQN( LOCS, CONTXT, QNAME, FIXED, VALUE, BIT, COMMNT, DONE, STATUS )

Arguments

LOCS(5) = CHARACTER ∗ ( ∗ ) (Given)
An array of 5 HDS locators. These locators identify the NDF and the associated quality name information. They should have been obtained using routine IRQ_FIND or routine IRQ_NEW.
CONTXT = INTEGER (Given and Returned)
The context of the current call. This should be set to zero before the first call to this routine, and then left unchanged between subsequent calls.
QNAME = CHARACTER ∗ ( ∗ ) (Returned)
The next quality name. The character variable supplied for this argument should have a declared length equal to the symbolic constant IRQ__SZQNM.
FIXED = LOGICAL (Returned)
If true, then the quality is either held by all pixels, or by no pixels. In this case the quality may not have a corresponding bit in the QUALITY component. If false, then some pixels have the quality and some do not, as indicated by the corresponding bit in the QUALITY component.
VALUE = LOGICAL (Returned)
If FIXED is true, then VALUE specifies whether all pixels hold the quality (VALUE = .TRUE.), or whether no pixels hold the quality (VALUE = .FALSE.). If FIXED is false, then VALUE is indeterminate.
BIT = INTEGER (Returned)
BIT holds the corresponding bit number in the QUALITY component. The least-significant bit is called Bit 1 (not Bit 0). A value of zero is returned if the quality has no associated bit in the quality array. In this case, the FIXED argument will indicate if all pixels do, or do not, hold the quality.
COMMNT = CHARACTER ∗ ( ∗ ) (Returned)
The descriptive comment which was stored with the quality name. The supplied character variable should have a declared length given by symbolic constant IRQ__SZCOM.
DONE = LOGICAL (Returned)
Returned true if this routine is called when no more names remain to be returned.
STATUS = INTEGER (Given and Returned)
The global status.
Copyright © 2009 Science and Technology Facilities Council.