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

# SU.Settlers.GetSelection

## SU.Settlers.GetSelection(vehicleIDs)

Gibt die Sielder-IDs der aktuell ausgewählten Entitäten zurück.\
⇒ ist eine auf Siedler limitierte Version von [SU.Entity.GetSelection](/s4-lua-api-de/su-library-functions/su.entity/su.entity.getselection.md).

**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)).

#### Parameter

* `settlerIDs`: **Ziel-Tabelle**: Eine vor dem Funktionsaufruf erstellte Tabelle (z. B. `local settlerIDs = {}`, 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!

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

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