array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.empty.php', 1 => 'empty', 2 => 'Determina si una variable está vacía', ), 'up' => array ( 0 => 'ref.var.php', 1 => 'Funciones de manejo de variables', ), 'prev' => array ( 0 => 'function.doubleval.php', 1 => 'doubleval', ), 'next' => array ( 0 => 'function.floatval.php', 1 => 'floatval', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', '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 — Determina si una variable está vacía

Descripción

empty(mixed $var): bool

Determina si una variable es considerada vacía. Una variable es considerada vacía si no existe, o si su valor equivale a false. La función empty() no genera ninguna alerta si la variable no existe.

Parámetros

var

Variable a verificar.

Ninguna alerta es generada si la variable no existe. Esto significa que empty() es estrictamente equivalente a !isset($var) || $var == false. Esto se aplica asimismo a las estructuras anidadas, tales como un array multidimensional o propiedades encadenadas.

Valores devueltos

Retorna true si var no existe o tiene un valor vacío o igual a cero, es decir, que es considerada "false", ver conversión en bool. De lo contrario retorna false.

Ejemplos

Ejemplo #1 Una comparación simple empty() / isset().

<?php
$var = 0;

// Evaluada como verdadera ya que $var está vacía
if (empty($var)) {
echo '$var vale 0, está vacía, o no está definida en absoluto';
}

// Evaluada como verdadera ya que $var está definida
if (isset($var)) {
echo '$var está definida incluso si está vacía';
}
?>

Ejemplo #2 empty() sobre posiciones en un string

<?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']));
?>

El ejemplo anterior mostrará:

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

Ejemplo #3 empty() sobre arrays multidimensionales

<?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']));
?>

El ejemplo anterior mostrará:

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

Notas

Nota: Como esto es una estructura del lenguaje, y no una función, no es posible llamarla con las funciones variables o argumentos nombrados.

Nota:

Al utilizar esta función sobre propiedades de objeto inaccesibles, el método mágico __isset() será llamado, si existe.

Ver también