table library

table.concat (list [, sep [, i [, j]]])

Получает список list, где все элементы строки или числа, возвращает строку list[i]..sep..list[i+1] ··· sep..list[j]. По умолчанию, sep это пустая строка, i = 1 и j = #list. Если i > j, возвращает пустую строку.

table.insert (list, [pos,] value)

Вставляет элемент value на позицию pos в список list, сдвигая элементы вверх list[pos], list[pos+1], ···, list[#list]. По умолчанию,pos = #list+1, так вызов table.insert(t,x) вставляет x в конец списка t.

table.move (a1, f, e, t [,a2])

Перемещает элементы из таблицы a1 в таблицу a2. Эта функция эквивалентна множественному присваиванию: a2[t],··· = a1[f],···,a1[e]. По умолчанию, a2 = a1. Целевой диапазон может перекрываться с диапазоном источником. Количество элементов для перемещения должно помещаться в целое Lua.

table.pack (···)

Возвращает новую таблицу, в которой все параметры сохранены с ключами 1, 2 и т.д. и поле «n» содержит количество параметров. Учтите, что результирующая таблица может не быть последовательностью.

table.remove (list [, pos])

Удаляет из списка list элемент на позиции pos, возвращая значение этого элемента. Когда pos это целое между 1 и #list, функция сдвигает элементы вниз list[pos+1], list[pos+2], ···, list[#list] и стирает элемент list[#list]; Индекс pos может быть 0, когда #list = 0, или#list + 1; в этих случаях функция стирает элемент list[pos].

По умолчанию, pos = #list, так вызов table.remove(l) удаляет последний элемент списка l.

table.sort (list [, comp])

Сортирует элементы полученного списка, на месте, от list[1] до list[#list]. Если передан параметр comp, он должен быть функцией, которая получает два элемента списка и возвращает true, когда первый элемент должен находиться перед вторым в финальном упорядочении (так выражение not comp(list[i+1],list[i]) будет истинным после сортировки). Если параметр comp не передан, то взамен Lua использует стандартный оператор <.

Алгоритм сортировки не стабилен; т.е. элементы, считающиеся равными в этом упорядочении, в результате сортировки могут изменить свои относительные позиции.

table.unpack (list [, i [, j]])

Возвращает элементы из полученного списка. Эта функция эквивалентна

 return list[i], list[i+1], ···, list[j]

По умолчанию, i = 1 и j = #list.