PHP - array_filter

Třída

Kořen \ Bez třídy

Metoda - array_filter

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

Projde každou položku v poli se zavoláním předaného callbacku. Pokud callback vrátí hodnotu true, pole vrácené touto funkcí bude tento prvek obsahovat. V opačném případě se nebude aktuální prvek ve vráceném poli vyskytovat. Klíče prvků jsou zachovány.

Pozor: Změna pole z callbacku (přidávání, mazání nebo odnastavení položky) je brána jako nepředpokládané chování. Toto použití callbacku se nedoporučuje.

Procedurální

• function array_filter (array $array, int $flag = 0) : array

Parametry

Název	Datový typ	Výchozí hodnota	Popis
$array	array		Pole, jehož položky jsou předávány callbacku.
$flag	int	0	Příznak pro callback. Konstanta ARRAY_FILTER_U­SE_KEY: Callbacku bude předán jen jeden argument - hodnota položky. Konstanta ARRAY_FILTER_U­SE_BOTH: Callbacku budou předány 2 argumenty - klíč a hodnota položky.

Návratové hodnoty

Vrací: array

Vrátí pole s položkami, u kterých callback vrátil hodnotu true.

Příklady

Tato ukázka vyfiltruje všechny položky, které jsou funkcí empty() brány jako prázdné.

<?php function filterEmpty($x) {
    return !empty($x);
}

$array = array(false, null, 0, '0', '', 'NeprázdnáHodnota', 'NeprázdnáHodnota2'); $filteredArray = array_filter($array, filterEmpty); var_dump($filteredArray);