isset

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

isset — 檢測變量是否已聲明并且其值不為 null

說明

isset(mixed $var, mixed ...$vars): bool

判斷一個變量是否已設(shè)置, 即變量已被聲明，且其值不為 null。

如果一個變量已經(jīng)被使用 unset() 釋放，它將不再被認為已設(shè)置。

若使用 isset() 測試一個被賦值為 null 的變量，將返回 false。 同時要注意的是 null 字符（"\0"）并不等同于 PHP 的 null 常量。

如果一次傳入多個參數(shù)，那么 isset() 只有在全部參數(shù)都已被設(shè)置時返回 true。 計算過程從左至右，中途遇到未設(shè)置的變量時就會立即停止。

參數(shù)

var

要檢查的變量。

vars

其他變量。

返回值

如果 var 存在并且值不是 null 則返回 true，否則返回 false。

范例

示例 #1 isset() 例子

<?php

$var = '';

// 結(jié)果為 TRUE，所以后邊的文本將被打印出來。
if (isset($var)) {
    echo "This var is set so I will print.";
}

// 在后邊的例子中，我們將使用 var_dump 輸出 isset() 的返回值。
// the return value of isset().

$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

?>

這對于數(shù)組中的元素也同樣有效：

<?php

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

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

// Checking deeper array values
var_dump(isset($a['pie']['a']));        // TRUE
var_dump(isset($a['pie']['b']));        // FALSE
var_dump(isset($a['cake']['a']['b']));  // FALSE

?>

示例 #2 在字符串位移中使用 isset()

<?php
$expected_array_got_string = 'somestring';
var_dump(isset($expected_array_got_string['some_key']));
var_dump(isset($expected_array_got_string[0]));
var_dump(isset($expected_array_got_string['0']));
var_dump(isset($expected_array_got_string[0.5]));
var_dump(isset($expected_array_got_string['0.5']));
var_dump(isset($expected_array_got_string['0 Mostel']));
?>

以上例程會輸出：

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

注釋

警告

isset() 只能用于變量，因為傳遞任何其它參數(shù)都將造成解析錯誤。若想檢測常量是否已設(shè)置，可使用 defined() 函數(shù)。

注意: 因為是一個語言構(gòu)造器而不是一個函數(shù)，不能被 可變函數(shù) 調(diào)用。

注意:

如果使用 isset() 來檢查對象無法訪問的屬性，如果 __isset() 方法已經(jīng)定義則會調(diào)用這個重載方法。

參見