Tarantool CE/EE Documentation portal logo
Помощь
Обновлена 15 сентября 2026 г. в 08:55

Модуль os

Общие сведения

Модуль os включает в себя следующие функции: execute(), rename(), getenv(), remove(), date(), exit(), time(), clock(), tmpname(), environ(), setenv(), setlocale(), difftime(). Большинство этих функций описаны в Главе 22 руководства по языку Lua Библиотека функций операционной системы.

Указатель

Ниже приведен перечень всех функций модуля os.

Имя

Назначение

os.execute()

Выполнение через оболочку

os.rename()

Переименование файла или директории

os.getenv()

Получение переменной окружения

os.remove()

Удаление файла или директории

os.date()

Получение отформатированной даты

os.exit()

Выход из программы

os.time()

Получение количества секунд с начала эпохи

os.clock()

Секунды процессорного времени с момента запуска программы

os.tmpname()

Получение имени временного файла

os.environ()

Получение таблицы со всеми переменными окружения

os.setenv()

Установка переменной окружения

os.setlocale()

Изменение локали

os.difftime()

Кол-во секунд между двумя моментами времени

os.execute(shell-command)

Выполнение путем передачи в ОС.

Параметры:

  • shell-command (string) — что выполнить.

Пример:

tarantool> os.execute('ls -l /usr')total 200drwxr-xr-x   2 root root 65536 Apr 22 15:49 bindrwxr-xr-x  59 root root 20480 Apr 18 07:58 includedrwxr-xr-x 210 root root 65536 Apr 18 07:59 libdrwxr-xr-x  12 root root  4096 Apr 22 15:49 localdrwxr-xr-x   2 root root 12288 Jan 31 09:50 sbin---...

os.rename(old-name, new-name)

Переименование файла или директории.

Параметры:

  • old-name (string) — имя существующего файла или директории
  • new-name (string) — новое имя файла или директории.

Пример:

tarantool> os.rename('local','foreign')---- null- 'local: No such file or directory'- 2...

os.getenv(variable-name)

Получение переменной окружения.

Параметры:

  • variable-name (string) — имя переменной окружения.

Пример:

tarantool> os.getenv('PATH')---- /usr/local/sbin:/usr/local/bin:/usr/sbin...

os.remove(name)

Удаление файла или директории.

Параметры:

  • name (string) — имя файла или директории, которые будут удалены.

Пример:

tarantool> os.remove('file')---- true...

os.date(format-string[, time-since-epoch])

Возврат даты в формате.

Параметры:

  • format-string (string) — инструкции
  • time-since-epoch (string) — число секунд с 1970-01-01. Если не указать time-since-epoch, предполагается использование текущего времени.

Пример:

tarantool> os.date("%A %B %d")---- Sunday April 24...

os.exit()

Выход из программы. Если выполняется на экземпляре сервера, останавливается работа экземпляра.

Пример:

tarantool> os.exit()user@user-shell:~/tarantool_sandbox$

os.time()

Возврат числа секунд с начала отсчета.

Пример:

tarantool> os.time()---- 1461516945...

os.clock()

Возврат числа секунд времени ЦП с момента начала программы.

Пример:

tarantool> os.clock()---- 0.05...

os.tmpname()

Возврат имени временного файла.

Пример:

tarantool> os.tmpname()---- /tmp/lua_7SW1m2...

os.environ()

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

Пример:

tarantool> os.environ()['TERM']..os.environ()['SHELL']---- xterm/bin/bash...

os.setenv(variable-name, variable-value)

Определение переменной окружения.

Параметры:

  • variable-name (string) — имя переменной окружения
  • variable-value (string) — значение переменной окружения

Пример:

tarantool> os.setenv('VERSION','99')----...

os.setlocale([new-locale-string])

Изменение локали. Если не указать new-locale-string, вернется текущая локаль.

Параметры:

  • new-locale-string (string) — новая локаль.

Пример:

tarantool> string.sub(os.setlocale(),1,20)---- LC_CTYPE=en_US.UTF-8...

os.difftime(time1, time2)

Возврат числа секунд между двумя значениями времени.

Параметры:

  • time1 (number) — первое значение времени
  • time2 (number) — второе значение времени

Пример:

tarantool> os.difftime(os.time() - 0)---- 1486594859...