astEndastEnd
-
End an AST context
- Description:
- This macro invokes a function to end an AST context which was
begun with a matching invocation of astBeginastBegin. Any ObjectObject
pointers created within this context will be annulled (just as
if astAnnulastAnnul had been invoked) and will cease to be valid
afterwards, unless they have previously been exported using
astExportastExport or rendered exempt using astExemptastExempt.
If annulling a pointer causes an Object's RefCountRefCount 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.