PHP array_search() functie
Voorbeeld
Zoek naar de sleutelwaarde "red" in de array en retourneer de bijbehorende sleutelnaam:
<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>
Definitie en gebruik
De functie array_search() zoekt naar een sleutelwaarde in een array en retourneert de bijbehorende sleutelnaam.
Uitleg
De functie array_search() en in_array() Net zoals, een sleutelwaarde in een array zoeken. Als deze waarde wordt gevonden, wordt de naam van het matchende element geretourneerd. Als deze niet wordt gevonden, wordt false geretourneerd.
Voor PHP 4.2.0 terug, retourneert de functie null in plaats van false bij een mislukking.
Als de derde parameter strict Indien ingesteld op true, wordt alleen de naam van het element geretourneerd wanneer de gegevenstype en waarde overeenkomen.
Syntax
array_search(value,array,strict)
| Parameters | Beschrijving |
|---|---|
| value | Verplicht. Specificeer de waarde die moet worden gezocht. |
| array | Verplicht. Specificeer het array dat moet worden doorzocht. |
| strict |
Optioneel. Als dit parameter ingesteld wordt op TRUE, zoekt de functie in het array naar elementen die dezelfde gegevenstype en waarde hebben. Mogelijke waarden:
Als ingesteld op true, wordt in het array gecontroleerd of de gegeven waarde van het type en de waarde overeenkomt, het getal 5 en de string 5 zijn verschillend (zie voorbeeld 2). |
Technische details
| Retournerende waarde: |
Als de opgegeven waarde in het array wordt gevonden, wordt de overeenkomstige sleutel geretourneerd, anders FALSE. Als de waarde van de sleutel in het array meermaals wordt gevonden, wordt de naam van de sleutel die voor het eerst wordt gevonden geretourneerd. |
| PHP versie: | 4.0.5+ |
| Update log: |
Als ongeldige parameters aan de functie worden doorgegeven, retourneert de functie NULL (dit geldt voor alle PHP-functies sinds PHP 5.3.0). Vanaf PHP 4.2.0 terug, retourneert de functie FALSE in plaats van NULL bij een mislukking. |
Meer voorbeelden
Voorbeeld 1
Zoek in het array naar de waarde 5 en geef de naam van de sleutel terug (let op "":)
<?php
$a=array("a"=>"5","b"=>5,"c"=>"5");
echo array_search(5,$a,true);
?>
