Prüft, ob ein Schlüssel in einem Array existiert

Beschreibung

bool array_key_exists ( mixed $key , array $search )

array_key_exists() gibt TRUE zurück, wenn key in dem Array vorhanden ist. key kann jeder für einen Array-Index mögliche Wert sein.

Parameter-Liste

key: Der zu prüfende Wert.
search: Ein Array mit den zu prüfenden Schlüsseln.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Changelog

Version	Beschreibung
5.3.0	Diese Funktion arbeitet nicht mehr mit Objekten. property_exists() sollte in diesem Fall genutzt werden.

Beispiele

Beispiel #1 array_key_exists()-Beispiel


<?php
$search_array = array('erstes' => 1, 'zweites' => 4);
if (array_key_exists('erstes', $search_array)) {
    echo "Das Element 'erstes' ist in dem Array vorhanden";
}
?>

Beispiel #2 array_key_exists() vs. isset()

isset() gibt nicht TRUE zurück für Schlüssel eines Arrays, die zu einem NULL-Wert gehören, array_key_exists() tut dies hingegen.


<?php
$search_array = array('erstes' => null, 'zweites' => 4);

// Gibt false zurück
isset($search_array['erstes']);

// Gibt true zurück
array_key_exists('erstes', $search_array);
?>

Anmerkungen

Hinweis:
Für die Abwärtskompatibiliät kann der folgende veraltete Alias verwendet werden: key_exists()

Siehe auch

isset() - Prüft, ob eine Variable existiert und ob sie nicht NULL ist
array_keys() - Liefert alle Schlüssel oder eine Teilmenge aller Schlüssel eines Arrays
in_array() - Prüft, ob ein Wert in einem Array existiert
property_exists() - Prüft auf die Existenz einer Eigenschaft eines Objektes bzw. einer Klasse