FTS1_WKEYC

Writes a FITS-header card for a CHARACTER value or a comment

Description:

This routine writes a FITS-header card using the supplied keyword, value, comment, and comment delimiter. The card is either a character string value, or a comment card. The latter occurs when the keyword is blank, HISTORY or COMMENT, or the COMCAR argument is .TRUE.; in this case both the supplied value and comment delimiter are ignored. The name may be compound to permit writing of hierarchical keywords.

Invocation

CALL FTS1_WKEYC( NAME, VALUE, CMTBGN, COMNT, COMCAR, HEADER, STATUS )

Arguments

NAME = CHARACTER ∗ ( ∗ ) (Given)
The name of the keyword to be written. 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. The value is converted to uppercase and blanks are removed before being used. Each keyword must be no longer than 8 characters. The total length must not exceed 48 characters. This is to allow for the value, and indentation into a blank-keyword card (as hierarchical keywords are not standard and so cannot be part of the standard keyword name).
VALUE = CHARACTER ∗ ( ∗ ) (Given)
The value of the keyword. It is ignored when the keyword is COMMENT, HISTORY, or blank, or COMCAR = .TRUE..
CMTBGN = CHARACTER ∗ ( 1 ) (Given)
The character which indicates the beginning of the comment string of to be appended to the keyword. Normally it is ’ /’ . when it is blank, no comment will be appended to the keyword. It is ignored when the keyword is COMMENT, HISTORY, or blank, or COMCAR = .TRUE..
COMNT = CHARACTER ∗ ( ∗ ) (Returned)
The comment string of the keyword. It may be truncated at the end to put into the space left after writing keyword value for non-commentary keywords.
COMCAR = LOGICAL (Given)
If .TRUE., the supplied card is a comment and thus the value and comment delimiter are ignored, and just the keyword and comment string are used to generate the header card.
HEADER = CHARACTER ∗ ( 80 ) (Returned)
The created FITS-header card.
STATUS = INTEGER (Given and Returned)
The global status.