empty
(PHP 4, PHP 5, PHP 7)
empty — 変数が空であるかどうかを検査する
説明
変数が空であるかどうかを検査します。
変数が空であるとみなされるのは、変数が存在しない場合や
変数の値が FALSE に等しい場合です。
empty() は、変数が存在しない場合でも警告を発しません。
パラメータ
-
var -
チェックする変数
注意:
PHP 5.5 より前のバージョンでは、empty() がサポートするのは変数だけです。 それ以外の値をチェックするとパースエラーになります。つまり、 empty(trim($name)) は動作しません。かわりに trim($name) == false を使います。
変数が存在しなくても警告は発生しません。 つまり、empty() は本質的に !isset($var) || $var == false と同じことを簡潔に記述しているだけです。
返り値
var が存在し、かつその値が空や0でなければ FALSE を返します。
それ以外の場合は TRUE を返します。
次のような値は空であるとみなされます。
- "" (空文字列)
- 0 (整数 の 0)
- 0.0 (浮動小数点数の 0)
- "0" (文字列 の 0)
NULLFALSE- array() (空の配列)
- $var; (変数が宣言されているが、値が設定されていない)
変更履歴
| バージョン | 説明 |
|---|---|
| 5.5.0 |
empty() が、変数だけではなく式にも対応するようになりました。 variables. |
| 5.4.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)
忘却曲線を使ってこの関数を確実に記憶に残す
