Store a keyword value in a FitsChan
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.
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
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_SETFITS<X> 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.