Ovis_Group_Child_Entity_Count()
Abstract
Returns the number of entities associated with a group.
Syntax
Ovis_Group_Child_Entity_Count (group_ptr)
| Argument | Type | Description |
|---|---|---|
group_ptr |
OvisT_Group * |
Group of interest |
Return Type
unsigned int
Number of entities
Header
ovis_entity.h
Details
This function returns the number of entities associated with the specified group.
Example
OvisT_Group * group_ptr;
unsigned int count, i;
OvisT_Entity * ent_ptr;
/* …group created elsewhere */
count = Ovis_Group_Child_Entity_Count (group_ptr);
for (i = 0; i < count; i++)
{
ent_ptr = Ovis_Group_Child_Entity_Nth (group_ptr, i);
/* … do something with entity */
}
Errors
- Group is NIL.
Reference
- Use the function Ovis_Entity_Parent_Group_Count() to get the number of groups to which an entity belongs.
- Use the function Ovis_Group_Child_Entity_Nth() to retrieve the various child entities of a group.