array_reduce

(PHP 4 >= 4.0.5, PHP 5)

array_reduce — Итеративно уменьшает массив к единственному значению, используя callback-функцию

Описание

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

array_reduce() итеративно применяет callback-функцию function к элементам массива input и, таким образом, сводит массив к единственному значению.

Список параметров

input: Входной массив.
function: Callback-функция.
initial: Если передан необязательный параметр initial, то он будет использован в начале процесса, или в качестве окончательного результата в случае пустого массива.

Возвращаемые значения

Возвращает получившееся значение.

Если массив пуст и не передан параметр initial, array_reduce() вернет NULL.

Список изменений

Версия	Описание
5.3.0	Параметр `initial` теперь позволяет передать mixed, ранее передавался только integer.

Примеры

Пример #1 Пример использования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", "No data to reduce");
?>

В результате переменная $b содержит 15, $c содержит 1200 (= 10*1*2*3*4*5*10), и $d содержит No data to reduce.

Смотрите также

array_filter() - Фильтрует элементы массива с помощью callback-функции
array_map() - Применяет callback-функцию ко всем элементам указанных массивов
array_unique() - Убирает повторяющиеся значения из массива
array_count_values() - Подсчитывает количество всех значений массива