(PHP 4 >= 4.0.5, PHP 5)
array_search — Durchsucht ein Array nach einem Wert liefert bei Erfolg den Schlüssel
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().