next up previous
Next: astExempt - Exempt an Object pointer from AST context handling
Up: AST Function Descriptions
Previous: astDistance - Calculate the distance between two points in a Frame

astEnd - End an AST context   

Description:
This macro invokes a function to end an AST context which was begun with a matching invocation of astBegin. Any Object pointers created within this context will be annulled (just as if astAnnul had been invoked) and will cease to be valid afterwards, unless they have previously been exported using astExport or rendered exempt using astExempt. If annulling a pointer causes an Object's RefCount attribute to fall to zero (which happens when the last pointer to it is annulled), then the Object will be deleted.

Synopsis:
void astEnd

Class Applicability:
Object
This macro applies to all Objects.

Notes:
  • astEnd attempts to execute even if the AST error status is set.
  • Contexts delimited by astBegin and astEnd may be nested to any depth.



next up previous
Next: astExempt - Exempt an Object pointer from AST context handling
Up: AST Function Descriptions
Previous: astDistance - Calculate the distance between two points in a Frame

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 211
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