(PHP 4 >= 4.0.5, PHP 5, PHP 7)
array_search — Durchsucht ein Array nach einem Wert und liefert bei Erfolg den zugehörigen Schlüssel
Durchsucht haystack nach
needle.
needleDer zu suchende Wert.
Hinweis:
Wenn
needleein String ist, wird der Vergleich unter Berücksichtigung der Groß-/Kleinschreibung vorgenommen.
haystackDas Array.
strict
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, welcher zu 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 |
|---|---|
| 5.3.0 |
Wie alle internen PHP-Funktionen seit 5.4.0 gibt
array_search() den Wert NULL zurück,
wenn ungültige Parameter übergeben wurden.
|
| 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;
?>