> For the complete documentation index, see [llms.txt](https://docs.settlers-united.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.settlers-united.com/s4-lua-api-de/su-library-functions/su.entity/su.entity.getentitiesinarea.md).

# SU.Entity.GetEntitiesInArea

## SU.Entity.GetEntitiesInArea(entityIDs, playerID, entityType, x, y, radius, skipInhabitants=1)

Gibt die Entity-IDs der Entitäten im gegebenen Bereich zurück.

**Achtung**: Dies liefert beispielsweise bei Gebäuden die IDs von: Gebäude, Arbeiter, Insassen (je nach Einstellung) und die Warenstapel vom Gebäude - falls in Reichweite.

**Andere limitierte Versionen** sind:

* [SU.Buildings.GetBuildingsInArea](/s4-lua-api-de/su-library-functions/su.buildings/su.buildings.getbuildingsinarea-1.md)
* [SU.Goods.GetGoodsInArea](/s4-lua-api-de/su-library-functions/su.goods/su.goods.getgoodsinarea.md)
* [SU.Settlers.GetSettlersInArea](/s4-lua-api-de/su-library-functions/su.settlers/su.settlers.getsettlersinarea.md)
* [SU.Vehicles.GetVehiclesInArea](/s4-lua-api-de/su-library-functions/su.vehicles/su.vehicles.getvehiclesinarea.md)

#### Parameter

* `entityIDs`: **Ziel-Tabelle**: Eine vor dem Funktionsaufruf erstellte Tabelle (z. B. `local entityIDs = {}`, siehe Beispiel unten), die dann von dieser Funktion mit den gefundenen Entity-IDs befüllt wird. **Achtung**: Bereits enthaltene Daten in dieser Tabelle werden dabei überschrieben!
* `playerID`: ID des Spielers (1-8), Index 0 ungültig, -1 wenn keine Spieler gefiltert werden sollen
* `entityType`: [SU.EntityTypes](/s4-lua-api-de/su-api-enums/su.entitytypes.md) , -1 wenn keine Entity-Typen gefiltert werden sollen
* `x`: x-Koordinate des Bereichs
* `y`: y-Koordinate des Bereichs
* `radius [0-74]`: Radius des Bereichs
* `skipInhabitants` (optional): ob Insassen (Soldaten) beachtet werden sollen oder nicht. Arbeiter werden immer berücksichtigt!

#### Rückgabewert

* `number` (Anzahl): Die Gesamtzahl der gefundenen Entitäten.
* **Hinweis***:* Die eigentlichen Entity-IDs werden nicht als Rückgabewert geliefert, sondern direkt in die als ersten Parameter übergebene Ziel-Tabelle geschrieben.

#### Beispiel

<pre class="language-lua"><code class="lang-lua">local entityIDs = {}    -- oder einmalig global definiert
local numEntities = SU.Entity.GetEntitiesInArea(entityIDs, playerID, entityType, x, y, radius)

local entityIDs = {}    -- oder einmalig global definiert
local numEntities = SU.Entity.GetEntitiesInArea(entityIDs, -1, -1, 115, 70, 10)
<strong>-- Alle Entitäten bei 115/70 im Radius von 10
</strong>if numEntities > 0 then
    dbg.stm(numEntities) -- Anzahl der Entitäten
    dbg.stm(entityIDs[1]) -- Erster Eintrag der Id Liste
end
</code></pre>