Description:
This
routine stores a value for a FITS keyword in a FitsChan. If the keyword already has a value in the
FitsChan, the existing value is replaced with the new value. Otherwise, the new keyword is
added to the end of the FitsChan. On exit, the current Card in the FitsChan is the card
following the new keyword value (or end-of-file if the new card is the last one in the FitsChan).
Invocation
CALL ATL_PTFTS( THIS, NAME, VALUE, COMMNT, STATUS )
Arguments
THIS = INTEGER (Given)
Pointer to the FitsChan to use.
NAME = CHARACTER
(
) (Given)
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.
VALUE = CHARACTER
(
) (Given)
The new keyword value. If this is ATL__BADC, then an undefined value will be stored in the FitsChan.
Note, the ATL__BADC string is defined in include file ATL_PAR, together with the integer constant
ATL_SZBADC, which is equal to the length of the ATL__BADC string.
COMMNT = CHARACTER
(
)
(Given)
A new comment for the keyword. If this is blank, any comment in the NAME string is used.
If the NAME string contains no comment, any existing comment for the keyword in the FitsChan
is retained.
STATUS = INTEGER (Given and Returned)
The global status.
Notes: