FindObject

Kategorie: Objekte / Suche
Ab Engineversion: 1.0 OC

Beschreibung

Gibt ein Objekt zurück, das die angegebenen Suchkriterien erfüllt. Die Suchkriterien werden mittels speziellen Kriteriums-Funktionen der Form "Find_*" angegeben.

Syntax

object FindObject(array Criteria,  ...);

Parameter

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

Anmerkungen

Das aufrufende Objekt findet sich in FindObject auch selbst. Dies kann durch Find_Exclude() verhindert werden.
Die Kriterien werden genau so angegeben wie bei FindObjects und ObjectCount. Siehe FindObjects für weitere Kriterium-Beispiele.
Das aufrufende Objekt findet sich in FindObject auch selbst. Dies kann durch Find_Exclude() verhindert werden.
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().

Beispiel

if(FindObject(Find_Distance(10), Find_OCF(OCF_CrewMember), Find_Hostile(GetOwner()))
  Explode(20);
Wenn sich ein feindlicher Clonk näher als 10 Pixel an das Objekt heranwagt, explodiert dieses.
Siehe auch: 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_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