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

# array_key_exists

(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)

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

### Beschreibung

function array_key_exists(string|int|float|bool|resource|null `$key`, array `$array`): bool

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

### Parameter-Liste

`key`

  Der zu prüfende Wert.

`array`

  Ein Array mit den zu prüfenden Schlüsseln.

### Rückgabewerte

Gibt bei Erfolg `true` zurück. Bei einem Fehler wird `false` zurückgegeben.

> Hinweis:

> array_key_exists() sucht nur in der ersten Dimension nach Schlüsseln. Verschachtelte Schlüssel in mehrdimensionalen Arrays werden nicht gesucht.

### Changelog

Version | Beschreibung
--- | ---
8.5.0 | Die Verwendung von null im Parameter `key` ist veraltet; stattdessen sollte ein leerer String verwendet werden.
8.0.0 | Der Parameter `key` akzeptiert nun Werte vom Typ bool, float, int, null, resource und string als Argumente.
8.0.0 | Die Übergabe eines objects an den Parameter `array` wird nicht mehr unterstützt.
7.4.0 | Die Übergabe eines objects an den Parameter `array` ist veraltet. Stattdessen sollte property_exists() verwendet werden.

### Beispiele

Beispiel #1 array_key_exists()-Beispiel

    <?php
    $searchArray = ['erstes' => 1, 'zweites' => 4];
    var_dump(array_key_exists('erstes', $searchArray));
    ?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    bool(true)

Beispiel #2 array_key_exists() vs. isset()

isset() gibt für Schlüssel eines Arrays, die zu einem `null`-Wert gehören, nicht `true` zurück, während array_key_exists() dies tut.

    <?php
    $searchArray = ['erstes' => null, 'zweites' => 4];

    var_dump(isset($searchArray['erstes']));
    var_dump(array_key_exists('erstes', $searchArray));
    ?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    bool(false)
    bool(true)

### Siehe auch

- isset() - Prüft, ob eine Variable deklariert ist und sich von null unterscheidet
- 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, ein Objekt oder eine Klasse auf die angegebene Eigenschaft

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open