empty

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

empty檢查一個變量是否為空

說明

empty(mixed $var): bool

判斷一個變量是否被認為是空的。當(dāng)一個變量并不存在,或者它的值等同于false,那么它會被認為不存在。如果變量不存在的話,empty()并不會產(chǎn)生警告。

參數(shù)

var

待檢查的變量

注意:

在 PHP 5.5 之前,empty() 僅支持變量;任何其他東西將會導(dǎo)致一個解析錯誤。換言之,下列代碼不會生效: empty(trim($name))。 作為替代,應(yīng)該使用trim($name) == false.

沒有警告會產(chǎn)生,哪怕變量并不存在。 這意味著 empty() 本質(zhì)上與 !isset($var) || $var == false 等價。

返回值

當(dāng)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ù)字的字符串偏移量會返回 true.

范例

示例 #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 修改了當(dāng)傳入的是字符串偏移量時, 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)用。

注意:

當(dāng)對一個不可見的對象屬性使用 empty() 時, __isset() 方法如果存在的話,它將會被調(diào)用。

參見