> 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.getselection.md).

# SU.Entity.GetSelection

## SU.Entity.GetSelection(entityIDs, entityType=-1)

Gibt die Entity-IDs der aktuell ausgewählten Entitäten zurück.

**Achtung**: funktioniert nur beim **lokalen Spieler**!\
⇒ **Desync-Gefahr** wenn im Folgenden mit **lokalen Funktionen** das Spiel beeinflusst wird (siehe [Lokale vs Netzwerk-Funktionen](/s4-lua-api-de/tutorials/advanced-tipps/lokale-vs-netzwerk-funktionen.md)).

**Andere limitierte Versionen** sind:

* [SU.Buildings.GetSelection](/s4-lua-api-de/su-library-functions/su.buildings/su.buildings.getselection.md)
* [SU.Game.GetSelection](/s4-lua-api-de/su-library-functions/su.game/su.game.getselection.md)
* [SU.Settlers.GetSelection](/s4-lua-api-de/su-library-functions/su.settlers/su.settlers.getselection.md)
* [SU.Vehicles.GetSelection](/s4-lua-api-de/su-library-functions/su.vehicles/su.vehicles.getselection.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!
* `entityType`: [SU.EntityTypes](/s4-lua-api-de/su-api-enums/su.entitytypes.md) , -1 wenn keine Entity-Typen gefiltert werden sollen

#### 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.GetSelection(entityIDs, entityType)

local entityIDs = {}    -- oder einmalig global definiert
local numEntities = SU.Entity.GetSelection(entityIDs, -1)
<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>