Skip to content

partition (Iterator) ​

イテレータを消費し、条件によって要素を 2 つの配列に分割する関数を作成します。関数型プログラミングの pipe と一緒に使用します。

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

INFO

パイプラインとして組み合わせない通常のコードでは、es-toolkit/iterator の partition(partition(source, predicate))を使うのがおすすめです。pipe で変換をつなげるときは、この es-toolkit/fp/iterator 版を使用してください。

使用法 ​

partition(predicate) ​

partition はイテレータのパイプラインの終端操作です。すべての要素を取り出し、predicate が真と評価される値を返した要素は最初の配列に、それ以外の要素は 2 番目の配列に入れます。イテレータ全体を消費するため、無限イテレータに対して使用してはいけません。

typescript
import { pipe } from 'es-toolkit/fp';
import { partition } from 'es-toolkit/fp/iterator';

// 数を偶数と奇数に分割します。
pipe(
  [1, 2, 3, 4].values(),
  partition(x => x % 2 === 0)
);
// 結果: [[2, 4], [1, 3]]

パラメータ ​

  • predicate ((value: T, index: number) => boolean): 各要素とそのインデックスとともに呼び出されます。真と評価される値を返すと、その要素は最初の配列に入ります。

戻り値 ​

((source: Iterator<T>) => [T[], T[]]): イテレータを消費し、条件を満たした要素の配列と、満たさなかった要素の配列からなるタプル([matched, unmatched])を返す関数です。

MIT ライセンスの下で配布されています。