FTS1_LOKEY

Locates an occurrence of a keyword in a FITS header

Description:

This routines find the location of a certain occurrence of a named keyword in an array of FITS headers. Hierarchical keywords are allowed. A bad status is returned if the desired keyword is not present in the header array.

Invocation

CALL FTS1_LOKEY( NCARD, HEADER, KEYWRD, OCCUR, CARD, STATUS )

Arguments

NCARD = INTEGER (Given)
The number of cards in the FITS header array.
HEADER( NCARD ) = CHARACTER ∗ ( 80 ) (Given)
The array of FITS headers.
KEYWRD = CHARACTER ∗ ( ∗ ) (Given)
The keyword to search for in the array. This may be a compound name to handle hierarchical keywords, and it has the form keyword1.keyword2.keyword3 etc. The maximum number of keywords per FITS card is 20. Comparisons are performed in uppercase and blanks are removed. Each keyword must be no longer than 8 characters.
OCCUR = INTEGER (Given)
The occurrence of the keyword to locate. Values less than 1 obtain the first occurrence.
CARD = INTEGER (Returned)
The number of card containing the desired keyword.
STATUS = INTEGER (Given and Returned)
The global status.