FTS1_PRVAL

Prints the value of a specified card in an array of FITS headers

Description:

This routine reports the value of a keyword in an array of FITS headers via the Messaging system. It also returns the value and comment assoiciated with the header. Hierarchical keywords are allowed. A bad status is returned if the desired keyword is not present in the header array, or the card index is out of bounds.

Invocation

CALL FTS1_PRVAL( NCARD, HEADER, KEYWRD, OCCUR, CARD, SVALUE, COMENT, 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 (Given)
The index number of card containing the desired keyword. Must be between 1 and NCARD.
SVALUE = CHARACTER ( ) (Returned)
The value. This should have length of at least 68 characters.
COMENT = CHARACTER ( ) (Returned)
The value. This should have length of at least 60 characters, although normally 47 characters suffice.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:

The comments and values are extracted from a single card.