array_filter

(PHP 4 >= 4.0.6, PHP 5)

array_filter — Filtre les éléments d'un tableau grâce à une fonction utilisateur

Description

array array_filter ( array $input [, callable $callback = "" ] )

Évalue chaque valeur du tableau input en les passant à la fonction utilisateur. Si la fonction utilisateur retourne TRUE, la valeur courante du tableau input est retournée dans le tableau résultant. Les clés du tableau sont préservées.

Liste de paramètres

input

Le tableau à évaluer

callback

La fonction utilisateur à utiliser

Si aucune fonction utilisateur n'est fournie, toutes les entrées du tableau input valant FALSE (voir la conversion en booléen) seront effacées.

Valeurs de retour

Retourne le tableau filtré.

Exemples

Exemple #1 Exemple avec array_filter()

<?php
function odd($var)
{
	// retourne lorsque l'entrée est impaire
	return($var & 1);
}

function even($var)
{
	// retourne lorsque l'entrée est paire
	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 "Impair :\n";
print_r(array_filter($array1, "odd"));
echo "Pair :\n";
print_r(array_filter($array2, "even"));
?>

<?php

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

print_r(array_filter($entry));
?>

L'exemple ci-dessus va afficher :

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

Notes

Attention

Si le tableau est modifié depuis la fonction utilisateur (e.g. des éléments sont ajoutés, effacés ou réinitialisés), le comportement de cette fonction est indéfini.

Voir aussi

array_map() - Applique une fonction sur les éléments d'un tableau
array_reduce() - Réduit itérativement un tableau
array_walk() - Exécute une fonction sur chacun des éléments d'un tableau

array_fill

Fonctions sur les tableaux

array_flip

Manuel PHP