AST_TESTFITS

See if a named keyword has a defined value in a FitsChan

Description:

This function serches for a named keyword in a FitsChan. If found, and if the keyword has a value associated with it, a .TRUE. value is returned. If the keyword is not found, or if it does not have an associated value, a .FALSE. value is returned.

Invocation

RESULT = AST_TESTFITS( THIS, NAME, THERE, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the FitsChan.
NAME = CHARACTER ( ) (Given)
A character string containing the FITS keyword name. This may be a complete FITS header card, in which case the keyword to use is extracted from it. No more than 80 characters are read from this string. If a single dot . is supplied, the current card is tested.
THERE = LOGICAL (Returned)
A value of .TRUE. will be returned if the keyword was found in the header, and .FALSE. otherwise. This parameter allows a distinction to be made between the case where a keyword is not present, and the case where a keyword is present but has no associated value.
STATUS = INTEGER (Given and Returned)
The global status.

Returned Value

AST_TESTFITS = LOGICAL
A value of zero .FALSE. is returned if the keyword was not found in the FitsChan or has no associated value. Otherwise, a value of .TRUE. is returned.

Notes: