array_search
(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
Beschreibung
Sucht needle in haystack.
Parameter-Liste
-
needle -
Der zu suchende Wert.
Hinweis:
Wenn
needleein String ist, wird der Vergleich unter Berücksichtigung der Groß-/Kleinschreibung vorgenommen. -
haystack -
Das Array.
-
strict -
Ist der dritte Parameter
strictaufTRUEgesetzt, so wird array_search() nach identischen Elementen inhaystacksuchen. Das bedeutet, dass ebenfalls ein typstarker Vergleich vonneedleinhaystackdurchgeführt wird 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.
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.
Changelog
| Version | Beschreibung |
|---|---|
| 5.3.0 |
Wie alle internen PHP-Funktionen seit 5.3.0 gibt
array_search() den Wert NULL zurück,
wenn ungültige Parameter übergeben wurden.
|
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() - Liefert alle Schlüssel oder eine Teilmenge aller Schlüssel eines Arrays
- array_values() - Liefert alle Werte eines Arrays
- array_key_exists() - Prüft, ob ein Schlüssel in einem Array existiert
- in_array() - Prüft, ob ein Wert in einem Array existiert
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 30/01/2003, zuletzt geändert 26/10/2018
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/php-rf-function.array-search.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.
