5.8 – Функции операционной системы

Эта библиотека включена в таблицу os.

os.clock ()

Возвращает примерное количество времени в секундах, которое программа выполнялась на CPU.

os.date ([format [, time]])

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

Если аргумент time передается функции, то должно быть отформатировано «время» (см. функцию os.time). В противном случае, параметр date используется для форматирования текущего времени.

Если параметр format начинается с '!', то время форматируется в соответствии с универсальным глобальным временем (по Гринвичу). После этого опционального символа, если format равен "*t", то date возвращает таблицу со следующими полями: year (год, четыре цифры), month (месяц, 1 – 12), day (день, 1 – 31), hour (час, 0 – 23), min (минуты, 0 – 59), sec (секунды, 0 – 61), wday (день недели, воскресенью соответствует 1), yday (день года), и isdst (флаг дневного времени суток, тип boolean).

Если format не равен "*t", то функция date возвращает дату в виде строки, отформатированной в соответствии с правилами функции C strftime.

При вызове без аргументов, date возвращает данные «в обычном формате», который зависит от системы и текущих настроек операционной системы (т.е., os.date() эквивалентна os.date("%c")).

os.difftime (t2, t1)

Возвращает число секунд, прошедшее от времени t1 до времени t2. В POSIX, Windows, и некоторых других системах, это значение равно в точности t2-t1.

os.execute ([command])

Эта функция эквивалентна функции C system. Она передает параметр command на выполнение шеллу операционной системы. Она возвращает системно-зависимый статус. Если параметр command не передается, то возвращает не ноль, если шелл доступен и ноль в противном случае.

os.exit ([code])

Вызывает функцию C exit, с опциональным параметром code, для останова выполнения программы-хозяина. Значение по умолчанию для параметра code – код успешного завершения. Примечание: в ISO C описаны коды 0, EXIT_SUCCESS (обычно равен 0, но не стандартизирован, может обозначать «успешное завершение, отличное от состояния 0»), EXIT_FAILURE (обычно какое-либо ненулевое значение, но не стандартизирован).

os.getenv (varname)

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

os.remove (filename)

Удалаяет файл или директорию с заданным именем. Директории должны быть пусты. Если функция не может провести удаления, она возвращает nil, плюс строку, содержащую описание ошибки.

os.rename (oldname, newname)

Переименовывает файл или директорию oldname в newname. Если функция не модет провести переименования, она возвращает nil, плюс строку, содержащую описание ошибки.

os.setlocale (locale [, category])

Изменяет текущие региональные настройки (locale) программы. Параметр locale является строкой, содержащей региональные настройки (locale); category – опциональный строчный параметр, содержащий категорию, для которой производится изменение: "all", "collate", "ctype", "monetary", "numeric", или "time"; значением по умолчанию является категория "all". Функция возвращает значение новых настроек (locale), или nil, если вызов не может быть обработан.

Если locale – пустая строка, региональные настройки изменяются на региональные настройки, определяемые реализацией (implementation-defined native locale). Если locale – строка "C", текущие реиональные настройки изменяются на стандартные C-настройки.

При вызове с nil вместо первого аргумента, эта функция возвращает текущие региональные настройки для заданной категории.

os.time ([table])

Возвращает текущее время при вызове без аргументов, или время и дату, указанные в передаваемой таблице. Эта таблица должна иметь поля year, month, и day, и может иметь поля hour, min, sec, и isdst (описание этих полей см. в описании функции os.date).

Возвращаемое значание – это число, значение которого зависит от системы. В POSIX, Windows, и некоторых других системах, это число соответствует количеству секунд, отсчитываемому от некоторого заданного момента времени ("эпоха"). В других системах, значение не специфицировано, и число, возвращаемое функцией time, может быть использовано только как аргумент функций date и difftime.

os.tmpname ()

Возвращает строку с именем файла, который может быть использован в качестве временного файла. Файл должен быть явно открыт до использования и явно удален, если больше не будет нужен.