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 Beispiel`0` 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