- ←Prev
- KAPLIBS – Internal subroutines used within the KAPPA package.
- Next→
- TOC ↑
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.
- ←Prev
- KAPLIBS – Internal subroutines used within the KAPPA package.
- Next→
- TOC ↑