(PHP 4, PHP 5, PHP 7, PHP 8)
key — Retourne une clé d'un tableau associatif
$array): int|string|null
key() retourne la clé courante dans le
tableau array.
arrayLe tableau.
La fonction key() retourne simplement la clé
de l'élément du tableau qui est actuellement pointée par le pointeur
interne. Cette fonction ne modifie en aucun cas la position de ce pointeur.
Si le pointeur interne pointe un élément se situant après la fin de la liste
des éléments, ou bien si le tableau est vide, la fonction
key() retournera null.
| Version | Description |
|---|---|
| 8.1.0 | Appeler cette fonction sur les objets est obsolète. Utilisez soit get_mangled_object_vars() sur l'objet d'abord, ou utilisez ArrayIterator. |
Exemple #1 Exemple avec key()
<?php
$array = array(
'fruit1' => 'apple',
'fruit2' => 'orange',
'fruit3' => 'grape',
'fruit4' => 'apple',
'fruit5' => 'apple');
// Cette boucle affiche toutes les clés
// dont la valeur vaut "apple"
while ($fruit_name = current($array)) {
if ($fruit_name == 'apple') {
echo key($array), "\n";
}
next($array);
}
?>
L'exemple ci-dessus va afficher :
fruit1 fruit4 fruit5