無料CGI、PHPサイト(確認画面付きメールフォーム・メーリングリスト・メルマガ設置、逆アクセスランキング、画像カウンター等)PHPマニュアル by k-sky

empty

(PHP 4, PHP 5)

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

説明

bool empty ( mixed $var )

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

パラメータ

var

チェックする変数

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

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

返り値

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

次のような値は空であると考えられます。:

  • "" (空文字列)
  • 0 (0 は整数)
  • "0" (0は文字列)
  • NULL
  • FALSE
  • array() (空の配列)
  • var $var;(変数が宣言されているが、クラスの中で値が設定されていない)

変更履歴

バージョン 説明
PHP 5

PHP5では、プロパティがないオブジェクトは空でないと見なされます。

PHP 4

PHP 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';
}
?>

注意

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