array_filter

(PHP 4 >= 4.0.6, PHP 5)

array_filter — Filtert Elemente eines Arrays mittels einer Callback-Funktion

Beschreibung

array array_filter ( array $input [, callback $callback ] )

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 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.

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

Achtung

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