Fonction array_search()

❮ Référence PHP Array

Exemple

Recherchez la valeur "rouge" dans un tableau et retournez sa clé :

<?php
$a=array("a"=>"rouge","b"=>"vert","c"=>"bleu");
echo array_search("rouge",$a);
?>
Essayez-le vous-même »

Définition et Utilisation

La fonction array_search() recherche une valeur dans un tableau et retourne la clé correspondante.


Syntaxe

array_search( valeur, tableau, strict )

Valeurs des Paramètres

Paramètre Description
valeur Requis. Spécifie la valeur à rechercher.
tableau Requis. Spécifie le tableau dans lequel effectuer la recherche.
strict Optionnel. Si ce paramètre est défini sur TRUE, la fonction recherchera des éléments identiques dans le tableau. Valeurs possibles :
  • true
  • false - Par défaut
Lorsqu'il est défini sur true, le nombre 5 n'est pas considéré comme identique à la chaîne "5" (voir exemple 2).


Détails Techniques

Valeur de Retour : Retourne la clé d'une valeur si elle est trouvée dans le tableau, et FALSE sinon. Si la valeur est trouvée plusieurs fois, la première clé correspondante est retournée.
Version PHP : 4.0.5+
Journal des Modifications PHP : Cette fonction retourne NULL si des paramètres invalides lui sont passés (cela s'applique à toutes les fonctions PHP à partir de 5.3.0).

À partir de PHP 4.2.0, cette fonction retourne FALSE en cas d'échec au lieu de NULL.

Plus d'Exemples

Exemple

Recherchez la valeur 5 dans un tableau et retournez sa clé (remarquez les "") :

<?php
$a=array("a"=>"5","b"=>5,"c"=>"5");
echo array_search(5,$a,true);
?>
Essayez-le vous-même »

❮ Référence PHP Array