next up previous 264
Next: AST_PUTCOLUMNDATA - Retrieve all the data values stored in a column
Up: AST Routine Descriptions
Previous: AST_PURGEWCS - Delete all cards in the FitsChan describing WCS information


AST_PUTCARDS - Store a set of FITS header cards in a FitsChan

Description:
This routine stores a set of FITS header cards in a FitsChan. The cards are supplied concatenated together into a single character string. Any existing cards in the FitsChan are removed before the new cards are added. The FitsChan is "re-wound" on exit by clearing its Card attribute. This means that a subsequent invocation of AST_READ can be made immediately without the need to re-wind the FitsChan first.
Invocation:
CALL AST_PUTCARDS( THIS, CARDS, STATUS )
Arguments:
THIS = INTEGER (Given)
Pointer to the FitsChan.
CARDS = CHARACTER $*$ ( $*$ ) (Given)
A character string containing the FITS cards to be stored. Each individual card should occupy 80 characters in this string, and there should be no delimiters, new lines, etc, between adjacent cards. The final card may be less than 80 characters long.
STATUS = INTEGER (Given and Returned)
The global status.
Notes:
  • An error will result if the supplied string contains any cards which cannot be interpreted.


next up previous 264
Next: AST_PUTCOLUMNDATA - Retrieve all the data values stored in a column
Up: AST Routine Descriptions
Previous: AST_PURGEWCS - Delete all cards in the FitsChan describing WCS information

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