(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
array_search — Recherche dans un tableau la première clé associée à la valeur
Recherche needle
dans haystack
.
needle
La valeur à chercher.
Note:
Si
needle
est une chaîne de caractères, la comparaison est effectuée en respectant la casse.
haystack
Le tableau.
strict
Si le troisième paramètre strict
vaut true
, alors array_search() cherchera des éléments identiques dans haystack
. Cela signifie que cette fonction va effectuer une comparaison stricte du type de needle
dans haystack
, et que les objets proviennent de la même instance.
Retourne la clé pour needle
si elle est trouvée dans le tableau, false
sinon.
Si needle
est trouvé plus d'une fois dans haystack
, la première clé concordante est retournée. Pour trouver toutes les clés correspondantes, utilisez plutôt la fonction array_keys() avec le paramètre optionnel filter_value
.
Cette fonction peut retourner false
, mais elle peut aussi retourner une valeur équivalent à false
. Veuillez lire la section sur les booléens pour plus d'informations. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.
Exemple #1 Exemple avec array_search()
<?php
$array = array(0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red');
$key = array_search('green', $array); // $key = 2;
$key = array_search('red', $array); // $key = 1;
?>