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

# Buildings.GetFirstBuilding

## `Buildings.GetFirstBuilding(Partei, Gebäudetyp)`

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)

⇒ Siehe [SU.Buildings.GetFirstBuilding](/s4-lua-api-de/su-library-functions/su.buildings/su.buildings.getfirstbuilding.md) um auch nach dem **Gebäudestatus** (Baustelle vs. fertiggestellt) zu filtern.

#### Notiz

* Partei ([Game.NumberOfPlayers](/s4-lua-api-de/library-functions/game/game.numberofplayers.md)) und Gebäudetyp ([Buildings](/s4-lua-api-de/api-enums/buildings.md#su-library)) müssen innerhalb des **gültigen Bereichs sein**, da ansonsten auf unbekannten Speicher zugegriffen wird, was zu undefinierten Verhalten und/oder Abstürzen führt!

#### Rückgabewert

* Einzigartige ID des gefundenen Gebäudes.
* 0: sonst / Fehler

#### Beispiel

```lua
local buildingID = Buildings.GetFirstBuilding(1, Buildings.GUARDTOWERSMALL)
```