next up previous 264
Next: astPutTable - Store a single FitsTable in a FitsChan
Up: AST Function Descriptions
Previous: astPutColumnData - Retrieve all the data values stored in a column


astPutFits - Store a FITS header card in a FitsChan

Description:
This function 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.
Synopsis:
void astPutFits( AstFitsChan $*$this, const char card[ 80 ], int overwrite )
Parameters:
this
Pointer to the FitsChan.
card
Pointer to a possibly null-terminated character string containing the FITS card to be stored. No more than 80 characters will be used from this string (or fewer if a null occurs earlier).
overwrite
If this value is zero, 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 non-zero, 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.
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 up previous 264
Next: astPutTable - Store a single FitsTable in a FitsChan
Up: AST Function Descriptions
Previous: astPutColumnData - Retrieve all the data values stored in a column

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 211
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk

Copyright (C) 2009 Science \& Technology Facilities Council