Skip to content

toArray (Iterator) ​

이터레이터의 요소들을 배열로 모으는 함수를 만들어요. pipe와 같이 사용해요.

typescript
const result = pipe(source, toArray());

INFO

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

사용법 ​

toArray() ​

toArray는 이터레이터 파이프라인에서 가장 흔히 쓰이는 종결 단계예요. 모든 요소를 꺼내서 배열로 반환해요. 이터레이터 전체를 소비하기 때문에, 무한 이터레이터에는 사용하면 안 돼요 — 먼저 take나 takeWhile로 파이프라인의 범위를 제한하세요. 네이티브 Iterator.prototype.toArray에 위임해요.

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

// 변환된 요소들을 배열로 만들어요.
pipe(
  [1, 2, 3].values(),
  map(x => x * 2),
  toArray()
);
// 반환 값: [2, 4, 6]

반환 값 ​

((source: Iterator<T>) => T[]): 이터레이터를 소비하고 그 요소들을 배열로 반환하는 함수예요.

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