array_search

PHP Handbuch
Zurück		Weiter

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