Description
mixed
array_search ( mixed needle, array haystack [, bool strict] )
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 du manière sensible à 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.
Exemple 1. Exemple avec array_search()
<?php
$array = array(0 => "bleu", 1 => "rouge", 2 => "vert", 3 => "rouge");
$key = array_search('vert', $array); // $key = 2;
$key = array_search('rouge', $array); // $key = 1;
?>
|
|
| 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().
