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.
Anmerkung:
Falls needle ein String ist, wird der Vergleich
unter Beachtung der Groß-/Kleinschreibung durchgeführt.
Anmerkung:
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;
?>
|
|
| Warnung |
Diese 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().
array_reverse
