array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.array-filter.php', 1 => 'array_filter', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.array-fill.php', 1 => 'array_fill', ), 'next' => array ( 0 => 'function.array-flip.php', 1 => 'array_flip', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/array-filter.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
array_filter — Filtra elementos de um array utilizando uma função callback
Itera sobre cada valor de
array
passando-os para a função
callback
. Se a função
callback
retornar true
, o valor atual de
array
é retornado no array resultante.
Chaves do array são preservadas,e podem resultar em lacunas se o array
foi indexado.
O array resultante pode ser reindexado usando a função array_values().
array
O array a ser iterado
callback
A função callback a ser usada
Se nenhum callback
é fornecido, todas entradas vazias do
array
serão removidas. Veja empty()
para saber como o PHP define vazia nesse caso.
mode
Flag determinando quais argumentos são passados para callback
:
ARRAY_FILTER_USE_KEY
- passa chaves como argumentos
para callback
em vez de valor
ARRAY_FILTER_USE_BOTH
- passa tanto valor quanto chave como
argumento para callback
em vez do valor
0
que em vez disso irá passar valor como o único argumento
para callback
.
Retorna o array filtrado.
Versão | Descrição |
---|---|
8.0.0 |
callback agora é anulável.
|
8.0.0 |
Se a função callback espera que um parâmetro seja passado
por referência, esta função agora emitirá um E_WARNING .
|
Exemplo #1 Exemplo da função array_filter()
<?php
function impar($var)
{
// retorna se o inteiro informado é impar
return $var & 1;
}
function par($var)
{
// retorna se o inteiro informado é par
return !($var & 1);
}
$array1 = ['a' => 1, 'b' => 2, 'c' => 3, 'd' => 4, 'e' => 5];
$array2 = [6, 7, 8, 9, 10, 11, 12];
echo "Ímpares: \n";
print_r(array_filter($array1, "impar"));
echo "Pares: \n";
print_r(array_filter($array2, "par"));
?>
O exemplo acima produzirá:
Ímpares: Array ( [a] => 1 [c] => 3 [e] => 5 ) Pares: Array ( [0] => 6 [2] => 8 [4] => 10 [6] => 12 )
Exemplo #2 array_filter() sem
callback
<?php
$entry = [
0 => 'foo',
1 => false,
2 => -1,
3 => null,
4 => '',
5 => '0',
6 => 0,
];
print_r(array_filter($entry));
?>
O exemplo acima produzirá:
Array ( [0] => foo [2] => -1 }
Exemplo #3 array_filter() com
mode
<?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));
?>
O exemplo acima produzirá:
array(1) { ["b"]=> int(2) } array(2) { ["b"]=> int(2) ["d"]=> int(4) }
Se o array é modificado por uma função callback (e.g. elemento adicionado, deletado ou apagado) o comportamento desta função é indefinido.