Next: AST_PUTLINE - Store a text line read by a Channel source routine
Up: AST Routine Descriptions
Previous: AST_PUTCOLUMNDATA - Retrieve all the data values stored in a column
AST_PUTFITS
-
Store a FITS header card in a FitsChan
- Description:
- This routine stores a FITS header card in a FitsChan. The card
is either inserted before the current card (identified by the
Card attribute), or over-writes the current card, as required.
- Invocation:
- CALL AST_PUTFITS( THIS, CARD, OVERWRITE, STATUS )
- Arguments:
-
THIS = INTEGER (Given)
-
Pointer to the FitsChan.
-
CARD = CHARACTER
( 80 ) (Given)
-
A character string string containing the FITS card to be
stored. No more than 80 characters will be used from this
string.
-
OVERWRITE = LOGICAL (Given)
-
If this value is .FALSE., the new card is inserted in front of
the current card in the FitsChan (as identified by the
initial value of the Card attribute). If it is .TRUE., the
new card replaces the current card. In either case, the Card
attribute is then incremented by one so that it subsequently
identifies the card following the one stored.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
- If the Card attribute initially points at the "end-of-file"
(i.e. exceeds the number of cards in the FitsChan), then the new
card is appended as the last card in the FitsChan.
- An error will result if the supplied string cannot be interpreted
as a FITS header card.
Next: AST_PUTLINE - Store a text line read by a Channel source routine
Up: AST Routine Descriptions
Previous: AST_PUTCOLUMNDATA - Retrieve all the data values stored in a column
AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 210
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk
Copyright (C) 2009 Science \& Technology Facilities Council