Модуль:Table/doc

Это страница документации Модуль:Table.

Стандартная библиотека для работы с таблицами в Lua. Для массивов смотрите Module:Array.

API[править код]

Программное имя: Table

copy (tbl: table) → table

Возвращает поверхностную копию таблицы

{{#iccupdb_datapoint:API_Table/doc_copy

     |type=api
     |name=copy
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Возвращает поверхностную копию таблицы
       |params=tbl: table
       |returns=table
       |module=Module:Table
     }}
   }}

deepCopy (tbl: table) → table

Возвращает глубокую копию таблицы

{{#iccupdb_datapoint:API_Table/doc_deepCopy

     |type=api
     |name=deepCopy
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Возвращает глубокую копию таблицы
       |params=tbl: table
       |returns=table
       |module=Module:Table
     }}
   }}

filter (tbl: table, predicate: function, argument: any) → table

Фильтрует таблицу с использованием заданной функции предиката, с необязательным вторым аргументом

{{#iccupdb_datapoint:API_Table/doc_filter

     |type=api
     |name=filter
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Фильтрует таблицу с использованием заданной функции предиката, с необязательным вторым аргументом
       |params=tbl: table, predicate: function, argument: any
       |returns=table
       |module=Module:Table
     }}
   }}

includes (tbl: table, value: any) → boolean

Возвращает true, если таблица содержит указанный элемент

{{#iccupdb_datapoint:API_Table/doc_includes

     |type=api
     |name=includes
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Возвращает true, если таблица содержит указанный элемент
       |params=tbl: table, value: any
       |returns=boolean
       |module=Module:Table
     }}
   }}

isEmpty (tbl: table) → boolean

Возвращает true, если таблица пуста

{{#iccupdb_datapoint:API_Table/doc_isEmpty

     |type=api
     |name=isEmpty
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Возвращает true, если таблица пуста
       |params=tbl: table
       |returns=boolean
       |module=Module:Table
     }}
   }}

randomize (tbl: table) → table

Перемешивает элементы таблицы на месте с использованием алгоритма Фишера-Йетса

{{#iccupdb_datapoint:API_Table/doc_randomize

     |type=api
     |name=randomize
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Перемешивает элементы таблицы на месте с использованием алгоритма Фишера-Йетса
       |params=tbl: table
       |returns=table
       |module=Module:Table
     }}
   }}

size (tbl: table) → int

Возвращает количество элементов в таблице

{{#iccupdb_datapoint:API_Table/doc_size

     |type=api
     |name=size
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Возвращает количество элементов в таблице
       |params=tbl: table
       |returns=int
       |module=Module:Table
     }}
   }}

uniqueKey (tbl: table) → Key?

Возвращает уникальный ключ в таблице. Возвращает nil, если таблица пуста или имеет несколько ключей.

{{#iccupdb_datapoint:API_Table/doc_uniqueKey

     |type=api
     |name=uniqueKey
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Возвращает уникальный ключ в таблице. Возвращает nil, если таблица пуста или имеет несколько ключей.
       |params=tbl: table
       |returns=Key?
       |module=Module:Table
     }}
   }}

iter.spairs (tbl: table, order: function) → function

Итерирует по таблице в отсортированном порядке

{{#iccupdb_datapoint:API_Table/doc_iter.spairs

     |type=api
     |name=iter.spairs
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Итерирует по таблице в отсортированном порядке
       |params=tbl: table, order: function
       |returns=function
       |module=Module:Table
     }}
   }}

iter.forEach (tbl: table, lambda: function) → function

Итерирует по таблице по принципу forEach

{{#iccupdb_datapoint:API_Table/doc_iter.forEach

     |type=api
     |name=iter.forEach
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Итерирует по таблице по принципу forEach
       |params=tbl: table, lambda: function
       |returns=function
       |module=Module:Table
     }}
   }}

iter.forEachIndexed (tbl: table, lambda: function) → function

Итерирует по таблице с индексацией

{{#iccupdb_datapoint:API_Table/doc_iter.forEachIndexed

     |type=api
     |name=iter.forEachIndexed
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Итерирует по таблице с индексацией
       |params=tbl: table, lambda: function
       |returns=function
       |module=Module:Table
     }}
   }}

iter.forEachPair (tbl: table, lambda: function) → function

Итерирует по таблице по принципу forEachPair

{{#iccupdb_datapoint:API_Table/doc_iter.forEachPair

     |type=api
     |name=iter.forEachPair
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Итерирует по таблице по принципу forEachPair
       |params=tbl: table, lambda: function
       |returns=function
       |module=Module:Table
     }}
   }}

mergeInto (target: table, ...: table(s)) → table

Копирует элементы из второй таблицы в первую, переопределяя существующие элементы. Первая таблица изменяется в процессе. (Можно вызвать с более чем двумя таблицами. Дополнительные таблицы объединяются в первую таблицу поочередно.)

{{#iccupdb_datapoint:API_Table/doc_mergeInto

     |type=api
     |name=mergeInto
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Копирует элементы из второй таблицы в первую, переопределяя существующие элементы. Первая таблица изменяется в процессе. (Можно вызвать с более чем двумя таблицами. Дополнительные таблицы объединяются в первую таблицу поочередно.)
       |params=target: table, ...: table(s)
       |returns=table
       |module=Module:Table
     }}
   }}

merge (...: table(s)) → table

Создает таблицу с объединенными записями из входных таблиц, приоритет отдается записям из последующих таблиц. Входные таблицы не изменяются.

{{#iccupdb_datapoint:API_Table/doc_merge

     |type=api
     |name=merge
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Создает таблицу с объединенными записями из входных таблиц, приоритет отдается записям из последующих таблиц. Входные таблицы не изменяются.
       |params=...: table(s)
       |returns=table
       |module=Module:Table
     }}
   }}

map (xTable: table, f: function) → table

Применяет функцию к каждой записи в таблице и размещает результаты в новой таблице.

{{#iccupdb_datapoint:API_Table/doc_map

     |type=api
     |name=map
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Применяет функцию к каждой записи в таблице и размещает результаты в новой таблице.
       |params=xTable: table, f: function
       |returns=table
       |module=Module:Table
     }}
   }}

mapValues (xTable: table, f: function) → table

Применяет функцию к каждому значению в таблице и размещает результаты в новой таблице под теми же ключами.

{{#iccupdb_datapoint:API_Table/doc_mapValues

     |type=api
     |name=mapValues
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Применяет функцию к каждому значению в таблице и размещает результаты в новой таблице под теми же ключами.
       |params=xTable: table, f: function
       |returns=table
       |module=Module:Table
     }}
   }}

extract (tbl: table, key: table-key) → value

Удаляет ключ из таблицы и возвращает его значение.

{{#iccupdb_datapoint:API_Table/doc_extract

     |type=api
     |name=extract
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Удаляет ключ из таблицы и возвращает его значение.
       |params=tbl: table, key: table-key
       |returns=value
       |module=Module:Table
     }}
   }}

getByPath (tbl: table, path: array) → value

Возвращает значение по указанному пути во вложенной таблице. Путь указывается массивом.

{{#iccupdb_datapoint:API_Table/doc_getByPath

     |type=api
     |name=getByPath
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Возвращает значение по указанному пути во вложенной таблице. Путь указывается массивом.
       |params=tbl: table, path: array
       |returns=value
       |module=Module:Table
     }}
   }}

getByPathOrNil (tbl: table, path: array) → value?

Возвращает значение по указанному пути во вложенной таблице, или nil, если доступ невозможен. Путь указывается массивом.

{{#iccupdb_datapoint:API_Table/doc_getByPathOrNil

     |type=api
     |name=getByPathOrNil
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Возвращает значение по указанному пути во вложенной таблице, или nil, если доступ невозможен. Путь указывается массивом.
       |params=tbl: table, path: array
       |returns=value?
       |module=Module:Table
     }}
   }}

setByPath (tbl: table, path: array, value: any) → nil

Устанавливает значение по указанному пути во вложенной таблице. Путь указывается массивом.

{{#iccupdb_datapoint:API_Table/doc_setByPath

     |type=api
     |name=setByPath
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Устанавливает значение по указанному пути во вложенной таблице. Путь указывается массивом.
       |params=tbl: table, path: array, value: any
       |returns=nil
       |module=Module:Table
     }}
   }}

any (tbl: table, predicate: function) → boolean

Возвращает true, если хотя бы одна запись в таблице удовлетворяет предикату.

{{#iccupdb_datapoint:API_Table/doc_any

     |type=api
     |name=any
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Возвращает true, если хотя бы одна запись в таблице удовлетворяет предикату.
       |params=tbl: table, predicate: function
       |returns=boolean
       |module=Module:Table
     }}
   }}

all (tbl: table, predicate: function) → boolean

Возвращает true, если все записи в таблице удовлетворяют предикату.

{{#iccupdb_datapoint:API_Table/doc_all

     |type=api
     |name=all
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Возвращает true, если все записи в таблице удовлетворяют предикату.
       |params=tbl: table, predicate: function
       |returns=boolean
       |module=Module:Table
     }}
   }}

pack (...: values) → table

Полифил для функции table.pack в Lua 5.2

{{#iccupdb_datapoint:API_Table/doc_pack

     |type=api
     |name=pack
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Полифил для функции table.pack в Lua 5.2
       |params=...: values
       |returns=table
       |module=Module:Table
     }}
   }}

mapArgumentsByPrefix (args: table, prefixes: table, f: function) → table

Извлекает ключи с префиксами и числовыми индексами из таблицы аргументов и применяет преобразование к каждому ключу или индексу

{{#iccupdb_datapoint:API_Table/doc_mapArgumentsByPrefix

     |type=api
     |name=mapArgumentsByPrefix
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Извлекает ключи с префиксами и числовыми индексами из таблицы аргументов и применяет преобразование к каждому ключу или индексу
       |params=args: table, prefixes: table, f: function
       |returns=table
       |module=Module:Table
     }}
   }}

mapArguments (args: table, indexFromKey: function, f: function) → table

Извлекает ключи на основе переданной функции `indexFromKey` с числовыми индексами из таблицы аргументов и применяет преобразование к каждому ключу или индексу

{{#iccupdb_datapoint:API_Table/doc_mapArguments

     |type=api
     |name=mapArguments
     |information=
     |image=
     |date=
     |extradata={{#iccupdb_create_json:
       |description=Извлекает ключи на основе переданной функции `indexFromKey` с числовыми индексами из таблицы аргументов и применяет преобразование к каждому ключу или индексу
       |params=args: table, indexFromKey: function, f: function
       |returns=table
       |module=Module:Table
     }}
   }}

Посмотрите всю нашу документацию iCCup здесь.