diff --git a/doc/ru/scripting/builtins/libsession.md b/doc/ru/scripting/builtins/libsession.md new file mode 100644 index 000000000..17bc218cd --- /dev/null +++ b/doc/ru/scripting/builtins/libsession.md @@ -0,0 +1,18 @@ +# Библиотека *session* + +Библиотека используется для хранения данных, не сбрасывающихся при загрузке/выгрузке контента, являясь рекомендованной альтернативой использованию таблицы `_G`. + +Хранимые данные не сохраняются при завершении работы движка. + +Для минимизации риска коллизий имён рекомендуется использовать префиксы паков (`id_пака:имя_таблицы`), либо, если пак хранит одну таблицу в *session*, использовать имя пака как имя записи. + +```lua +-- Возвращает таблицу по имени. Создаёт пустую таблицу при отсутствии. +session.get(name: str) -> table + +-- Удаляет таблицу по имени. +session.reset(name: str) + +-- Возвращает true если таблица уже была создана вызовом session.get +session.has(name: str) -> boolean +```