next up previous
Next: AST_DISTANCE - Calculate the distance between two points in a Frame
Up: AST Routine Descriptions
Previous: AST_DELETE - Delete an Object

   
AST_DELFITS - Delete the current FITS card in a FitsChan

Description:
This routine deletes the current FITS card from a FitsChan. The current card may be selected using the Card attribute (if its index is known) or by using AST_FINDFITS (if only the FITS keyword is known).

After deletion, the following card becomes the current card.

Invocation:
CALL AST_DELFITS( THIS, STATUS )

Arguments:
THIS = INTEGER (Given)
Pointer to the FitsChan.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • This function returns without action if the FitsChan is initially positioned at the "end-of-file" (i.e. if the Card attribute exceeds the number of cards in the FitsChan).
  • If there are no subsequent cards in the FitsChan, then the Card attribute is left pointing at the "end-of-file" after deletion (i.e. is set to one more than the number of cards in the FitsChan).



next up previous
Next: AST_DISTANCE - Calculate the distance between two points in a Frame
Up: AST Routine Descriptions
Previous: AST_DELETE - Delete an Object

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

Copyright (C) 2003 Central Laboratory of the Research Councils