| search | |
subnavi
Werbung
array_search
(PHP 4 >= 4.0.5, PHP 5)
array_search — Durchsucht ein Array nach einem Wert liefert bei Erfolg den Schlüssel
Beschreibung
Diese Funktion durchsucht haystack nach needle und gibt bei Erfolg den Schlüssel zurück, andernfalls FALSE.
Hinweis: Falls needle ein String ist, wird der Vergleich unter Beachtung der Groß-/Kleinschreibung durchgeführt.
Hinweis: Vor PHP 4.2.0 gibt array_search() im Fehlerfall NULL statt FALSE zurück.
Ist der optionale dritte Parameter strict auf TRUE gesetzt, prüft array_search() auch die Typen von needle in haystack.
Falls needle in haystack mehr als einmal gefunden wird, wird der erste passende Schlüssel zurückgegeben. Um die Schlüssel aller passenden Werte zu erhalten, verwenden Sie stattdessen array_keys() mit dem optionalen Parameter search_value.
Beispiel #1 array_search() Beispiel
<?php
$array = array(0 => 'blau', 1 => 'rot', 2 => 'grün', 3 => 'rot');
$key = array_search('grün', $array); // $key = 2;
$key = array_search('rot', $array); // $key = 1;
?>
Diese Funktion kann sowohl das boolsche FALSE zurückliefern, als auch einen nicht-boolschen Wert, wie zum Beispiel 0 oder "", der von einem einfachen if-Statement als FALSE ausgewertet wird. Weitere Informationen entnehmen Sie bitte dem Abschnitt über die boolschen Typen. Benutzen Sie deshalb den === Operator, um den Rückgabewert dieser Funktion zu überprüfen.
Siehe auch array_keys(), array_values(), array_key_exists(), und in_array().
werbung
