unzip (Functional Programming)

Creates a function that regroups zipped arrays by position. Use it with pipe.

typescript

const result = pipe(array, unzip());

::: info

Prefer the original es-toolkit unzip in ordinary code. Use this fp variant when composing transformations with pipe.

:::

Usage

unzip takes an array of grouped values and returns arrays that collect the values at each position.

The returned array's length matches the longest nested array, and missing positions from shorter arrays are filled with undefined.

typescript

import { pipe, unzip } from 'es-toolkit/fp';

pipe(
  [
    [1, 'a'],
    [2, 'b'],
  ],
  unzip()
); // => [[1, 2], ['a', 'b']]

This function takes no arguments; call it as unzip().

((zipped: ReadonlyArray<[...T]>) => Unzip<T>): A function that maps zipped rows to arrays grouped by position.