PHP Dokumentation: Function in-array
12. Januar 2010 von werner
in_array
(PHP 4, PHP 5)
in_array — Prüft, ob ein Wert in einem Array existiert
Beschreibung
Diese Funktion sucht in haystack nach needle.
Parameter-Liste
- needle
Der gesuchte Wert.
Hinweis: Ist needle ein String so wird bei der Suche Groß- und Kleinschreibung beachtet.
- haystack
Das zu durchsuchende Array.
- strict
Wenn der dritte Parameter auf TRUE gesetzt wird vergleicht in_array() nicht nur den Wert sondern auch den Typ des gesuchten Wertes needle mit den Elementen des Arrays.
Rückgabewerte
Gibt TRUE zurück wenn needle im Array gefunden wird, sonst FALSE.
Changelog
| Version | Beschreibung |
|---|---|
| 4.2.0 | needle kann nun selbst ein Array sein. |
Beispiele
Beispiel #1 in_array() Beispiel
<?php
$os = array("Mac", "NT", "Irix", "Linux");
if (in_array("Irix", $os)) {
echo "Irix enthalten";
}
if (in_array("mac", $os)) {
echo "mac enthalten";
}
?>Der zweite Vergleich schlägt fehl da in_array() Groß- und Kleinschreibung unterscheidet, die Ausgabe sieht daher so aus:
Irix enthalten
Beispiel #2 in_array() Beispiel mit 'strict'
<?php
$a = array('1.10', 12.4, 1.13);if (
in_array('12.4', $a, true)) {
echo "'12.4' bei strenger Prüfung gefunden\n";
}if (
in_array(1.13, $a, true)) {
echo "1.13 Bei strenger Prüfung gefunden\n";
}
?>Das oben gezeigte Beispiel erzeugt folgendeAusgabe:
1.13 bei strenger Prüfung gefunden
Beispiel #3 in_array() mit Array als Suchwert
<?php
$a = array(array('p', 'h'), array('p', 'r'), 'o');if (
in_array(array('p', 'h'), $a)) {
echo "'ph' gefunden\n";
}if (
in_array(array('f', 'i'), $a)) {
echo "'fi' gefunden\n";
}if (
in_array('o', $a)) {
echo "'o' gefunden\n";
}
?>Das oben gezeigte Beispiel erzeugt folgendeAusgabe:
'ph' gefunden 'o' gefunden
Siehe auch
- array_search() – Durchsucht ein Array nach einem Wert liefert bei Erfolg den Schlüssel
- isset() – Prüft, ob eine Variable existiert und ob sie nicht NULL ist
- array_key_exists() – Prüft, ob ein Schlüssel in einem Array existiert