(PHP 4 >= 4.0.5, PHP 5)
array_search — Recherche dans un tableau la clé associée à une valeur
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 .
Exemple 418. 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;
?>
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() .