(PHP 4 >= 4.0.6, PHP 5)
array_filter — Filtert Elemente eines Arrays mittels einer Callback-Funktion
Iteriert über jeden Wert im Array input und übergibt diesen der Callbackfunktion callback. Gibt die Funktion callback true zurück, so wird der aktuelle Wert von input in das Ergebnis-Array geschrieben. Die Schlüssel des Arrays bleiben erhalten.
Das Array, über das iteriert werden soll
Die zu verwendende Callbackfunktion
Falls die Funktion callback nicht angegeben wurde, werden alle Einträge des Arrays entfernt, die FALSE sind. Schauen Sie sich Konvertierung in Booleans für mehr Informationen hierzu an.
Gibt das gefilterte Array zurück.
Beispiel #1 array_filter()-Beispiel
<?php
function ungerade($var)
{
return($var & 1);
}
function gerade($var)
{
return(!($var & 1));
}
$array1 = array("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5);
$array2 = array(6, 7, 8, 9, 10, 11, 12);
echo "Ungerade :\n";
print_r(array_filter($array1, "ungerade"));
echo "Gerade:\n";
print_r(array_filter($array2, "gerade"));
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Ungerade : Array ( [a] => 1 [c] => 3 [e] => 5 ) Gerade: Array ( [0] => 6 [2] => 8 [4] => 10 [6] => 12 )
Beispiel #2 array_filter() ohne callback
<?php
$entry = array(
0 => 'foo',
1 => false,
2 => -1,
3 => null,
4 => ''
);
print_r(array_filter($entry));
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array ( [0] => foo [2] => -1 )
Wird das Array durch die Callbackfunktion verändert (z.B. hinzufügen oder löschen von Elementen oder ein unset-Aufruf), so ist das Verhalten dieser Funktion undefiniert.