array_filter

(PHP 4 >= 4.0.6, PHP 5, PHP 7)

array_filterFiltert Elemente eines Arrays mittels einer Callback-Funktion

Beschreibung

array_filter ( array $array [, callable $callback [, int $flag = 0 ]] ) : array

Iteriert über jeden Wert im Array array und übergibt diesen der Callbackfunktion callback. Gibt die Funktion callback TRUE zurück, so wird der aktuelle Wert von array in das Ergebnis-array geschrieben. Die Schlüssel des Arrays bleiben erhalten.

Parameter-Liste

array

Das Array, über das iteriert werden soll

callback

Die zu verwendende Callbackfunktion

Falls die Funktion callback nicht angegeben wurde, werden alle Einträge aus array entfernt, die FALSE sind. Schauen Sie sich Konvertierung in Booleans für mehr Informationen hierzu an.

flag

Flag, welches bestimmt welche Parameter an callback gesendet werden:

  • ARRAY_FILTER_USE_KEY - nur der Schlüssel wird als einziger Parameter an callback gesendet statt des Wertes.
  • ARRAY_FILTER_USE_BOTH - sowohl der Schlüssel als auch der Wert werden als Parameter an callback übergeben statt des Wertes.
Der Standardwert ist 0, was bedeutet, dass nur der Wert als Parameter an callback übergeben wird.

Rückgabewerte

Gibt das gefilterte Array zurück.

Changelog

Version Beschreibung
5.6.0 Der optionale Parameter flag und die Konstanten ARRAY_FILTER_USE_KEY und ARRAY_FILTER_USE_BOTH wurden hinzugefügt.

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 = ["a"=>1"b"=>2"c"=>3"d"=>4"e"=>5];
$array2 = [6789101112];

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 
= [
    
=> 'foo',
    
=> false,
    
=> -1,
    
=> null,
    
=> '',
    
=> '0',
    
=> 0,
];

print_r(array_filter($entry));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Array
(
    [0] => foo
    [2] => -1
)

Beispiel #3 array_filter() mit flag

<?php

$arr 
= ['a' => 1'b' => 2'c' => 3'd' => 4];

var_dump(array_filter($arr, function($k) {
    return 
$k == 'b';
}, 
ARRAY_FILTER_USE_KEY));

var_dump(array_filter($arr, function($v$k) {
    return 
$k == 'b' || $v == 4;
}, 
ARRAY_FILTER_USE_BOTH));
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

array(1) {
  ["b"]=>
  int(2)
}
array(2) {
  ["b"]=>
  int(2)
  ["d"]=>
  int(4)
}

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 vom Benutzer gelieferte Funktion auf jedes Element eines Arrays an