Category: Objects
/ Search
Since engine version: 1.0 OC
ObjectCount
Description
Returns the number of objects fulfilling the specified search criteria. Search criteria are composed of Find_x() function values.
Syntax
int ObjectCount(array Criteria, ...);
Parameters
- Criteria:
- Search criterion in the form of a Find_* function
- ...:
- [opt] Additional search criteria in the form of Find_* functions
Remarks
Search criteria are specified as in FindObjects and FindObject. See FindObjects for additional samples.
When this function is called in object context, only objects in the same layer as the calling object are considered, i.e. an implicit check Find_Layer(GetObjectLayer()) is added. To turn off this check, either supply a manual criterion with Find_Layer() to check for another layer, or allow objects in any layer to be returned by passing Find_AnyLayer().
Example
Log( "Still %d hostile clonks!", ObjectCount(Find_OCF(OCF_CrewMember), Find_Hostile(GetOwner()) );
Prints info about the strength of the enemy.
See also: FindObject, FindObjects, Find_Action, Find_ActionTarget, Find_ActionTarget2, Find_ActionTargets, Find_Allied, Find_And, Find_AnyContainer, Find_AnyLayer, Find_AtPoint, Find_Category, Find_Cone, Find_Container, Find_Distance, Find_Exclude, Find_Func, Find_Hostile, Find_ID, Find_InArray, Find_InRect, Find_Layer, Find_NoContainer, Find_Not, Find_OCF, Find_OnLine, Find_OnLine, Find_Or, Find_Owner, Find_Property, Find_Team, ObjectCount, Sort_Distance, Sort_Func, Sort_Mass, Sort_Multiple, Sort_Random, Sort_Reverse, Sort_Speed, Sort_Value