polars.Expr.list.explode#

Expr.list.explode(*, empty_as_null: bool = True, keep_nulls: bool = True) → Expr[source]#

Returns a column with a separate row for every list element.

Parameters:

empty_as_null: Explode an empty list into a null.
keep_nulls: Explode a null list into a null.

Returns:

Expr: Expression with the data type of the list elements.

See also

Expr.reshape: Reshape this Expr to a flat Series or a Series of Lists.

Examples

>>> df = pl.DataFrame({"a": [[1, 2, 3], [4, 5, 6]]})
>>> df.select(pl.col("a").list.explode())
shape: (6, 1)
┌─────┐
│ a   │
│ --- │
│ i64 │
╞═════╡
│ 1   │
│ 2   │
│ 3   │
│ 4   │
│ 5   │
│ 6   │
└─────┘