(PHP 4, PHP 5)
empty — 変数が空であるかどうかを検査する
変数が空であるかどうかを検査します。
変数が空であるとみなされるのは、変数が存在しない場合や
変数の値が FALSE に等しい場合です。
empty() は、変数が存在しない場合でも警告を発しません。
var
チェックする変数
注意:
PHP 5.5 より前のバージョンでは、 empty() がサポートするのは変数だけです。 それ以外の値をチェックするとパースエラーになります。つまり、 empty(trim($name)) は動作しません。かわりに trim($name) == false を使います。
変数が存在しなくても警告は発生しません。 つまり、 empty() は本質的に !isset($var) || $var == false と同じことを簡潔に記述しているだけです。
var が存在し、かつその値が空や0でなければ FALSE を返します。
それ以外の場合は TRUE を返します。
次のような値は空であるとみなされます。
NULLFALSE
| バージョン | 説明 |
|---|---|
| 5.5.0 |
empty() が、変数だけではなく式にも対応するようになりました。 variables. |
| 5.4.0 |
文字列のオフセットに非数値を指定した場合は |
| 5.0.0 |
プロパティがないオブジェクトが空だとみなされないようになりました。 |
例1 簡単な empty() / isset() の比較
<?php
$var = 0;
// $var が空なのでtrueと評価されます
if (empty($var)) {
echo '$var is either 0, empty, or not set at all';
}
// $var が設定されているのでtrueと評価されます
if (isset($var)) {
echo '$var is set even though it is empty';
}
?>
例2 文字列のオフセットに対する empty()
PHP 5.4 以降では、文字列内でのオフセット指定を渡したときの empty() の挙動が変わりました。
<?php
$expected_array_got_string = 'somestring';
var_dump(empty($expected_array_got_string['some_key']));
var_dump(empty($expected_array_got_string[0]));
var_dump(empty($expected_array_got_string['0']));
var_dump(empty($expected_array_got_string[0.5]));
var_dump(empty($expected_array_got_string['0.5']));
var_dump(empty($expected_array_got_string['0 Mostel']));
?>
上の例の PHP 5.3 での出力は、このようになります。
bool(false) bool(false) bool(false) bool(false) bool(false) bool(false)
上の例の PHP 5.4 での出力は、このようになります。
bool(true) bool(false) bool(false) bool(false) bool(true) bool(true)