PHP array_search()Fonctions
Manuel de référence complet des tableaux PHP
Exemples
Rechercher dans le tableau la valeur "red" et renvoyer sa clé :
<?php
$a=array("a"=>"red","b"=>"green","c"=>"bleu");
echo array_search("red",$a);
?>
$a=array("a"=>"red","b"=>"green","c"=>"bleu");
echo array_search("red",$a);
?>
Exécuter l'exemple »
Définition et utilisation
La fonction array_search() est utilisée pour rechercher une valeur dans un tableau et renvoyer le nom de clé correspondant. Si la valeur n'est pas trouvée, elle renvoie false.
Syntaxe
array_search(mixed $needle, array $haystack, bool $strict = false): int|string|false
| Paramètre | Description |
|---|---|
| $needle | Obligatoire. Spécifie la valeur de clé à rechercher dans le tableau. |
| $haystack | Obligatoire. Spécifie le tableau à rechercher. |
| $strict | Facultatif. La valeur par défaut est false. Compare uniquement les valeurs, pas les types. Si ce paramètre est défini sur TRUE, la fonction recherche dans le tableau les éléments dont le type de données et la valeur sont tous deux identiques. Valeurs possibles :
|
Détails techniques
| Valeur de retour : | Si la valeur de clé spécifiée est trouvée dans le tableau, le nom de clé correspondant est renvoyé ; sinon, FALSE est renvoyé. Si la valeur de clé est trouvée plus d'une fois dans le tableau, le nom de clé correspondant à la première valeur de clé trouvée est renvoyé. |
|---|---|
| Version de PHP : | 4.0.5+ |
| Journal des modifications : | Si un paramètre non valide est passé à la fonction, la fonction renvoie NULL (ceci s'applique à toutes les fonctions PHP depuis PHP 5.3.0). Depuis PHP 4.2.0, si la recherche échoue, la fonction renvoie FALSE au lieu de NULL. |
Plus d’exemples
Exemples
<?php
$numbers = array(1, "2", 3);
$key = array_search(2, $numbers); // Le mode strict n'est pas activé, renvoie le nom de la clé 1
$key_strict = array_search(2, $numbers, true); // Le mode strict est activé, renvoie false
?>
$numbers = array(1, "2", 3);
$key = array_search(2, $numbers); // Le mode strict n'est pas activé, renvoie le nom de la clé 1
$key_strict = array_search(2, $numbers, true); // Le mode strict est activé, renvoie false
?>
Exemple 1
Recherchez dans le tableau la valeur 5 et renvoyez son nom de clé (note "") :
<?php
$a=array("a" => "5", "b" => 5, "c" => "5");
echo array_search(5,$a,true);
?>
$a=array("a" => "5", "b" => 5, "c" => "5");
echo array_search(5,$a,true);
?>
Exécuter l'exemple »
Manuel de référence complet des tableaux PHP Autres extensions