FindObjects

Kategorie: Objekte / Suche
Ab Engineversion: 4.9.6.0 CR

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 FindObject2 und ObjectCount2.

Beispiele

for(var pVehicle in FindObjects (Find_Owner(1), Find_Category(C4D_Vehicle)))
  RemoveObject (pVehicle);
Lässt alle Fahrzeuge von Spieler 2 verschwinden.
protected func Hit()
{
  for(var pStructure in FindObjects(Find_AtPoint(), Find_Category(C4D_Structure), Find_OCF(OCF_Inflammable)))
    Incinerate(pStructure);
  RemoveObject();
}
Der Feuerteufelflint: entzündet beim Auftreffen alle brennbaren Gebäude, die er berührt.
for(var pObj in FindObjects( Find_Not(Find_Owner(NO_OWNER)) ))
  pObj->SetOwner(NO_OWNER);
Anarchie! Kein Objekt gehört mehr einem Spieler.
Siehe auch: FindObject, FindObject2, FindObjectOwner, Find_Action, Find_ActionTarget, 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_Layer, Find_NoContainer, Find_Not, Find_OCF, Find_Or, Find_Owner, ObjectCount2, Sort_
Clonkonaut, Juli 2006