PHP Manualen
forrige |  | næste

# array_search

(PHP 4 >= 4.0.5, PHP 5)

array_search -- Søger arrayet igennem for en given værdi og returnerer den tilhørende nøgle.

## Beskrivelse

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

Søger haystack igennem for needle og returnerer nøglen hvis den blev fundet i array, ellers bliver `FALSE` returneret.

> Bemærk: Hvis needle er en streng, vil sammenligningen tage forbehold for store og små bogstaver.

> Bemærk: Før PHP 4.2.0, returnerede array_search() `NULL` hvis det ikke lykkedes, i stedet for `FALSE`.

Hvis den valgfrie tredje parameter strict er sat til `TRUE` vil array_search() også tjekke typerne på needle i haystack.

Hvis needle bliver fundet mere end en gang i haystack vil det første fundne nøgle blive returneret. For at få alle nøgler fra fundne værdier, bruges array_keys() med den valgfrie search_value parameter i stedet.

Eksempel 1. array_search() eksempel

`<?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; ?>`

Advarsel
Denne funktion returnerer muligvis en Boolean `FALSE`, men kan også returnere en ikke-Booleansk værdi som evalueres til `FALSE`, så som 0 eller "". Læs venligst sektionen om Booleans for mere information. brug === operatoren for at teste den værdi som returneres af denne funktion.

Se også array_keys(), array_values(), array_key_exists() og in_array().

forrige | hjem | næste
array_reverse | op | array_shift