Store a keyword value in a FitsChan AST_SETFITSX
The keyword data type is selected by replacing X in the routine name by one of the following strings representing the recognised FITS data
types:
CF - Complex floating point values.
CI - Complex integer values.
F - Floating point values.
I - Integer values.
K - 64 bit integer values.
L - Logical (i.e. boolean) values.
S - String values.
CN - A " CONTINUE" value, these are treated like string values, but are encoded without an equals
sign.
The data type of the " value" parameter depends on
X
as follows:
CF - DOUBLE PRECISION(2) (a 2 element array holding the real and imaginary parts of the complex value).
CI - INTEGER(2) (a 2 element array holding the real and imaginary parts of the complex value).
F - DOUBLE PRECISION.
I - INTEGER
K - INTEGER8
L - LOGICAL
S - CHARACTER
CN - CHARACTER
"Card" attribute). If
.FALSE., the new card is inserted in front of the current card and the current card is left unchanged. In
either case, if the current card on entry points to the " end-of-file" , the new card is appended to the
end of the list. The routine AST_SETFITSU can be used to indicate that no value is associated with a keyword.
The routine AST_SETFITSCM can be used to store a pure comment card (i.e. a card with a blank keyword).
To assign a new value for an existing keyword within a FitsChan, first find the card describing the keyword using AST_FINDFITS, and then use one of the AST_SETFITSX family to over-write the old value.
If, on exit, there are no cards following the card written by this routine, then the current card is left
pointing at the " end-of-file" .
An error will be reported if the keyword name does not conform to FITS requirements.