Ema_Object_Copy()
Abstract
Copies the specified object. The duplicate object that results has an identical structure to the original and contains identical values for each attribute (except those of type OBJECT_ID).
Syntax
Ema_Object_Copy (model_id, object_id)
| Argument | Type | Description |
|---|---|---|
model_id |
EmaT_Model_Id |
numeric model ID of the model-of-interest [This value is a numeric identifier that references a model. Use the functions Ema_Model_Create(), Ema_Model_Copy(), or Ema_Model_Read() to obtain a model ID.] |
object_id |
EmaT_Object_Id |
numeric object ID of the object to be copied [This value is a numeric identifier that references an object. An object ID can be obtained from the functions Ema_Object_Create(), Ema_Object_Copy(), Ema_Object_Move(), Ema_Object_Move_Recursively(), or Ema_Object_Nth().] |
Return Type
EmaT_Object_Id
numeric object ID of the new object
Header
ema.h
Details
This function implements the copy operator for objects.
Attributes of type OBJECT_ID will not be set to any value in the duplicate object. It is the caller's responsibility to set the values of these attributes and, if necessary, to copy the objects referred to by these attributes.