next up previous contents index
Next: RO_RELEASEOBJ(lbl) Up: Functions on Objects Previous: CO_CREATEOBJ(lbl)

CPO_COPYOBJ(obj,src)

     

[DESTRUCTIVE]

Copies the contents of `src' to be a new transient version of `obj'. This function sets the `obj' label to refer to the new version of `obj', while the `src' label is left unaffected. Note that `src' and `obj' may refer to the same object. The effect is always that the `src' version becomes a new version for `obj'.

If `src' is transient, then it is automatically stored prior to copying. If `obj' is transient, then it also is stored prior to copying.  

To create a new object as a copy of an existing, the new object must be created first through a call to CO_CREATEOBJ(). Thereafter the source version can be copied ``into'' the new object.  

Function returns:



Martin Sjolin
Thu Jun 15 20:41:59 MET DST 1995