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.