Ema_Object_Attr_Add()
Abstract
Adds a user-defined attribute to the specified object.
Syntax
Ema_Object_Attr_Add (model_id, object_id, attr_name, attr_properties)
| 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. A model ID can be obtained from several EMA functions.] |
object_id |
EmaT_Object_Id |
numeric object ID of the object-of-interest [This value is a numeric identifier that references an object. An object ID can be obtained from several EMA functions.] |
attr_name |
char* |
name of the new attribute |
attr_properties |
EmaT_Object_Id |
numeric object ID of the properties object for the attribute |
Return Type
void
No return value.
Header
ema.h
Details
This function implements the attr_add operator for objects. A user-defined attribute is an attribute defined by the user for model-specific purposes.
EMA permits object attributes to be added to any object type. Attempts to add an attribute with a name that is identical to an existing attribute will fail, causing an error.