8.3 Tableaux
8 Référence des fonctions
Manuel PHP
. Introduction . Pré-requis . Installation . Configuration à l'exécution . Types de ressources . Constantes pré-définies . Voir aussi . array_change_key_case . array_chunk . array_combine . array_count_values . array_diff_assoc . array_diff_key . array_diff_uassoc . array_diff_ukey . array_diff . array_fill . array_filter . array_flip . array_intersect_assoc . array_intersect_key . array_intersect_uassoc . array_intersect_ukey . array_intersect . array_key_exists . array_keys . array_map . array_merge_recursive . array_merge . array_multisort . array_pad . array_pop . array_product . array_push . array_rand . array_reduce . array_reverse ->array_search . array_shift . array_slice . array_splice . array_sum . array_udiff_assoc . array_udiff_uassoc . array_udiff . array_uintersect_assoc . array_uintersect_uassoc . array_uintersect . array_unique . array_unshift . array_values . array_walk_recursive . array_walk . array . arsort . asort . compact . count . current . each . end . extract . in_array . key . krsort . ksort . list . natcasesort . natsort . next . pos . prev . range . reset . rsort . shuffle . sizeof . sort . uasort . uksort . usort
|
8.3.38 array_search()
Recherche dans un tableau la clé associée à une valeur
[ Exemples avec array_search ] PHP 4 >= 4.0.5, PHP 5
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 clés correspondantes, utilisez plutôt
la fonction
array_keys
avec le paramètre optionnel
search_value
.
| 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; ?>
|
| Attention | |
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
.
|