array_search() recherche needle
dans haystack
et retourne la clé
associée s'il la trouve, ou FALSE sinon.
Note : Si
needle
est une chaîne de caractères, la comparaison est effectuée en respectant la casse.
Note : Avant PHP 4.2.0, array_search() retournait NULL en cas d'échec, au lieu de FALSE.
Si le troisième paramètre strict
vaut
TRUE, alors array_search()
s'assurera aussi que le type de needle
est le même que celui de la valeur trouvée dans haystack
.
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
search_value
.
Avertissement |
Cette fonction peut retourner FALSE, mais elle peut aussi retourner une valeur équivalent à FALSE, utilisable dans une condition if simple. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction. |
Voir aussi array_keys(), array_values(), array_key_exists() et in_array().
Précédent | Sommaire | Suivant |
array_reverse | Niveau supérieur | array_shift |