next up previous 264
Next: AST_DELFITS - Delete the current FITS card in a FitsChan
Up: AST Routine Descriptions
Previous: AST_DECOMPOSE - Decompose a Mapping into two component Mappings


AST_DELETE - Delete an Object

Description:
This routine deletes an Object, freeing all resources associated with it and rendering any remaining pointers to the Object invalid.

Note that deletion is unconditional, regardless of whether other pointers to the Object are still in use (possibly within other Objects). A safer approach is to defer deletion, until all references to an Object have expired, by using AST_BEGIN/AST_END (together with AST_CLONE and AST_ANNUL if necessary).

Invocation:
CALL AST_DELETE( THIS, STATUS )
Arguments:
THIS = INTEGER (Given and Returned)
Pointer to the Object to be deleted. A null pointer value (AST__NULL) is always returned.
STATUS = INTEGER (Given and Returned)
The global status.
Class Applicability:
Object
This routine applies to all Objects.
Notes:
  • This routine attempts to execute even if STATUS is set to an error value on entry, although no further error report will be made if it subsequently fails under these circumstances.


next up previous 264
Next: AST_DELFITS - Delete the current FITS card in a FitsChan
Up: AST Routine Descriptions
Previous: AST_DECOMPOSE - Decompose a Mapping into two component Mappings

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