Manuel PHP
Précédent |  | Suivant

# array_search

(PHP 4 >= 4.0.5, PHP 5)

array_search -- Recherche dans un tableau la clé associée à une valeur

## Description

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

array_search() recherche needle dans haystack et retourne la clé associée s'il la trouve, ou `FALSE` sinon.

> Note : Si needle est une chaîne de caractères, la comparaison est effectuée du manière sensible à la casse.

> Note : Avant PHP 4.2.0, array_search() retournait `NULL` en cas d'échec, au lieu de `FALSE`.

Si le troisième paramètre strict vaut `TRUE`, alors array_search() s'assurera aussi que le type de needle est le même que celui de la valeur trouvée dans haystack.

Si needle est trouvé plus d'une fois dans haystack, la première clé concordante est retournée. Pour trouver toutes les clefs correspondantes, utilisez plutôt la fonction array_keys() avec le paramètre optionnel search_value.

Exemple 1. Exemple avec array_search()
`<?php $array = array(0 => "bleu", 1 => "rouge", 2 => "vert", 3 => "rouge"); $key = array_search('vert', $array); // $key = 2; $key = array_search('rouge', $array); // $key = 1; ?>`

Avertissement
Cette fonction peut retourner `FALSE`, mais elle peut aussi retourner une valeur équivalent à `FALSE`, utilisable dans une condition if simple. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

Voir aussi array_keys(), array_values(), array_key_exists() et in_array().

Précédent | Sommaire | Suivant
array_reverse | Niveau supérieur | array_shift