(PHP 4, PHP 5, PHP 7, PHP 8)
empty — 檢查一個變量是否為空
判斷一個變量是否被認為是空的。當一個變量并不存在,或者它的值等同于false
,那么它會被認為不存在。如果變量不存在的話,empty()并不會產(chǎn)生警告。
var
待檢查的變量
注意:
在 PHP 5.5 之前,empty() 僅支持變量;任何其他東西將會導致一個解析錯誤。換言之,下列代碼不會生效: empty(trim($name))。 作為替代,應該使用trim($name) == false.
沒有警告會產(chǎn)生,哪怕變量并不存在。 這意味著 empty() 本質(zhì)上與 !isset($var) || $var == false 等價。
當var
存在,并且是一個非空非零的值時返回 false
否則返回 true
.
以下的東西被認為是空的:
""
(空字符串)0
(作為整數(shù)的0)0.0
(作為浮點數(shù)的0)"0"
(作為字符串的0)null
false
array()
(一個空數(shù)組)$var;
(一個聲明了,但是沒有值的變量)
版本 | 說明 |
---|---|
5.5.0 |
empty() 現(xiàn)在支持表達式了,而不僅僅是變量。 |
5.4.0 |
檢查非數(shù)字的字符串偏移量會返回 |
示例 #1 一個簡單的 empty() 與 isset() 的比較。
<?php
$var = 0;
// Evaluates to true because $var is empty
if (empty($var)) {
echo '$var is either 0, empty, or not set at all';
}
// Evaluates as true because $var is set
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)
注意: 因為是一個語言構(gòu)造器而不是一個函數(shù),不能被 可變函數(shù) 調(diào)用。
注意:
當對一個不可見的對象屬性使用 empty() 時, __isset() 方法如果存在的話,它將會被調(diào)用。