Function.array-search

Aus PHP-Wiki

array_search — Durchsucht ein Array nach einem Wert liefert bei Erfolg den Schlüssel

Beschreibung

mixed  array_search (mixed  $needle , array $haystack [, bool $strict ] )

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;
?> WarnungDiese Funktion kann sowohl das Boolsche FALSE zurückliefern, als auch einen nicht-Boolschen Wert, wie zum Beispiel0 oder "". der von einem einfachen if-Statement als FALSE ausgewertet wird. Weitere Informationen entnehmen Sie bitte dem Abschnitt über die Boolsche 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().