array_search
(PHP 4 >= 4.0.5, PHP 5)
array_search — Recherche dans un tableau la clé associée à une valeur
Description
Recherche needle
dans haystack
.
Liste de paramètres
-
needle
-
La valeur à chercher.
Note:
Si
needle
est une chaîne de caractères, la comparaison est effectuée en respectant la casse. -
haystack
-
Le tableau.
-
strict
-
Si le troisième paramètre
strict
vautTRUE
, alors array_search() cherchera des éléments identiques danshaystack
. Cela signifie que cette fonction s'assurera aussi que le type deneedle
est le même que celui de la valeur trouvée danshaystack
, et que les objets proviennent de la même instance.
Valeurs de retour
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
. Veuillez lire la section sur
les booléens pour plus d'informations.
Utilisez l'opérateur ===
pour tester la valeur de retour exacte de cette fonction.
Historique
Version | Description |
---|---|
5.3.0 |
Comme toutes les fonctions internes de PHP depuis 5.3.0,
la fonction array_search() retournera NULL
si des paramètres invalides sont passés à la fonction.
|
4.2.0 |
Avant la version 4.2.0, array_search() retourne NULL
en cas d'échec au lieu de FALSE .
|
Exemples
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; ?>
Voir aussi
- array_keys() - Retourne toutes les clés ou un ensemble des clés d'un tableau
- array_values() - Retourne toutes les valeurs d'un tableau
- array_key_exists() - Vérifie si une clé existe dans un tableau
- in_array() - Indique si une valeur appartient à un tableau