(PHP 4, PHP 5)
empty — 変数が空であるかどうかを検査する
var
チェックする変数
注意:
empty() は、変数のみをチェックし、それ以外の値を チェックすると文法エラーを生成します。つまり、次の例は動作しません: empty(trim($name)).
empty()は、変数が設定されていないときに警告が生成 されないことを除けば、(boolean) var の逆です。
var
が空でないか、0でない値であれば FALSE
を返します。
次のような値は空であるとみなされます。
NULL
FALSE
バージョン | 説明 |
---|---|
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)