Forum und email
Arrays
PHP Manual

array_filter

(PHP 4 >= 4.0.6, PHP 5)

array_filter — Filtra os elementos da array usando uma função de callback

Descrição

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

array_filter() passa por cada valor de input passando-os para a função callback . Se a função callback retornar true, o valor atual de input é retornado na matriz resultado. Os índices das matrizes são preservados.

Example#1 Exemplo de array_filter()

<?php
function impar($var)
{
    return($var & 1);
}

function par($var)
{
    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 "Impares: \n";
print_r(array_filter($array1, "impar"));
echo "Pares: \n";
print_r(array_filter($array2, "par"));
?>

O exemplo acima irá imprimir:

Impares:
Array
(
    [a] => 1
    [c] => 3
    [e] => 5
)
Pares:
Array
(
    [0] => 6
    [2] => 8
    [4] => 10
    [6] => 12
)

As funções utilizadas por array_filter() não devem alterar os valores do array. Por exemplo, adicionar ou remover um elemento, pode apagar o array ao qual está sendo aplicada array_filter(). Se este array for alterado, o comportamento desta função se torna imprevisvel.

Se a função callback não é indicada, array_filter() irá remover todas as entradas de input que são igual a FALSE. Veja convertendo para booleano para maiores informações.

Example#2 array_filter() without callback

<?php

$entry = array(
0 => 'foo',
1 => false,
2 => -1,
3 => null,
4 => ''
);

print_r(array_filter($entry));
?>

O exemplo acima irá imprimir:

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

Veja também array_map(), array_reduce() e array_walk().

Arrays
PHP Manual