Store a keyword value in a FitsChan astSetFitsX
The keyword data type is selected by replacing X in the function 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 "
(a pointer to a 2 element array holding the real and imaginary parts of the complex
value).
CI - " int "
(a pointer to a 2 element array holding the real and imaginary parts of the complex
value).
F - " double" .
I - " int" .
L - " int" .
S - " const char "
.
CN - " const char " .
" name" parameter is
used instead. If " name" contains no comment, then any existing comment in the card
being over-written is retained. Otherwise, no comment is stored with the card. " Card" attribute). If zero,
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 function astSetFitsU can be used to indicate that no value is associated with a keyword.
The function astSetFitsCM 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 astFindFits, and then use one of the astSetFitsX family to over-write the old value.
If, on exit, there are no cards following the card written by this function, 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.