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: 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
24th May 2011
E-mail:ussc@star.rl.ac.uk
Copyright (C) 2009 Science \& Technology Facilities Council