array_search
(PHP 4 >= 4.0.5, PHP 5, PHP 7)
array_search — Recherche dans un tableau la clé associée à la première valeur
Description
Recherche needle
dans haystack.
Liste de paramètres
-
needle -
La valeur à chercher.
Note:
Si
needleest 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
strictvautTRUE, alors array_search() cherchera des éléments identiques danshaystack. Cela signifie que cette fonction va effectuer une comparaison stricte du type deneedledanshaystack, 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.
|
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
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-array-search.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
