next up previous 264
Next: AST_FINDFITS - Find a FITS card in a FitsChan by keyword
Up: AST Routine Descriptions
Previous: AST_EXEMPT - Exempt an Object pointer from AST context handling


AST_EXPORT - Export an Object pointer to an outer context

Description:
This routine exports an Object pointer from the current AST context into the context that encloses the current one. This means that the pointer will no longer be annulled when the current context is ended (with AST_END), but only when the next outer context (if any) ends.
Invocation:
CALL AST_EXPORT( THIS, STATUS )
Arguments:
THIS = INTEGER (Given)
Object pointer to be exported.
STATUS = INTEGER (Given and Returned)
The global status.
Class Applicability:
Object
This routine applies to all Objects.
Notes:
  • It is only sensible to apply this routine to pointers that have been created within (or exported to) the current context and have not been rendered exempt using AST_EXEMPT. Applying it to an unsuitable Object pointer has no effect.


next up previous 264
Next: AST_FINDFITS - Find a FITS card in a FitsChan by keyword
Up: AST Routine Descriptions
Previous: AST_EXEMPT - Exempt an Object pointer from AST context handling

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