array_search

Table des matières

(PHP 4 >= 4.0.5, PHP 5, PHP 7)

array_search — Recherche dans un tableau la clé associée à la première valeur

Description

mixed array_search ( mixed $needle , array $haystack [, bool $strict = FALSE ] )

Recherche needle dans haystack.

Liste de paramètres

needle: La valeur à chercher.

Note:
Si needle est 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 strict vaut TRUE, alors array_search() cherchera des éléments identiques dans haystack. Cela signifie que cette fonction va effectuer une comparaison stricte du type de needle dans haystack, 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.

Avertissement

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

Rechercher une fonction PHP

Version en cache

21/11/2024 15:08:10 Cette version de la page est en cache (à la date du 21/11/2024 15:08:10) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.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

Manuel PHP : http://php.net

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.

Table des matières Haut