array_reduce

(PHP 4 >= 4.0.5, PHP 5)

array_reduceRéduit itérativement un tableau

Description

mixed array_reduce ( array $input , callable $function [, mixed $initial = NULL ] )

array_reduce() applique itérativement la fonction function aux éléments du tableau input, de manière à réduire le tableau à une valeur simple.

Liste de paramètres

input

Le tableau d'entrée.

function

La fonction de rappel.

mixed callback ( mixed &$result , mixed $item )
initial

Si l'argument optionnel initial est disponible, il sera utilisé pour initialiser le processus, ou bien comme valeur finale si le tableau est vide.

Valeurs de retour

Retourne la valeur résultante.

Si le tableau est vide et le paramètre initial n'est pas passé, array_reduce() retourne NULL.

Historique

Version Description
5.3.0 Modification du paramètre initial afin d'autoriser des variables de types mixtes (mixed) ; auparavant, uniquement des entiers.

Exemples

Exemple #1 Exemple avec array_reduce()

<?php
function rsum($v, $w)
{
	$v += $w;
	return $v;
}

function rmul($v, $w)
{
	$v *= $w;
	return $v;
}

$a = array(1, 2, 3, 4, 5);
$x = array();
$b = array_reduce($a, "rsum");
$c = array_reduce($a, "rmul", 10);
$d = array_reduce($x, "rsum", "Aucune donnée à réduire");
?>

Dans cet exemple, $b contiendra 15, $c contiendra 1200 (= 10*1*2*3*4*5), et $d contiendra "Aucune donnée à réduire".

Voir aussi

LoadingChargement en cours