next up previous
Next: astExport - Export an Object pointer to an outer context
Up: AST Function Descriptions
Previous: astEnd - End an AST context

   
astExempt - Exempt an Object pointer from AST context handling

Description:
This function exempts an Object pointer from AST context handling, as implemented by astBegin and astEnd. This means that the pointer will not be affected when astEnd is invoked and will remain active until the end of the program, or until explicitly annulled using astAnnul.

If possible, you should avoid using this function when writing applications. It is provided mainly for developers of other libraries, who may wish to retain references to AST Objects in internal data structures, and who therefore need to avoid the effects of astBegin and astEnd.

Synopsis:
void astExempt( AstObject *this )

Parameters:
this
Object pointer to be exempted from context handling.

Class Applicability:
Object
This function applies to all Objects.



next up previous
Next: astExport - Export an Object pointer to an outer context
Up: AST Function Descriptions
Previous: astEnd - End an AST context

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