ATL_PTFTS

Store a keyword value in a FitsChan, replacing any existing value

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: