PHP array_search() funktionen
Eksempel
Søg efter nøgleværdien "red" i arrayen og returner dens nøglenavn:
<?php $a=array("a"=>"red","b"=>"green","c"=>"blue"); echo array_search("red",$a); ?>
Definition og brug
array_search() funktionen søger efter en nøgleværdi i en array og returnerer det tilsvarende nøglenavn.
Detaljeret forklaring
array_search() funktionen sammen med in_array() Sådan, at finde en nøgleværdi i en array. Hvis værdien findes, returneres navnet på den matchende elements nøgle. Hvis den ikke findes, returneres false.
Før PHP 4.2.0 returnerede funktionen null i stedet for false, når den fejlede.
Hvis tredje parameter strict Ved at sætte parameteren til true, returneres nøglenavnet kun, hvis data type og værdi er ens.
Syntaks
array_search(value,array,strict)
Parameter | Beskrivelse |
---|---|
value | Obligatorisk. Angiver den nøgleværdi, der skal søges efter. |
array | Obligatorisk. Angiver det array, der skal søges i. |
strict |
Valgfri. Hvis parameteren sættes til TRUE, søger funktionen efter elementer, der har ens data type og værdi i arrayet. Mulige værdier:
Hvis indstillet til true, kontrolleres givets værdis type i arrayet, tallene 5 og strengen 5 er forskellige (se eksempel 2). |
Tekniske detaljer
Returværdi: |
Hvis den specifikke nøgleværdi findes i arrayet, returneres det tilsvarende nøglenavn, ellers returneres FALSE. Hvis den specifikke nøgleværdi findes mere end én gang i arrayet, returneres den første fundne nøgleværdis matchende nøglenavn. |
PHP Version: | 4.0.5+ |
Opdateringslog: |
Hvis ugyldige parametre sendes til funktionen, returnerer funktionen NULL (dette gælder for alle PHP funktioner fra PHP 5.3.0). Fra PHP 4.2.0 og fremefter returnerer funktionen FALSE i stedet for NULL, hvis søgningen fejler. |
Flere eksempler
Eksempel 1
Søg efter nøglen 5 i arrayet og returner dens nøgle navn (bemærk ""):
<?php $a=array("a"=>"5","b"=>5,"c"=>"5"); echo array_search(5,$a,true); ?>