isset

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

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

說(shuō)明

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

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

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

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

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

參數(shù)

var

要檢查的變量。

vars

其他變量。

返回值

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

范例

示例 #1 isset() 例子

<?php

$var = '';

// 結(jié)果為 TRUE，所以后邊的文本將被打印出來(lái)。
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

?>

這對(duì)于數(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，所以被認(rèn)為是未置值的。
// 如果想檢測(cè) 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']));
?>

以上例程會(huì)輸出：

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

注釋

警告

isset() 只能用于變量，因?yàn)閭鬟f任何其它參數(shù)都將造成解析錯(cuò)誤。若想檢測(cè)常量是否已設(shè)置，可使用 defined() 函數(shù)。

注意: 因?yàn)槭且粋€(gè)語(yǔ)言構(gòu)造器而不是一個(gè)函數(shù)，不能被 可變函數(shù) 調(diào)用。

注意:

如果使用 isset() 來(lái)檢查對(duì)象無(wú)法訪問(wèn)的屬性，如果 __isset() 方法已經(jīng)定義則會(huì)調(diào)用這個(gè)重載方法。

參見