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.5']));
var_dump(empty($expected_array_got_string['0 Mostel']));
?>

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

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

注意

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

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

参考

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

関連キーワード: 　変数, 検査, 空, var, isset, 存在, 注意, 関数, boolean, 宣言