PHP Handbuch
Zurück |  | Weiter

# array_search

(PHP 4 >= 4.0.5, PHP 5)

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`.

> 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().

Zurück | Zum Anfang | Weiter
array_reverse | Nach oben | array_shift