Function.in-array

Aus PHP-Wiki

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 .

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

=== #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ß===
 
 
 
<source lang="php">
 
<?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()