Fonction array_search() de PHP
Exemple
Recherche de la valeur clé "red" dans le tableau et retourne son nom de clé :
<?php $a=array("a"=>"red","b"=>"green","c"=>"blue"); echo array_search("red",$a); ?>
Définition et utilisation
La fonction array_search() recherche une valeur clé dans un tableau et retourne le nom de la clé correspondante.
Explication détaillée
La fonction array_search() et in_array() Comme dans un tableau, chercher une valeur clé. Si la valeur est trouvée, le nom de la clé de l'élément correspondant sera retourné. Si elle n'est pas trouvée, retourne false.
Avant PHP 4.2.0, la fonction retourne null au lieu de false en cas d'échec.
Si le troisième paramètre strict S'il est spécifié à true, la fonction retourne le nom de la clé correspondante uniquement si la valeur et le type de données sont tous deux identiques.
Syntaxe
array_search(value,array,strict)
Paramètres | Description |
---|---|
value | Requis. Définir la valeur clé à rechercher. |
array | Requis. Définir l'array à rechercher. |
strict |
Optionnel. Si ce paramètre est configuré à TRUE, la fonction recherche des éléments dans le tableau qui ont la même valeur et le même type de données.
Si configuré à true, la fonction vérifie le type de la valeur donnée dans le tableau, le nombre 5 et la chaîne 5 sont différents (voir l'exemple 2). |
Détails techniques
Valeur de retour : |
Si une valeur clé spécifiée est trouvée dans le tableau, la fonction retourne le nom de la clé correspondant, sinon elle retourne FALSE. Si une valeur clé est trouvée plusieurs fois dans le tableau, la fonction retourne le nom de la clé correspondant à la première valeur trouvée. |
Version PHP : | 4.0.5+ |
Journal des mises à jour : |
Si des paramètres invalides sont passés à la fonction, elle retourne NULL (cela s'applique à toutes les fonctions PHP à partir de PHP 5.3.0). Depuis PHP 4.2.0, si la recherche échoue, la fonction retourne FALSE au lieu de NULL. |
Plus d'exemples
Exemple 1
Recherchez la valeur 5 dans le tableau et retournez le nom de la clé (attention ""):
<?php $a=array("a"=>"5","b"=>5,"c"=>"5"); echo array_search(5,$a,true); ?>