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
Søger haystack igennem for needle og returnerer nøglen hvis den blev fundet i array, ellers bliver FALSE returneret.
Note: Hvis needle er en streng, vil sammenligningen tage forbehold for store og små bogstaver.
Note: 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.
Example#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;
?>
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().