test — выполнение тестов файлов и текста

Синтаксис

test [EXPRESSION]
[ [EXPRESSION] ]

Описание

Тестирует заданное выражение и устанавливает код завершения в 0, если оно истинно, и в 1, если ложно. Выражение состоит из одного или нескольких операторов и их аргументов.

Первая форма (test) предпочтительнее. Для совместимости с другими оболочками доступна вторая форма: соответствующая пара квадратных скобок ([ [EXPRESSION] ]).

Данный тест в основном совместим с POSIX.

При использовании переменной в качестве аргумента оператора проверки почти всегда необходимо заключать её в двойные кавычки. Существуют только две ситуации, когда можно безопасно опустить кавычки. Первая — когда аргумент является литеральной строкой без пробелов или других символов, имеющих специальное значение для оболочки (например, точка с запятой). Например, test -b /my/file. Вторая — когда переменная расширяется ровно до одного элемента, включая пустую строку (например, set x ''). Если переменная не определена, определена, но не имеет значения или имеет более одного значения, её необходимо заключать в двойные кавычки. Например, test "$x" = "$y". Поскольку всегда безопасно заключать переменные в двойные кавычки при использовании их в качестве test аргументов, это рекомендуется.

Операторы для файлов и каталогов

-b FILE

Возвращает true, если FILE — это блочное устройство.

-c FILE

Возвращает true, если FILE — это символьное устройство.

-d FILE

Возвращает true, если FILE — это каталог.

-e FILE

Возвращает true, если FILE существует.

-f FILE

Возвращает true, если FILE — это обычный файл.

-g FILE

Возвращает true, если для FILE установлен бит set-group-ID.

-G FILE

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

-k FILE

Возвращает true, если для FILE установлен бит sticky. Если операционная система не поддерживает эту концепцию, возвращает false. См. https://en.wikipedia.org/wiki/Sticky_bit.

-L FILE

Возвращает true, если FILE — это символическая ссылка.

-O FILE

Возвращает true, если FILE существует и принадлежит текущему пользователю.

-p FILE

Возвращает true, если FILE — это именованная трубка.

-r FILE

Возвращает true, если FILE помечен как читаемый.

-s FILE

Возвращает true, если размер FILE больше нуля.

-S FILE

Возвращает true, если FILE — это сокет.

-t FD

Возвращает true, если дескриптор файла FD — это терминал (TTY).

-u FILE

Возвращает true, если для FILE установлен бит set-user-ID.

-w FILE

Возвращает true, если FILE помечен как записываемый; обратите внимание, что это не проверяет, является ли файловая система только для чтения.

-x FILE

Возвращает true, если FILE помечен как исполняемый.

Операторы для текстовых строк

STRING1 = STRING2

Возвращает true, если строки STRING1 и STRING2 идентичны.

STRING1 != STRING2

Возвращает true, если строки STRING1 и STRING2 не идентичны.

-n STRING

Возвращает true, если длина STRING ненулевая.

-z STRING

Возвращает true, если длина STRING равна нулю.

Операторы для сравнения и проверки чисел

NUM1 -eq NUM2

Возвращает true, если NUM1 и NUM2 численно равны.

NUM1 -ne NUM2

Возвращает true, если NUM1 и NUM2 численно не равны.

NUM1 -gt NUM2

Возвращает true, если NUM1 больше NUM2.

NUM1 -ge NUM2

Возвращает true, если NUM1 больше или равно NUM2.

NUM1 -lt NUM2

Возвращает true, если NUM1 меньше NUM2.

NUM1 -le NUM2

Возвращает true, если NUM1 меньше или равно NUM2.

Поддерживаются как целые, так и числа с плавающей точкой.

Операторы для объединения выражений

COND1 -a COND2

Возвращает true, если оба COND1 и COND2 истинны.

COND1 -o COND2

Возвращает true, если либо COND1, либо COND2 истинны.

Выражения можно инвертировать с помощью оператора !:

! ВЫРАЖЕНИЕ

Возвращает true, если ВЫРАЖЕНИЕ ложно, и false, если ВЫРАЖЕНИЕ истинно.

Выражения можно группировать с помощью скобок.

( ВЫРАЖЕНИЕ )

Возвращает значение ВЫРАЖЕНИЕ.

Обратите внимание, что скобки, как правило, требуют экранирования с помощью \(, чтобы избежать их интерпретации как подстановки команд.

Примеры

Если каталог /tmp существует, скопировать файл /etc/motd в него:

if test -d /tmp
    cp /etc/motd /tmp/motd
end

Если переменная MANPATH определена и не пуста, вывести её содержимое. (Если MANPATH не определена, она расширится до нулевых аргументов, если не заключена в кавычки.)

if test -n "$MANPATH"
    echo $MANPATH
end

Скобки и операторы -o и -a могут объединяться для создания более сложных выражений. В этом примере успех выводится, если существует файл /foo или /bar, а также файл /baz или /bat.

if test \( -f /foo -o -f /bar \) -a \( -f /baz -o -f /bat \)
    echo Success.
end

Числовые сравнения просто завершатся неудачей, если один из операндов не является числом:

if test 42 -eq "The answer to life, the universe and everything"
    echo So long and thanks for all the fish # will not be executed
end

Общим сравнением является сравнение с status:

if test $status -eq 0
    echo "Previous command succeeded"
end

Предыдущее тестирование также может быть инвертировано:

if test ! $status -eq 0
    echo "Previous command failed"
end

что логически эквивалентно следующему:

if test $status -ne 0
    echo "Previous command failed"
end

Стандарты

test реализует подмножество стандарта IEEE Std 1003.1-2008 (POSIX.1). Следующие исключения применяются:

• Операторы < и > для сравнения строк не реализованы.
• Поскольку этот тест является встроенной командой оболочки, а не самостоятельной утилитой, использование флага -c со специальными дескрипторами файлов, такими как стандартный ввод и вывод, может не давать тех же результатов при вызове из канала, что и ожидается при вызове утилиты test в другой оболочке.

В таких случаях можно использовать command test, чтобы явно использовать самостоятельную утилиту операционной системы test, а не эту встроенную команду builtin test.