> 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.buildings/su.buildings.getfirstbuilding.md).

# SU.Buildings.GetFirstBuilding

## SU.Buildings.GetFirstBuilding(playerID, buildingType, buildingState=Buildings.ALL)

Gibt die erste (=**neueste**) Gebäude-ID vom angegebenen Gebäude-Typs zurück um beispielsweise durch alle Gebäude dieses Typs zu iterieren. ⇒ [SU.Buildings.GetNextBuilding](/s4-lua-api-de/su-library-functions/su.buildings/su.buildings.getnextbuilding.md)

#### Parameter

* `playerID [1-8]`: Spieler-ID, **Index 0 ist ungültig!**
* `buildingType`: [Buildings](/s4-lua-api-de/api-enums/buildings.md)
* `buildingState` (optional): Gebäude-Status nach dem gesucht werden soll, siehe [Buildings](/s4-lua-api-de/api-enums/buildings.md)

#### Rückgabewert

* Gebäude-ID
* 0 falls keines vorhanden / Fehler

#### Beispiel

```lua
-- findet die erste (älteste) Baustelle eines kleinen Turms von Spieler 1
local buildingID = SU.Buildings.GetFirstBuilding(1, Buildings.GUARDTOWERSMALL, Buildings.UNDERCONSTRUCTION)
```