Manual do PHP
Anterior |  | Próxima

# array_filter

(PHP 4 >= 4.0.6)

array_filter -- Filtra os elementos de um array utilizando uma função

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

Exemplo 1. Exemplo de array_filter()

`<?php function impar($var) { return($var % 2 == 1); } function par($var) { return($var % 2 == 0); } $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")); ?>`

A saída deste programa seria:

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

Exemplo 2. array_filter() without `callback`

`<?php $entry = array( 0 => 'foo', 1 => false, 2 => -1, 3 => null, 4 => '' ); print_r(array_filter($entry)); ?>`

Isto irá mostrar:

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

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

Anterior | Principal | Próxima
array_fill | Acima | array_flip