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.
Synopsis:
AstObject astClone( AstObject this )
Parameters:
this
Original pointer to the Object.
Class Applicability:
Object
This function applies to all Objects.
Returned Value:
astClone()
A duplicate pointer to the same Object.
Notes:
A null Object pointer (AST__NULL) will be returned if this
function is invoked with the AST error status set, or if it
should fail for any reason.
AST A Library for Handling World Coordinate Systems in Astronomy Starlink User Note 211 R.F. Warren-Smith & D.S. Berry 24th May 2011 E-mail:ussc@star.rl.ac.uk
Copyright (C) 2009 Science \& Technology Facilities Council