next up previous 264
Next: astEscapes - Control whether graphical escape sequences are included in strings
Up: AST Function Descriptions
Previous: astEmptyFits - Delete all cards in a FitsChan


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 264
Next: astEscapes - Control whether graphical escape sequences are included in strings
Up: AST Function Descriptions
Previous: astEmptyFits - Delete all cards in a FitsChan

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 211
R.F. Warren-Smith & D.S. Berry
7th December 2012
E-mail:starlink@jiscmail.ac.uk

Copyright (C) 2012 Science \& Technology Facilities Council