scan() function

左から順次縮約された値の Iterable/AsyncIterable を返します。reduce と似ています。

Signature:

declare function scan<A extends readonly []>(
  f: Arrow,
  iterable: A,
): IterableIterator<never>;

Example

const iter = scan((acc, cur) => acc * cur, 1, [1, 2, 3, 4]);
iter.next(); // {value: 1, done:false}
iter.next(); // {value: 1, done:false}
iter.next(); // {value: 2, done:false}
iter.next(); // {value: 6, done:false}
iter.next(); // {value: 24, done:false}
iter.next(); // {value: undefined, done: true}

// with pipe
pipe(
  [1, 2, 3, 4],
  scan((acc, cur) => acc * cur),
  toArray,
); // [1, 2, 6, 24]

Open Source Code