Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

in_array

Array-Funktionen

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


    Parameter-Liste:
NameBeschreibung
needleDer gesuchte Wert.
Hinweis:
Ist needle ein String so wird bei der Suche Gross- und Kleinschreibung beachtet.
haystackDas zu durchsuchende Array.
strictWenn 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.

    Beschreibung:
Die Funktion in_array() sucht in einem Array (haystack) nach einem Suchwort (needle) und gibt True bei Erfolg, sonst False zurück.

Hat der Parameter strict den Wert True, sucht die Funktion nur Elemente, deren Wert denselben Datentyp hat wie needle; Default-Wert ist False.

Bitte beachten Sie, dass wenn der Wert von needle vom Typ String ist, zwischen Gross- und Kleinschreibung unterschieden wird (Sie Beispiel PERL und Perl). Weiterhin durfte vor der Version 4.2.0 von PHP needle kein Array sein.

Falls Sie den Schlüssel des gefundenen Elements benötigen, so nutzen Sie die Funktion array_search()


    Aktiv in Version:
(PHP 4, PHP 5, PHP 7)

    Siehe auch:
Durchsucht ein Array nach einem Wert und liefert bei Erfolg den zugehörigen Schlüssel
 
•  isset()
Prüft, ob eine Variable existiert und ob sie nicht NULL ist
 
Prüft, ob ein Schlüssel in einem Array existiert
 

in_array() - Beispiel:


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


Ausgabe:
Irix enthalten

Beschreibung:
Der zweite Vergleich schl�gt fehl da in_array() Gross- und Kleinschreibung unterscheidet.

Beschreibung:
Version Beschreibung
4.2.0 needle kann nun selbst ein Array sein.
in_array() - Beispiel 2: mit 'strict'


Eingabe:
<?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";
}
?>


Ausgabe:
1.13 bei strenger Pr�fung gefunden

Beschreibung:
Version Beschreibung
4.2.0 needle kann nun selbst ein Array sein.
in_array() - Beispiel 3: mit Array als Suchwert


Eingabe:
<?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";
}
?>


Ausgabe:
  'ph' gefunden
  'o' gefunden

Beschreibung:
Version Beschreibung
4.2.0 needle kann nun selbst ein Array sein.
in_array() - Beispiel 4:


Eingabe:
<?PHP
$var_array = array ( 'PHP', 'ASP', 'PERL', 'C++' );

if ( in_array ( 'PERL', $var_array ) )
{
    echo 'String "PERL" gefunden!' . "\n";
}

if ( ! in_array ( 'Perl', $var_array ) )
{
    echo 'String "Perl" nicht gefunden!';
}
?>


Ausgabe:
String "PERL" gefunden!
String "Perl" nicht gefunden!

Beschreibung:
Version Beschreibung
4.2.0 needle kann nun selbst ein Array sein.
Array-Funktionen