array_reduce

    (PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

    array_reduce — Reduz um array para um único valor através de um processo iterativo via callback

    Descrição

    array_reduce(array$array, callable$callback, mixed$initial = null): mixed

    array_reduce() aplica iterativamente a função callback aos elementos de array, de forma a reduzir o array a um único valor.

    Parâmetros

    array

    O array de entrada.

    callback
    callback(mixed$carry, mixed$item): mixed
    carry

    Informa o valor da iteração anterior. No caso da primeira iteração ele terá o valor de initial.

    item

    Mantém o valor da iteração atual.

    initial

    Se o argumento opcional initial for passado, ele será utilizado no início do processo, ou como um resultado final se o array estiver vazio.

    Valor Retornado

    Retorna o valor resultante.

    Se a array estiver vazio e initial não for passado, array_reduce() retornará null.

    Registro de Alterações

    VersãoDescrição
    8.0.0 Se a função callback espera que um parâmetro seja passado por referência, esta função agora emitirá um E_WARNING.

    Exemplos

    Exemplo #1 Exemplo de array_reduce()

    <?php
    function sum($carry, $item)
    {
    $carry += $item;
    return     $carry;
    }

    function     product($carry, $item)
    {
    $carry *= $item;
    return     $carry;
    }

    $a = array(1, 2, 3, 4, 5);
    $x = array();

    var_dump(array_reduce($a, "sum")); // int(15)
    var_dump(array_reduce($a, "product", 10)); // int(1200), because: 10*1*2*3*4*5
    var_dump(array_reduce($x, "sum", "No data to reduce")); // string(17) "No data to reduce"
    ?>

    Veja Também

    To Top