Inhaltsverzeichnis

GetEntityId

GetEntityId( EntityName )

Liefert die EntityID einer Entity.

Parameter

Rückgabe

Beschreibung

GetEntityId() liefert die ID einer Entity. Ist der Parameter EntityName kein String, wird er unverändert zurückgegeben. Das kann praktisch sein, wenn man nicht weiß, ob man mit dem Parameter schon eine ID hat, oder noch nicht und sicher gehen will, dass man die ID bekommt.

Existiert keine Entity mit dem Namen in EntityName, wird 0 zurückgegeben.

Verwendung

Viele interne Funktionen benötigen die ID einer Entity als Parameter, und nicht deren Name. Sofern man sie verwendet, muss man also zwangsweise die IDs der verwendeten Entities abfragen.

Abgesehen davon bietet es, sofern man sehr viele Einheiten regelmäßig per Script kontrolliert, einen gewissen Geschwindigkeitsvorteil, diese über ihre gespeicherte ID anzusprechen, und nicht jedes Mal wieder über ihren Namen.

Beispiel

Im Editor wurde eine Entity mit „Dario“ benannt. Man kann im Selektionsexplorer die ID 12345 ablesen.

local EntityID = GetEntityId("Dario")
Message("EntityID von Dario ist: " .. EntityID)

Im Spiel wird die Meldung „EntityID von Dario ist: 12345“ ausgegeben.

Würde man anstelle von GetEntityId(„Dario“) nun GetEntityId(12345) schreiben, wäre die Ausgabe dennoch identisch.