PHP array_search()Funktionen
Vollständiges PHP-Array-Referenzhandbuch
Beispiele
Durchsuche das Array nach dem Wert "red" und gib seinen Schlüsselnamen zurück:
<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>
Beispiel ausführen »
Definition und Verwendung
Die Funktion array_search() wird verwendet, um in einem Array nach einem Wert zu suchen und den entsprechenden Schlüsselnamen zurückzugeben. Wenn der Wert nicht gefunden wird, gibt sie false zurück.
Syntax
array_search(mixed $needle, array $haystack, bool $strict = false): int|string|false
| Parameter | Beschreibung |
|---|---|
| $needle | Erforderlich. Gibt den Schlüsselwert an, nach dem im Array gesucht werden soll. |
| $haystack | Erforderlich. Gibt das Array an, das durchsucht werden soll. |
| $strict | Optional. Standardwert ist false. Vergleicht nur Werte, nicht Typen. Wenn dieser Parameter auf TRUE gesetzt ist, durchsucht die Funktion das Array nach Elementen, deren Datentyp und Wert beide identisch sind. Mögliche Werte:
|
Technische Details
| Rückgabewert: | Wenn der angegebene Schlüsselwert im Array gefunden wird, wird der entsprechende Schlüsselname zurückgegeben; andernfalls wird FALSE zurückgegeben. Wenn der Schlüsselwert mehr als einmal im Array gefunden wird, wird der Schlüsselname zurückgegeben, der zum ersten gefundenen Schlüsselwert passt. |
|---|---|
| PHP-Version: | 4.0.5+ |
| Änderungsprotokoll: | Wenn ein ungültiger Parameter an die Funktion übergeben wird, gibt die Funktion NULL zurück (dies gilt für alle PHP-Funktionen seit PHP 5.3.0). Seit PHP 4.2.0 gibt die Funktion FALSE statt NULL zurück, wenn die Suche fehlschlägt. |
Weitere Beispiele
Beispiele
<?php
$numbers = array(1, "2", 3);
$key = array_search(2, $numbers); // Strict-Modus ist nicht aktiviert, gibt Schlüsselnamen 1 zurück
$key_strict = array_search(2, $numbers, true); // Strict-Modus ist aktiviert, gibt false zurück
?>
$numbers = array(1, "2", 3);
$key = array_search(2, $numbers); // Strict-Modus ist nicht aktiviert, gibt Schlüsselnamen 1 zurück
$key_strict = array_search(2, $numbers, true); // Strict-Modus ist aktiviert, gibt false zurück
?>
Beispiel 1
Durchsuche das Array nach dem Schlüsselwert 5 und gib seinen Schlüsselnamen zurück (beachte ""):
<?php
$a=array("a" => "5", "b" => 5, "c" => "5");
echo array_search(5,$a,true);
?>
$a=array("a" => "5", "b" => 5, "c" => "5");
echo array_search(5,$a,true);
?>
Beispiel ausführen »
Vollständiges PHP-Array-Referenzhandbuch Weitere Erweiterungen