====== GetEntityId ======

<code lua>GetEntityId( EntityName )</code>

Liefert die EntityID einer [[glossary:entity|Entity]].

===== Parameter =====

  * //string// **EntityName**: Scriptname der Entity

===== Rückgabe =====

  * //number//: Eindeutige [[glossary:ID]] der Entity.

===== 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.
<code lua>local EntityID = GetEntityId("Dario")
Message("EntityID von Dario ist: " .. EntityID)</code>
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.