array_filter
(PHP 4 >= 4.0.6, PHP 5)
array_filter — Filtert Elemente eines Arrays mittels einer Callback-Funktion
Beschreibung
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.
Parameter-Liste
-
input -
Das Array, über das iteriert werden soll
-
callback -
Die zu verwendende Callbackfunktion
Falls die Funktion
callbacknicht angegeben wurde, werden alle Einträge des Arrays entfernt, dieFALSEsind. Schauen Sie sich Konvertierung in Booleans für mehr Informationen hierzu an.
Rückgabewerte
Gibt das gefilterte Array zurück.
Beispiele
Beispiel #1 array_filter()-Beispiel
<?php
function ungerade($var)
{
// Gibt zurück, ob der Eingabewert ungerade ist
return($var & 1);
}
function gerade($var)
{
// Gibt zurück, ob der Eingabewert gerade ist
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
)
Anmerkungen
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.
Siehe auch
- array_map() - Wendet eine Callback-Funktion auf die Elemente von Arrays an
- array_reduce() - Iterative Reduktion eines Arrays zu einem Wert mittels einer Callbackfunktion
- array_walk() - Wendet eine Benutzerfunktion auf jedem Element eines Arrays an
