Category: Objects
/ Search
Since engine version: 5.1 OC
FindObjects
Description
Creates a list of objects which fulfill the specified search criteria. Search criteria are composed of Find_x() values.
Syntax
array FindObjects(array Criteria, ...);
Parameters
- Criteria:
- Search criterion in the form of a Find_* function
- ...:
- [opt] Additional search criteria in the form of Find_* functions
Remarks
As opposed to FindObject, an object using FindObjects in local calls will also find itself. This can be avoided through use of Find_Exclude().
Criteria are specified in the same way as with FindObject and ObjectCount.
Examples
for(var vehicle in FindObjects (Find_Owner(1), Find_Category(C4D_Vehicle))) RemoveObject (vehicle);
Removes all vehicles of player 2.
protected func Hit()
{
for(var structure in FindObjects(Find_AtPoint(), Find_Category(C4D_Structure), Find_OCF(OCF_Inflammable)))
Incinerate(structure);
RemoveObject();
}
Arsonist flint: incinerates all buildings at the point of impact.
for(var obj in FindObjects( Find_Not(Find_Owner(NO_OWNER)) )) obj->SetOwner(NO_OWNER);
Anarchy! No object is owned by any player anymore.
See also: FindObject, Find_Action, Find_ActionTarget, Find_ActionTarget2, Find_ActionTargets, Find_Allied, Find_And, Find_AnyContainer, Find_AtPoint, Find_Category, Find_Container, Find_Distance, Find_Exclude, Find_Func, Find_Hostile, Find_ID, Find_InRect, Find_NoContainer, Find_Not, Find_OCF, Find_OnLine, Find_Or, Find_Owner, ObjectCount, Sort_Distance, Sort_Func, Sort_Mass, Sort_Multiple, Sort_Random, Sort_Reverse, Sort_Speed, Sort_Value


