AST_COPY

Copy an Object

Description:

This function creates a copy of an Object and returns a pointer to the resulting new Object. It makes a " deep" copy, which contains no references to any other Object (i.e. if the original Object contains references to other Objects, then the actual data are copied, not simply the references). This means that modifications may safely be made to the copy without indirectly affecting any other Object.

Invocation

RESULT = AST_COPY( THIS, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the Object to be copied.
STATUS = INTEGER (Given and Returned)
The global status.

Applicability

Object
This function applies to all Objects.

Returned Value

AST_COPY = INTEGER
Pointer to the new Object.

Notes: