Récupère la première clé d'un tableau

# array_key_first

(PHP 7 >= 7.3.0, PHP 8)

array_key_first — Récupère la première clé d'un tableau

### Description

function array_key_first(array `$array`): int|string|null

Récupère la première clé du tableau `array` donné sans affecter le pointeur interne du tableau.

### Liste de paramètres

`array`

  Un tableau.

### Valeurs de retour

Retourne la première clé de `array` si le tableau n'est pas vide ; `null` sinon.

### Exemples

Exemple #1 Usage simple de array_key_first()

    <?php
    $array = ['a' => 1, 'b' => 2, 'c' => 3];

    $firstKey = array_key_first($array);

    var_dump($firstKey);
    ?>

L'exemple ci-dessus va afficher :

    string(1) "a"

### Notes

Astuce

Il y a plusieurs façons de fournir cette fonctionnalité pour les versions antérieures à PHP 7.3.0. Il est possible d'utiliser array_keys(), mais ceci est plutôt inefficace. Il est aussi possible d'utiliser reset() et key(), mais ceci peut changer le pointeur interne du tableau. Une solution efficace, qui ne modifie pas le pointeur interne du tableau, écrit comme un polyfill :

    <?php
    if (!function_exists('array_key_first')) {
        function array_key_first(array $arr) {
            foreach($arr as $key => $unused) {
                return $key;
            }
            return NULL;
        }
    }
    ?>

### Voir aussi

- array_first() - Renvoie la première valeur d'un tableau
- array_key_last() - Récupère la dernière clé d'un tableau
- reset() - Remet le pointeur interne de tableau au début

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