ドキュメントの品質向上のためのご意見をください

簡潔すぎた
読みづらかった、または難し過ぎた
重要な情報が欠けていた
内容が間違っていた
翻訳版が必要
--選択-- Deutch (German) Español (Spanish) Français (French) Italiano (Italian) Português Brasil (Portuguese) 日本語 (Japanese) 한국어 (Korean) 简体中文 (Simplified Chinese) 繁體中文 (Traditional Chinese) その他の言語 その他

Your rating has been updated

貴重なご意見を有り難うございました!

あなたの貴重なご意見はより良いドキュメント作成の手助けとなります 内容の品質向上と追加コメントのためのアンケートに参加されますか？

アンケートに回答しますいいえ、回答しません

test

- 条件の評価

形式

/usr/bin/test [condition]

[ [condition] ]

sh

test [condition]

[ [condition] ]

csh

test [condition]

[ [condition] ]

ksh88

test [condition]

[ [condition] ]

ksh

test [condition]

[ [condition] ]

機能説明

test ユーティリティーは、condition が示す条件を評価し、その結果を終了ステータスで表します。評価結果が真のときは終了ステータスが 0 に、偽のときは 1 になります。

test ユーティリティーの第 1 の形式は次のとおりです。

test [condition]

角括弧は condition が省略可能なオペランドであり、必ずしもコマンド行で指定する必要がないことを示します。

test ユーティリティーの第 2 の形式は次のとおりです。

[ [ condition ] ]

最初の開く角括弧 ([) は必須のユーティリティー名です。内側の角括弧は condition がオプションであることを示しています。最後の閉じる角括弧 (])は必須のオペランドです。

2G バイト (2³¹ バイト) 以上のファイルに対する test の動作については、largefile(5) を参照してください。

test と [ ユーティリティーは条件 condition を評価して、その値が真である場合は終了ステータスを 0 に設定します。そうでない場合はゼロ以外の値 (偽) に設定します。引数がない場合は、test と [ ユーティリティーは終了ステータスをゼロ以外の値に設定します。アクセス権をテストするときは、プロセスの実効ユーザー ID が使用されます。

test と [ ユーティリティーに指定する引数、つまり、オペレータ、フラグ、および (最後の行を示す) 括弧はすべて、区切り文字で区切る必要があります。通常、これらの引数はスペースで区切られます。

オペランド

2 つの要素を持つ、次の形式のプライマリ:

-primary_operator primary_operand

これを、「単項プライマリ」と呼びます。3 つの要素を持つ、次のいずれかの形式のプライマリ:

primary_operand -primary_operator primary_operand
primary_operand primary_operator primary_operand

これを、「2 項プライマリ」と呼びます。

ファイルオペランド (-h と -L プライマリを除く) がシンボリックリンクを示している場合、シンボリックリンクは展開され、test は展開後のファイルに実行されます。

自分のファイルをテストした場合でも (-r、-w、または -x のテスト)、テストしたファイルのアクセス権に所有者ビットが設定されていない場合は、ファイルのアクセス権に「グループ」ビットまたは「その他」のビットが設定されていても、ゼロ以外 (偽) の終了ステータスが返されます。

= と != プライマリは単項プライマリよりも優先されます。= と != プライマリは常に引数をとります。したがって、= と != は単項プライマリの引数として使用できません。

condition を記述するために以下の基本式が使用できます。

-a file

ファイル file が存在すれば真。(sh では使用不可)

-b file

ファイル file が存在し、ブロック型特殊ファイルであれば真。

-c file

ファイル file が存在し、文字型特殊ファイルであれば真。

-d file

ファイル file が存在し、ディレクトリであれば真。

-e file

ファイル file が存在すれば真。(sh では使用不可)

-f file

ファイル file が存在し、そのファイルが通常ファイルであれば真。あるいは、/usr/bin/sh ユーザーが自分の PATH 環境変数内で /usr/bin よりも前に /usr/ucb を指定しており、file が存在し、そのファイルがディレクトリでなければ、test は真を返します。csh の test と [ ビルトインは常に後者の動作を行います。

-g file

ファイル file が存在し、セットグループ ID フラグが設定されていれば真。

-G file

ファイル file が存在し、ファイルのグループがプロセスの実効グループ ID と一致していれば真。(sh では使用不可)

-h file

ファイル file が存在し、シンボリックリンクであれば真。

-k file

ファイル file が存在し、スティッキビットが設定されていれば真。

-L file

ファイル file が存在し、シンボリックリンクであれば真。

-n string

string の長さがゼロでなければ真。

-o option

オプション option がついていれば真。csh または sh では、このオプションは使用できません。

-O file

ファイル file が存在し、プロセスの実効ユーザー ID がそのファイルを所有していれば真。sh では、このオプションは使用できません。

-p file

ファイル file が名前付きパイプ (FIFO) であれば真。

-r file

ファイル file が存在し、読み取り可能であれば真。

-s file

ファイル file が存在し、サイズがゼロより大きければ真。

-S file

ファイル file が存在し、そのファイルがソケットであれば真。sh では、このオプションは使用できません。

-t [file_descriptor]

ファイル記述子番号が file_descriptor であるファイルがオープンされていて、端末装置に対応していれば真。file_descriptor が指定されていない場合、デフォルト値として 1 が使用されます。

-u file

ファイル file が存在し、セットユーザー ID フラグが設定されていれば真。

-w file

ファイル file が存在し、書き込み可能であれば真。真であっても、書き込みフラグが設定されていることを表すだけです。ファイルシステムが読み取り専用であれば、この条件が真であっても file は書き込み不可能です。

-x file

ファイル file が存在し、実行可能であれば真。真であっても、実行フラグが設定されていることを表すだけです。file がディレクトリの場合には、真は file が検索可能なことを表します。

-z string

文字列 string の長さがゼロであれば真。

file1 -nt file2

ファイル file1 が存在し、file2 よりも新しい場合は真。sh では、このオプションは使用できません。

file1 -ot file2

ファイル file1 が存在し、file2 よりも古い場合は真。sh では、このオプションは使用できません。

file1 -ef file2

ファイル file1 と file2 が存在し、同じファイルを参照している場合は真。sh では、このオプションは使用できません。

string

文字列 string が NULL 文字列でなければ、真です。

string1 = string2

文字列 string1 と string2 が等しければ真。

string1 != string2

文字列 string1 と string2 が等しくなければ真。

n1 -eq n2

数値 n1 と n2 が代数的に等しければ真。数値は C99/XPG6/SUS で指定された任意の形式の整数、浮動小数点、または浮動小数点定数 ([+/-]Inf、[+/-]NaN など) です。

n1 -ne n2

数値 n1 と n2 が代数的に等しくなければ真。数値は C99/XPG6/SUS で指定された任意の形式の整数、浮動小数点、または浮動小数点定数 ([+/-]Inf、[+/-]NaN など) です。

n1 -gt n2

数値 n1 が代数的に数値 n2 より大きければ真。数値は C99/XPG6/SUS で指定された任意の形式の整数、浮動小数点、または浮動小数点定数 ([+/-]Inf、[+/-]NaN など) です。

n1 -ge n2

数値 n1 が代数的に数値 n2 より大きいか等しければ真。数値は C99/XPG6/SUS で指定された任意の形式の整数、浮動小数点、または浮動小数点定数 ([+/-]Inf、[+/-]NaN など) です。

n1 -lt n2

数値 n1 が代数的に数値 n2 より小さければ真。数値は C99/XPG6/SUS で指定された任意の形式の整数、浮動小数点、または浮動小数点定数 ([+/-]Inf、[+/-]NaN など) です。

n1 -le n2

数値 n1 が代数的に数値 n2 より小さいか等しければ真。数値は C99/XPG6/SUS で指定された任意の形式の整数、浮動小数点、または浮動小数点定数 ([+/-]Inf、[+/-]NaN など) です。

condition1 -a condition2

condition1 および condition2 の両方が真であれば真。-a 2 項プライマリは左結合であり、-o 2 項プライマリよりも優先される。

condition1 -o condition2

condition1 または condition2 のどちらかが真であれば真。-o バイナリプライマリは左結合である。

これらの基本式は、以下の演算子と組み合わせて指定できます。

! condition

条件 condition が偽であれば真。

( condition )

condition が真であれば真。丸括弧 ( ) を使用すると、通常の優先順位や結合規則を変更できる。丸括弧はシェルにとっても意味を持つので、引用する必要があります。

演算子の優先順位を決めるアルゴリズム、および生成される戻り値は、test に渡す引数の数により異なります。ただし [...] 形式を使う場合、最終引数の右角括弧は、このアルゴリズムでは引数には含まれません。

以下のリストにおいて、$1、$2、$3、$4 は、condition、condition1、または condition2 として test に渡す引数を表します。

引数 0 個

偽 (1) で終了。

引数 1 個

$1 が空でなければ真 (0) で終了。NULL なら偽。

引数 2 個

• $1 が ! のとき、$2 が空なら真、$2 が空でなければ偽。

• $1 が単項基本式のとき、単項テストの結果が真なら真、偽なら偽。

• その他の場合、結果は不確定です。

引数 3 個

• $2 が 2 項基本式のとき、$1 と $3 を対象に 2 項テストを実行。

• $1 が ! のとき、$2 と $3 の 2 つの引数に対するテストを否定形に。

• その他の場合、結果は不確定です。

引数 4 個

• $1が ! のとき、$2、$3、$4 の 3 つの引数に対するテストを否定形に。

• その他の場合、結果は不確定です。

使用法

基本式と演算子が混在しているような、ユーザーが用意した入力データを処理する際、スクリプト側では十分な注意が必要です。スクリプトに対して入力データが生成されるケースをアプリケーション作成者がすべて理解していない限り、test "$1" -a "$2" というような記述は、test "$1" && test "$2" と変えた方がいいでしょう。ユーザーが $1 を ! に設定し、$2 を空の文字列に設定したような場合の問題を防ぐためです。つまり移植性の高さが問題の場合には、test expr1 -a expr2 というような記述は test expr1 && test expr2 に変更し、 また、test expr1 -o expr2 の記述は test expr1 || test expr2 に変更してください。ただし、シェルでは && と -| | が同等の優先順位を持つのに対し、test では -a の方が o よりも優先順位が高いことに注意してください。

シェルコマンド言語では、グループ分け用に小括弧と中括弧が使用できます。

sh を使うときは、小括弧はエスケープ付きで記述しなければなりません。例:

test \( expr1 -a expr2 \) -o expr3

このコマンドは、 XSI 準拠のシステム以外では、必ずしも移植可能ではありません。この形式の代わりに、以下のように記述できます。

( test expr1 && test expr2 ) || test expr3

次に、以下の 2 つのコマンドを見てください。

test "$1"
test ! "$1"

古いシステムの一部では、このコマンドの動作は信頼性を欠くことがあります。つまりこのような string 条件を使い $1 を !、(、または単項基本式に展開すると、その結果は保証できません。したがって、それぞれ以下のように記述する方がいいでしょう。

test -n "$1"
test -z "$1"

同様に、古いシステムでは以下のようなコマンドの信頼性は保証できません。

test "$response" = "expected string"

これは、次のどちらかの形式に変えるようにしてください。

test "X$response" = "Xexpected string"
test "expected string" = "$response"

2 番目の形式は、expected string が単項基本式とまぎらわしくなることはない、というのが前提です。つまり expected string の先頭文字が -、(、!、= のいずれかのときは、1 番目の形式を使用してください。注記した事項を除き、前述の規則を使用すれば、前述の 3 つの比較形式はどのような入力データに対しても信頼性の高いものです。なお、どの形式でも文字列は引用符で囲んで記述する点に注意してください。

引数の数が 4 個を超えている場合、文字列比較の 2 項基本式 = と != はどの単項基本式よりも優先順位が高いので、引数が正しく指定されていないと処理結果は保証できません。たとえば次の例を見てください。

test -d $1 -o -d $2

ここで $1 の評価結果がディレクトリ名 = となった場合、先頭の 3 つの引数は文字列比較を表すものと見なされます。したがって 2 つ目の -d を検出したときに構文エラーとなります。 これを避けるには、次に示すどちらかの形式、できれば 2 番目の方を使用してください。

test \( -d "$1" \) -o \( -d "$2" \)
test -d "$1" || test -d "$2"

また引数が 4 個を超えているときに次のように指定したとします。

test "$1" = "bat" -a "$2" = "ball"

このとき $1 の評価結果が ( または ! だと構文エラーとなります。これを避けるには、次に示すいずれかの形式、できれば 3 番目を使用してください。

test "X$1" = "Xbat" -a "X$2" = "Xball"
test "$1" = "bat" && test "$2" = "ball"
test "X$1" = "Xbat" && test "X$2" = "Xball"

使用例

if の例では次の 3 つの状態が調べられ、3 つのすべてが真、または正常終了とみなされた場合、その結果が画面に出力されます。調べられる 3 つの内容は次のとおりです。

• 1 に設定されている変数の値が 0 より大きいか

• 2 に設定されている変数の値が 2 に等しいか

• root という語がテキストファイル /etc/passwd に含まれているか

/usr/bin/test

例 1 /usr/bin/test の使用

ディレクトリが存在しなければ mkdir を実行します。

test ! -d tempdir && mkdir tempdir

読み取り不可になるまで少し待つ。

while test -r thefile
do
   sleep 30
done
echo'"thefile" is no longer readable'

引数が 3 つの文字列 (2 つは変形) のうちの 1 つであり、test コマンドの開く角括弧バージョン ([) を使用していればコマンドを実行します。

if [ "$1" = "pear" ] || [ "$1" = "grape" ] || [ "$1" = "apple" ]
then
    command
fi
case "$1" in
    pear|grape|apple) command;;
esac

例 2 /usr/bin/test での -e オプションの使用

実際に sh で -e オプションを使用する場合、次のように /usr/bin/test を使用します。

if [ ! -h $PKG_INSTALL_ROOT$rLink ] && /usr/bin/test -e
$PKG_INSTALL_ROOT/usr/bin/$rFile ; then
    ln -s $rFile $PKG_INSTALL_ROOT$rLink
fi

test 組み込みコマンド

以下の例では、Bourne シェルの if に続いて test 組み込みコマンドの 2 つの形式を記します。

例 3 sh 組み込みコマンドの使用

ZERO=0 ONE=1 TWO=2 ROOT=root

if  [ $ONE -gt $ZERO ]

[ $TWO -eq 2 ]

grep $ROOT  /etc/passwd >&1 > /dev/null  # discard output

then

    echo "$ONE is greater than 0, $TWO equals 2, and $ROOT is" \
          "a user-name in the password file"

else

    echo "At least one of the three test conditions is false"        
fi

例 4 test 組み込みコマンドの使用

test 組み込みコマンドの例

test `grep $ROOT /etc/passwd >&1 /dev/null`   # discard output 

echo $?    # test for success
[ `grep nosuchname /etc/passwd >&1 /dev/null` ]

echo $?    # test for failure

csh

例 5 csh 組み込みコマンドの使用

@ ZERO = 0; @ ONE = 1; @ TWO = 2;  set ROOT = root
grep $ROOT  /etc/passwd >&1 /dev/null  # discard output         
    # $status must be tested for immediately following grep 
if ( "$status" == "0" && $ONE > $ZERO && $TWO == 2 ) then
       echo "$ONE is greater than 0, $TWO equals 2, and $ROOT is" \
             "a user-name in the password file"
 endif

ksh88

例 6 ksh88/ksh 組み込みコマンドの使用

ZERO=0 ONE=1 TWO=$((ONE+ONE)) ROOT=root         
if  ((ONE > ZERO))            # arithmetical comparison
 [[ $TWO = 2 ]]                # string comparison
 [ `grep $ROOT  /etc/passwd >&1 /dev/null` ] # discard output        
then 
     echo "$ONE is greater than 0, $TWO equals 2, and $ROOT is" \
             "a user-name in the password file"

else
     echo "At least one of the three test conditions is false"
fi

環境変数

test の実行に影響を与える次の環境変数についての詳細は、environ(5) を参照してください。LANG、LC_ALL、LC_CTYPE、LC_MESSAGES、および NLSPATH。

終了ステータス

次の終了ステータスが返されます。

0

condition の評価結果は真だった。

1

condition の評価結果は偽だった、または condition が指定されていなかった。

>1

エラーが発生した。

属性

属性についての詳細は、マニュアルページの attributes(5) を参照してください。

/usr/bin/test、csh、ksh88、sh

ksh

関連項目

csh(1), ksh(1), ksh88(1), sh(1), test(1B), attributes(5), environ(5), largefile(5), standards(5)

注意事項

-f オプションの代替である not-a-directory は BSD アプリケーションの移行を補助するものであり、将来のリリースではサポートされなくなる可能性があります。

XPG4 sh, ksh, ksh

次のような算術式を使用します。

$(( x > 3.1 )) #

次の代わりに

$ /usr/bin/test "$x" -gt 3.1 # )

2 つの浮動小数点変数、または定数と浮動小数点変数を比較して、(base16 から base10 への変換による) 丸め誤差が結果に影響を与えることを避ける場合です。さらに、XPG4 sh、ksh88、および ksh での組み込み演算のサポートは、比較するたびに文字列を明示的に変換する必要がないため、大幅に高速になります。