PHP-Handbuch: Prüft, ob ein Wert in einem Array existiert

Beschreibung

bool in_array ( mixed $needle , array $haystack [, bool $strict = FALSE ] )

Diese Funktion sucht in haystack nach needle. Wenn strict gesetzt ist, wird dabei auch der Typ des Elements beachtet.

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.

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 folgende Ausgabe:

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 folgende Ausgabe:

  'ph' gefunden
  'o' gefunden

Siehe auch

array_search
isset
array_key_exists