isset

(PHP 4, PHP 5)

isset — 変数がセットされていること、そして NULL でないことを検査する

説明

bool isset ( mixed $var [, mixed $var [, $... ]] )

変数がセットされており、それが NULL でないことを調べます。

変数が、unset() により割当を解除された場合、何も値が設定されていない状態になります。 NULLに設定されている変数を調べた場合、 isset() はFALSEを返します。 NULLバイト("\0")はPHPの定数 NULLと等価ではないことにも注意してください。

複数のパラメータを渡した場合は、isset() はそれらすべてがセットされている場合にのみ TRUE を返します。左から順に評価を行い、セットされていない変数があった時点で処理を終了します。

パラメータ

var: 調べたい変数。
var: 別の変数。
...

返り値

var が存在して NULL 以外の値をとれば TRUE、そうでなければ FALSE を返します。

例

例1 isset() の例


<?php

$var = '';

// これは TRUE と評価されるので、テキストが出力される
if (isset($var)) {
    echo "This var is set so I will print.";
}

// 次の例では、isset() の戻り値を出力するため var_dump を
// 使用している

$a = "test";
$b = "anothertest";

var_dump(isset($a));      // TRUE
var_dump(isset($a, $b)); // TRUE

unset ($a);

var_dump(isset($a));     // FALSE
var_dump(isset($a, $b)); // FALSE

$foo = NULL;
var_dump(isset($foo));   // FALSE

?>

この関数は配列の要素に対しても動作します:


<?php

$a = array ('test' => 1, 'hello' => NULL);

var_dump(isset($a['test']));            // TRUE
var_dump(isset($a['foo']));             // FALSE
var_dump(isset($a['hello']));           // FALSE

// キー 'hello' は NULL と等しいのでセットされていないと見なされる。
// もし NULL なキー値に対してチェックを行いたい場合、次を試してみること:
var_dump(array_key_exists('hello', $a)); // TRUE

?>

注意

警告

isset() は何らかの値が渡された変数の場合のみ動作します。そうでない場合、パースエラーとなります。もし定数が設定されているかどうかをチェックする場合は、 defined() を使用してください。

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

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

参考

empty() - 変数が空であるかどうかを検査する
__isset
unset() - 指定した変数の割当を解除する
defined() - 指定した名前の定数が存在するかどうかを調べる
PHP 型の比較表
array_key_exists() - 指定したキーまたは添字が配列にあるかどうかを調べる
is_null() - 変数が NULL かどうか調べる
エラー制御演算子 @