polars.Expr.list.slice

Expr.list.slice(

offset: int | str | Expr,

length: int | str | Expr | None = None,

) → Expr

Slice every sub-list.

engine:In MemoryStreamingDistributed

Parameters:

offset

Start index. Negative indexing is supported.

length

Length of the slice. If set to None (default), the slice is taken to the end of the list.

Examples

>>> df = pl.DataFrame({"a": [[1, 2, 3, 4], [10, 2, 1]]})
>>> df.with_columns(slice=pl.col("a").list.slice(1, 2))
shape: (2, 2)
┌─────────────┬───────────┐
│ a           ┆ slice     │
│ ---         ┆ ---       │
│ list[i64]   ┆ list[i64] │
╞═════════════╪═══════════╡
│ [1, 2, … 4] ┆ [2, 3]    │
│ [10, 2, 1]  ┆ [2, 1]    │
└─────────────┴───────────┘