nushell/docs/commands/reduce.md
Justin Ma c0a1d18e3d
update #4455, regenerate commands' docs and update make_docs script (#4586)
* feat: update #4455, regenerate commands' docs

* chore: update make_docs script
2022-02-21 11:26:00 -06:00

935 B

title layout version
reduce command 0.59.0

Aggregate a list table to a single value using an accumulator block.

Signature

> reduce (block) --fold --numbered

Parameters

  • block: reducing function
  • --fold {any}: reduce with initial value
  • --numbered: iterate with an index

Examples

Sum values of a list (same as 'math sum')

> [ 1 2 3 4 ] | reduce {|it, acc| $it + $acc }

Sum values with a starting value (fold)

> [ 1 2 3 4 ] | reduce -f 10 {|it, acc| $acc + $it }

Replace selected characters in a string with 'X'

> [ i o t ] | reduce -f "Arthur, King of the Britons" {|it, acc| $acc | str find-replace -a $it "X" }

Find the longest string and its index

> [ one longest three bar ] | reduce -n { |it, acc|
        if ($it.item | str length) > ($acc | str length) {
            $it.item
        } else {
            $acc
        }
    }