Skip to content

filter (Iterator) ​

조건 함수를 만족하는 이터레이터의 요소만 지연 평가 방식으로 남기는 함수를 만들어요. pipe와 같이 사용해요.

typescript
const result = pipe(source, filter(predicate));

INFO

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

사용법 ​

filter(predicate) ​

filter는 조건 함수를 받아서, 조건 함수가 참으로 평가되는 값을 반환하는 요소만 지연 평가 방식으로 남기는 함수를 반환해요. 조건 함수가 타입 가드((value): value is S)이면 요소 타입이 그에 맞게 좁혀져요. 네이티브 Iterator.prototype.filter에 위임해요.

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

// 짝수만 남겨요.
pipe(
  [1, 2, 3, 4].values(),
  filter(x => x % 2 === 0),
  toArray()
);
// 반환 값: [2, 4]

파라미터 ​

  • predicate ((value: T, index: number) => unknown): 각 요소와 인덱스로 호출돼요. 참으로 평가되는 값을 반환하면 그 요소를 남겨요.

반환 값 ​

((source: Iterator<T>) => IteratorObject<T, undefined>): 이터레이터를, 남긴 요소들을 내보내는 지연 평가 이터레이터로 변환하는 함수예요.

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