(PHP 4 >= 4.0.5, PHP 5)
array_search — Durchsucht ein Array nach einem Wert und liefert bei Erfolg den zugehörigen Schlüssel
Durchsucht haystack nach needle.
Der zu suchende Wert.
Hinweis: Wenn needle ein String ist, wird der Vergleich unter Berücksichtigung der Groß-/Kleinschreibung vorgenommen.
Das Array.
Ist der dritte Parameter strict auf TRUE gesetzt, so wird array_search() nach identischen Elementen in haystack suchen. Das bedeutet, dass ebenfalls der Typ von needle dem in haystack entsprechen muss und die Objekte die selbe Instanz sind.
Gibt den Schlüssel für needle zurück, wenn es gefunden wurde, ansonsten FALSE.
Wenn needle in haystack mehrfach gefunden wurde, so wird der erste passende Schlüssel zurückgegeben. Um die Schlüssel für alle gefundenen Werte zurückzugeben, können Sie stattdessen array_keys() mit dem optionalen Parameter search_value verwenden.
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.
Version | Beschreibung |
---|---|
4.2.0 | Vor PHP 4.2.0 gibt array_search() im Fehlerfall NULL statt FALSE zurück. |
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;
?>