(PHP 4, PHP 5, PHP 7, PHP 8)
empty — Проверяет, пуста ли переменная
Проверяет, считается ли переменная пустой. Переменная считается пустой, если она не существует или её значение равно false
.
empty() не генерирует предупреждение, если переменная не существует.
var
Проверяемая переменная
Если переменная не существует, предупреждение не генерируется. Это значит, что empty() фактически является точным эквивалентом конструкции !isset($var) || $var == false
Возвращает true
, если параметр var
не существует, если значение равно нулю, либо не задано,
смотрите Преобразование в булев тип.
В противном случае возвращает false
.
Пример #1 Простое сравнение empty() и isset().
<?php
$var = 0;
// Принимает значение true, потому что $var пусто
if (empty($var)) {
echo '$var или 0, или пусто, или вообще не определена';
}
// Принимает значение true, потому что $var определена
if (isset($var)) {
echo '$var определена, даже если она пустая';
}
?>
Пример #2 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']));
?>
Результат выполнения данного примера:
bool(true) bool(false) bool(false) bool(false) bool(true) bool(true)
Замечание: Поскольку это языковая конструкция, а не функция, она не может вызываться при помощи переменных функций или именованных аргументов.
Замечание:
При использовании функции empty() на недоступных (необъявленных) свойствах объекта будет вызван встроенный метод объекта __isset(), если он определён.