in_array

(PHP 4 )

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()

$os = array ("Mac", "NT", "Irix", "Linux");
if (in_array ("Irix", $os)) {
    print "Got Irix";
}
if (in_array ("mac", $os)) {
    print "Got mac";
}

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

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";
?>

Dies wird folgendes anzeigen:
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";
?>

// Dies wird folgendes anzeigen:

'ph' wurde gefunden
'o' wurde gefunden

Siehe auch array_search().