Ovis_Entity_Child_Entity_Count()
Abstract
Returns the number of child entities directly associated with an entity.
Syntax
Ovis_Entity_Child_Entity_Count (entity_ptr)
| Argument | Type | Description |
|---|---|---|
entity_ptr |
OvisT_Entity * |
Entity |
Return Type
unsigned int
Number of child entities.
Header
ovis_entity.h
Details
This function returns the number of child entities associated with the entity of interest. That entity must have an aggregation value of OvisC_Aggregation_Aggregate.
Example
OvisT_Entity * parent,* child;
unsigned in count, i;
/* …parent entity created elsewhere */
count = Ovis_Entity_Child_Entity_Count (parent);
for (i = 0; i < count; i++)
{
child = Ovis_Entity_Child_Entity_Nth (parent, i);
/* … do something with child entity */
}
Errors
- Entity is NIL.
Reference
- Use the function Ovis_Entity_Child_Entity_Nth() to retrieve the various child entities of an entity.