FindObjects

Kategorie: Objekte / Suche
Ab Engineversion: 1.0 OC

Beschreibung

Erstellt eine Liste von Objekten, auf die alle angegeben Suchkriterien zutreffen. Die Suchkriterien werden mittels speziellen Kriteriums-Funktionen der Form "Find_*" angegeben.

Syntax

array FindObjects(array Criteria,  ...);

Parameter

Criteria:
Suchkriterium in Form einer Find_*-Funktion
...:
[opt] Weitere Suchkriterium in Form einer Find_*-Funktion

Anmerkungen

Anders als bei FindObject findet sich bei objektlokalen Aufrufen von FindObjects das aufrufende Objekt selbst. Dies kann durch Find_Exclude() verhindert werden.
Die Kriterien werden genau so angegeben wie bei FindObject und ObjectCount.
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().

Beispiele

for(var vehicle in FindObjects (Find_Owner(1), Find_Category(C4D_Vehicle)))
  RemoveObject (vehicle);
Lässt alle Fahrzeuge von Spieler 2 verschwinden.
protected func Hit()
{
  for(var structure in FindObjects(Find_AtPoint(), Find_Category(C4D_Structure), Find_OCF(OCF_Inflammable)))
    Incinerate(structure);
  RemoveObject();
}
Der Feuerteufelflint: entzündet beim Auftreffen alle brennbaren Gebäude, die er berührt.
for(var obj in FindObjects( Find_Not(Find_Owner(NO_OWNER)) ))
  obj->SetOwner(NO_OWNER);
Anarchie! Kein Objekt gehört mehr einem Spieler.
Siehe auch: FindObject, 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_Or, Find_Owner, Find_Property, Find_Team, ObjectCount, Sort_Distance, Sort_Func, Sort_Mass, Sort_Multiple, Sort_Random, Sort_Reverse, Sort_Speed, Sort_Value
Clonkonaut, 2006-07