empty

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

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

Описание

empty(mixed $var): bool

Проверяет, считается ли переменная пустой. Переменная считается пустой, если она не существует или её значение равно 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(), если он определён.

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

  • isset() - Определяет, была ли установлена переменная значением, отличным от null
  • __isset()
  • unset() - Удаляет переменную
  • array_key_exists() - Проверяет, присутствует ли в массиве указанный ключ или индекс
  • count() - Подсчитывает количество элементов массива или Countable объекте
  • strlen() - Возвращает длину строки
  • Таблица сравнения типов