Funciones de Arrays
PHP Manual

array_filter

(PHP 4 >= 4.0.6, PHP 5)

array_filter — Filtra elementos de un array usando una función de devolución de llamada

Descripción

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

Recorre cada valor de array pasándolos a la función callback. Si la función callback devuelve true, el valor actual desde array es devuelto dentro del array resultante. Las claves del array se conservan.

Parámetros

array

El array a recorrer.

callback

La función de devolución de llamada a usar.

Si no se proporciona callback, todas las entradas de array iguales a FALSE (ver convetir a boolean) serán eliminadas.

Valores devueltos

Devuelve el array filtrado.

Ejemplos

Ejemplo #1 Ejemplo de array_filter()

<?php
function impar($var)
{
    
// Retorna siempre que el número entero sea impar
    
return($var & 1);
}

function 
par($var)
{
    
// Retorna siempre que el número entero sea par
    
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 
"Impar :\n";
print_r(array_filter($array1, "impar"));
echo 
"Par:\n";
print_r(array_filter($array2, "par"));
?>

El resultado del ejemplo sería:

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

Ejemplo #2 array_filter() sin callback

<?php

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

print_r(array_filter($entrada));
?>

El resultado del ejemplo sería:

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

Notas

Precaución

Si el array se cambia desde la función de devolución de llamada (p.ej. un elemento añadido, suprimido o desestablecido) el comportamiento de esta función no estará definido.

Ver también


Funciones de Arrays
PHP Manual