empty

(PHP 4, PHP 5, PHP 7, PHP 8)

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

説明

empty(mixed $var): bool

変数が空であるかどうかを検査します。変数が空であるとみなされるのは、変数が存在しない場合や変数の値が false に等しい場合です。 empty() は、変数が存在しない場合でも警告を発生させません。このことは、多次元配列やチェインされたプロパティのような、ネストされたデータ構造であっても当てはまります。

パラメータ

var

チェックする変数

変数が存在しなくても警告は発生しません。つまり、empty() は本質的に !isset($var) || $var == false と同じことを簡潔に記述しているだけです。

戻り値

var が存在しない、または空や0の値が設定されている場合、つまり boolean のコンテキストで false と見なされる場合、 true を返します。詳細は boolean への変換を参照ください。それ以外の場合は false を返します。

例

例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
$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 Mostel']));
?>

上の例の出力は以下となります。

bool(true)
bool(false)
bool(false)
bool(true)
bool(true)

例3 多次元配列に対する empty()

<?php
$multidimensional = [
    'some' => [
        'deep' => [
            'nested' => 'value'
        ]
    ]
];

if (!empty($multidimensional['some']['some']['nested'])) {
    $someVariable = $multidimensional['some']['deep']['nested'];
}

var_dump(empty($multidimensional['some-undefined-key']));
var_dump(empty($multidimensional['some']['deep']['unknown']));
var_dump(empty($multidimensional['some']['deep']['nested']));
?>

上の例の出力は以下となります。

bool(true)
bool(true)
bool(false)

注意

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

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

参考

isset() - 変数が宣言されていること、そして null とは異なることを検査する
__isset()
unset() - 指定した変数の割当を解除する
array_key_exists() - 指定したキーまたは添字が配列にあるかどうかを調べる
count() - 配列または Countable オブジェクトに含まれるすべての要素の数を数える
strlen() - 文字列の長さを得る
PHP 型の比較表