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);
?>

Exemple de fonctionnement

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.

  • true
  • false - par défaut

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);
?>

Exemple de fonctionnement