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