[[http://www.siedler-games.de|{{:sg-link.jpg|}}]]

====== GetEntityName ======
\\
<code lua>
GetEntityName( _entity )
</code>
\\
Der Rückgabewert dieser Funktion ist der Name der entsprechenden Entity. Unter "Name" ist hier der im MapEditor vergebene Scriptname einer Entity zu verstehen.
\\
\\

===== Anwendungsbeispiel: =====

Mit Hilfe der nachfolgenden Funktion wollen wir innerhalb eines bestimmten Radius nach einer Entity suchen, deren Namen ermitteln und mit Hilfe der Funktion Message() am Bildschirm ausgeben lassen.
\\
<code lua>
function CheckHeroName( _pos, _range )
	local posHero = GetPosition( _pos )
	local Data = { Logic.GetEntitiesInArea( Entities.PU_Hero2, posHero.X, posHero.Y, _range, 20)};
		for i=2, Data[1]+1 do
			Message( GetEntityName( Data[i] ) );
		end
end
</code>
\\
Nach einem Aufruf mit
<code lua>
CeckHeroName( "Suchpunkt", 2000 )
</code>
und der Annahme, dass sich Bereich von 2000 Siedlerzentimetern um eine Entity mit dem Namen "Suchpunkt" unser allseits bekannter Pilgrim (mit dem Namen "Pilgrim") aufhält, erscheint am Bildschirm
<code lua>
Pilgrim
</code>
\\
\\
siehe auch:
  * [[s5lua_g:getentityid|GetEntityId]]
  * [[s5lua_g:getposition|GetPosition]]
  * [[utilfunctions:op_cleanup|Entities in einer bestimmten Region entfernen]]
\\
\\
zurück zu:
  * [[s5lua_g:functions-summary|Befehlsreferenz]]