next up previous 264
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 up previous 264
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