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

Kør eksempel

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:

  • true
  • false - standard

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

Kør eksempel