array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.empty.php', 1 => 'empty', 2 => 'Проверяет, пуста ли переменная', ), 'up' => array ( 0 => 'ref.var.php', 1 => 'Функции обработки переменных', ), 'prev' => array ( 0 => 'function.doubleval.php', 1 => 'doubleval', ), 'next' => array ( 0 => 'function.floatval.php', 1 => 'floatval', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/var/functions/empty.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

empty

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

empty — Проверяет, пуста ли переменная

Описание

empty(mixed $var): bool

Языковая конструкция проверяет, считает ли PHP переменную пустой. PHP считает переменную пустой, если она не существует или значение переменной равно 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 Mostel']));

?>

Результат выполнения приведённого примера: 

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

Пример #3 Пример поведения конструкции empty() на многомерных массивах

<?php

$multidimensional = [
'some' => [
'deep' => [
'nested' => 'value'
]
]
];

if (!empty($multidimensional['some']['some']['nested'])) {
$someVariable = $multidimensional['some']['deep']['nested'];
}

var_dump(empty($multidimensional['some-undefined-key']));
var_dump(empty($multidimensional['some']['deep']['unknown']));
var_dump(empty($multidimensional['some']['deep']['nested']));

?>

Результат выполнения приведённого примера: 

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

Примечания

Замечание: Конструкцию нельзя вызывать как функцию переменной или передавать как именованный аргумент, поскольку это языковая конструкция, а не функция.

Замечание:

При вызове языковой конструкции empty() на недоступных (необъявленных, защищённых или закрытых) свойствах объекта вызывается метод перегрузки — __isset(), если он определён.

Смотрите также