scripting:reference:standard_library:table
Das table-Modul
Eine Liste der in Siedler 5 verfügbaren Funktionen des Lua-table-Moduls mit einer kurzen Beschreibung. Verlinkt sind ausführlichere Doku-Seiten.
| Funktion | Beschreibung |
|---|---|
| table.concat (_Table [, _Separator [, _i [, _j] ] ] ) | Fügt die Inhalte eines numerischen Tables _Table in einem String zusammen, beginnend bei Index _i (standardmäßig 1) und endend bei Index _j (standardmäßig die Größe des Tables). Die einzelnen Werte sind durch _Separator (standardmäßig „“) getrennt. |
| table.foreach (_Table, _F) | Wendet die Funktion _F auf jeden Eintrag im Table _Table so lange an, bis _F nicht nil zurückgibt. Dabei wird _F in jeder Iteration ein Schlüssel-Wert-Paar übergeben. table.foreach gibt dann den letzten Rückgabewert von _F zurück. |
| table.foreachi (_Table, _F) | Wendet die Funktion _F auf jeden numerischen Eintrag im Table _Table so lange an, bis _F nicht nil zurückgibt. Dabei wird _F in jeder Iteration ein Index-Wert-Paar übergeben, aufsteigend von 1 bis n (n = Größe des Tables). table.foreachi gibt dann den letzten Rückgabewert von _F zurück. |
| table.getn (_Table) | Gibt die Anzahl der sequentiellen numerischen Einträge im Table _Table zurück (also wie viele Einträge von Index 1 aufwärts ununterbrochen im Table sind). |
| table.insert (_Table, [_Index,] _Value) | Fügt einen numerischen Eintrag in das Table _Table am Index _Index (standardmäßig Größe des Tables + 1, also ans Ende) ein. Falls _Index schon mit einem Wert belegt ist, wird dieser und alle nachfolgenden um einen Index nach oben verschoben. |
| table.remove (_Table, [_Index,] ) | Entfernt einen numerischen Eintrag aus dem Table _Table am Index _Index (standardmäßig Größe des Tables, also den letzten) und gibt den Wert des entfernten Eintrags zurück. Falls auf den Index _Index noch weitere Einträge folgen, werden deren Indizes um 1 reduziert, um die entstandene Lücke wieder zu schließen. |
| table.setn (_Table, _n ) | Setzt die Größe eines numerischen Tables _Table auf _n, sodass table.getn genau diesen Wert zurückgibt. |
| table.sort (_Table, [, _Comparator]) | Ordnet die Einträge eines numerischen Tables _Table so an, dass sie gemäß der Vergleichsfunktion _Comparator (standardmäßig <) aufsteigend sortiert sind. Der _Comparator muss in der Lage sein, zwei beliebige Einträge des Tables miteinander vergleichen zu können. |
scripting/reference/standard_library/table.txt · Zuletzt geändert: 2025/07/15 09:19 von fritz_98