AST_CLONE

Clone (duplicate) an Object pointer

Description:

This function returns a duplicate pointer to an existing Object. It also increments the Object s RefCount attribute to keep track of how many pointers have been issued.

Note that this function is NOT equivalent to an assignment statement, as in general the two pointers will not have the same value.

Invocation

RESULT = AST_CLONE( THIS, STATUS )

Arguments

THIS = INTEGER (Given)
Original pointer to the Object.
STATUS = INTEGER (Given and Returned)
The global status.

Applicability

Object
This function applies to all Objects.

Returned Value

AST_CLONE = INTEGER
A duplicate pointer to the same Object.

Notes: