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 clef 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