(PHP 4 >= 4.0.5, PHP 5)
array_search — Recherche dans un tableau la clé associée à une valeur
Recherche needle dans haystack .
La valeur à chercher.
Note: Si needle est une chaîne de caractères, la comparaison est effectuée en respectant la casse.
Le tableau.
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 .
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 search_value.
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.
| Version | Description |
|---|---|
| 4.2.0 | Avant la version 4.2.0, array_search() retourne NULL en cas d'échec au lieu de FALSE. |
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;
?>