array_search
Durchsucht ein Array nach einem Wert und liefert bei Erfolg den
zugehörigen Schlüssel
Beschreibung
mixed array_search
( mixed $needle
, array $haystack
[, bool $strict = false
] )
Parameter-Liste
-
needle
-
Der zu suchende Wert.
Hinweis:
Wenn needle ein String ist, wird der Vergleich
unter Berücksichtigung der Groß-/Kleinschreibung vorgenommen.
-
haystack
-
Das 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.
Rückgabewerte
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.
WarnungDiese 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.
Beispiele
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;
?>
Siehe auch
- array_keys
- array_values
- array_key_exists
- in_array