FindObjects

Kategorie: Objekte / Suche
Ab Engineversion: 5.1 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.

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_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
Clonkonaut, 2006-07