Skip to content

reduce (Iterator) ​

이터레이터를 하나의 값으로 접는 함수를 만들어요. pipe와 같이 사용해요.

typescript
const result = pipe(source, reduce(callback, initial));

INFO

파이프라인으로 조합하지 않는 일반 코드에서는 네이티브 Iterator.prototype.reduce를 쓰는 것이 좋아요: source.reduce(callback, initial). pipe로 변환을 이어 붙일 때 이 es-toolkit/fp/iterator 버전을 사용하세요.

사용법 ​

reduce(callback, initial) ​

reduce는 파이프라인을 끝내는 종결 단계예요. 모든 요소를 꺼내면서 누적값을 callback에 이어서 전달하고, 마지막 누적값을 반환해요. 이터레이터 전체를 소비하기 때문에, 무한 이터레이터에는 사용하면 안 돼요. 마지막 누적값만이 아니라 모든 중간 누적값을 유지하려면 scan을 사용하세요. 네이티브 Iterator.prototype.reduce에 위임해요.

typescript
import { pipe } from 'es-toolkit/fp';
import { map, reduce } from 'es-toolkit/fp/iterator';

// 두 배로 만든 요소들의 합을 구해요.
pipe(
  [1, 2, 3].values(),
  map(x => x * 2),
  reduce((acc, x) => acc + x, 0)
);
// 반환 값: 12

파라미터 ​

  • callback ((accumulator: U, value: T, index: number) => U): 현재 누적값, 각 요소, 인덱스로 호출돼요. 다음 누적값을 반환해요.
  • initial (U): 누적값의 초기값이에요.

반환 값 ​

((source: Iterator<T>) => U): 이터레이터를 소비하고 마지막 누적값을 반환하는 함수예요.

MIT 라이선스에 따라 배포됩니다.