変数操作 関数
PHP Manual

empty

(PHP 4, PHP 5)

empty変数が空であるかどうかを検査する

説明

bool empty ( mixed $var )

変数が空であるかどうかを検査する

パラメータ

var

チェックする変数

注意:

empty() は、変数のみをチェックし、それ以外の値を チェックすると文法エラーを生成します。つまり、次の例は動作しません: empty(trim($name)).

empty()は、変数が設定されていないときに警告が生成 されないことを除けば、(boolean) var の逆です。

返り値

varが空でないか、0でない値であれば FALSE を返します。

次のような値は空であるとみなされます。

変更履歴

バージョン 説明
5.4.0

文字列のオフセットに非数値を指定した場合は TRUE を返すようになりました。

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)

注意

注意: これは、関数ではなく 言語構造のため、可変関数 を用いて コールすることはできません。

注意:

オブジェクトのアクセス不能なプロパティに対して empty() を使用した場合は、もしオーバーロードメソッド __isset() が宣言されていればそれをコールします。

参考


変数操作 関数
PHP Manual