in_array

(PHP 4, PHP 5)

in_array -- Prüft, ob ein Wert in einem Array existiert

Beschreibung

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

Diese Funktion sucht in haystack nach needle und gibt bei Erfolg TRUE zurück, andernfalls FALSE.

Ist der dritte Parameter strict auf TRUE gesetzt, prüft in_array() auch die Typen von needle in haystack.

Anmerkung: Ist needle ein String, erfolgt der Vergleich unter Berücksichtigung der Groß- und Kleinschreibung.

Anmerkung: In den PHP Versionen vor 4.2.0 durfte needle kein Array sein

Beispiel 1. in_array()

<?php
$os
= array("Mac", "NT", "Irix", "Linux");
if (
in_array("Irix", $os)) {
    echo
"Irix gefunden";
}
if (
in_array("mac", $os)) {
    echo
"mac gefunden";
}
?>

Die zweite Bedingung schlägt fehl, da in_array() die Groß-/Kleinschreibung berücksichtigt, daher wird das obige Programm folgendes ausgeben:

Irix gefunden

Beispiel 2. in_array() mit strict

<?php
$a
= array('1.10', 12.4, 1.13);

if (
in_array('12.4', $a, true)) {
    echo
"'12.4' gefunden mit strict check\n";
}
if (
in_array(1.13, $a, true)) {
    echo
"1.13 gefunden mit strict check\n";
}
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

1.13 gefunden mit strict check

Beispiel 3. in_array() mit einem Array als needle

<?php
$a
= array(array('p', 'h'), array('p', 'r'), 'o');

if (
in_array(array('p', 'h'), $a)) {
    echo
"'ph' wurde gefunden\n";
}
if (
in_array(array('f', 'i'), $a)) {
    echo
"'fi' wurde nicht gefunden\n";
}
if (
in_array('o', $a)) {
    echo
"'o' wurde gefunden\n";
}
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

'ph' wurde gefunden
  'o' wurde gefunden

Siehe auch array_search(), array_key_exists() und isset().