array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.empty.php', 1 => 'empty', 2 => 'Prüft, ob eine Variable leer ist', ), 'up' => array ( 0 => 'ref.var.php', 1 => 'Funktionen zur Behandlung von Variablen', ), 'prev' => array ( 0 => 'function.doubleval.php', 1 => 'doubleval', ), 'next' => array ( 0 => 'function.floatval.php', 1 => 'floatval', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', '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 — Prüft, ob eine Variable leer ist

Beschreibung

empty(mixed $var): bool

Prüft, ob eine Variable leer ist. Eine Variable ist leer, wenn sie nicht existiert oder wenn ihr Wert gleich false ist. empty() erzeugt keine Warnung, wenn die Variable nicht existiert.

Parameter-Liste

var

Die zu prüfende Variable.

Es wird keine Warnung erzeugt, wenn die Variable nicht existiert. Das bedeutet, dass empty() im Wesentlichen das kurzgefasste Äquivalent zu !isset($var) || $var == false ist. Dies gilt auch für verschachtelte Strukturen, z. B. ein mehrdimensionales Array oder verkettete Eigenschaften.

Rückgabewerte

Gibt true zurück, wenn var nicht existiert oder einen Wert hat, der leer oder gleich Null ist, auch bekannt als "falsey". Siehe Umwandlung in boolean. Andernfalls wird false zurückgegeben.

Beispiele

Beispiel #1 Ein einfacher Vergleich von empty() / isset()

<?php
$var = 0;

// true, weil $var leer ist
if (empty($var)) {
echo '$var ist 0, nicht mit einem Wert belegt, oder nicht gesetzt';
}

// true, weil $var gesetzt wurde
if (isset($var)) {
echo '$var ist gesetzt, obwohl es leer ist';
}
?>

Beispiel #2 empty() und Zeichenketten-Offsets

<?php
$expected_array_got_string = 'einstring';
var_dump(empty($expected_array_got_string['ein_schluessel']));
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']));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

Beispiel #3 empty() bei mehrdimensionalen Arrays

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

Anmerkungen

Hinweis: Da dies ein Sprachkonstrukt und keine Funktion ist, können Sie dieses nicht mit Variablenfunktionen oder benannten Parametern verwenden.

Hinweis:

Bei Aufruf von empty() auf nicht öffentliche Objekteigenschaften wird die überladene Methode __isset() aufgerufen, falls deklariert.

Siehe auch