narwhals.Series.list

contains

contains(item: NonNestedLiteral) -> SeriesT

Check if sublists contain the given item.

Parameters:

Name	Type	Description	Default
item	NonNestedLiteral	Item that will be checked for membership.	required

Examples:

>>> import polars as pl
>>> import narwhals as nw
>>> s_native = pl.Series([[1, 2], None, []])
>>> s = nw.from_native(s_native, series_only=True)
>>> s.list.contains(1).to_native()
shape: (3,)
Series: '' [bool]
[
        true
        null
        false
]

get

get(index: int) -> SeriesT

Return the value by index in each list.

Negative indices are not accepted.

Returns:

Type	Description
SeriesT	A new series.

Examples:

>>> import polars as pl
>>> import narwhals as nw
>>> s_native = pl.Series([[1, 2], [3, 4, None], [None, 5]])
>>> s = nw.from_native(s_native, series_only=True)
>>> s.list.get(1).to_native()
shape: (3,)
Series: '' [i64]
[
        2
        4
        5
]

len

len() -> SeriesT

Return the number of elements in each list.

Null values count towards the total.

Examples:

>>> import pyarrow as pa
>>> import narwhals as nw
>>> s_native = pa.chunked_array([[[1, 2], [3, 4, None], None, []]])
>>> s = nw.from_native(s_native, series_only=True)
>>> s.list.len().to_native()
<pyarrow.lib.ChunkedArray object at ...>
[
  [
    2,
    3,
    null,
    0
  ]
]

unique

unique() -> SeriesT

Get the unique/distinct values in the list.

Null values are included in the result. The order of unique values is not guaranteed.

Examples:

>>> import polars as pl
>>> import narwhals as nw
>>> s_native = pl.Series([[1, 1, 2], [3, 3, None], None, []])
>>> s = nw.from_native(s_native, series_only=True)
>>> s.list.unique().to_native()
shape: (4,)
Series: '' [list[i64]]
[
   [1, 2]
   [null, 3]
   null
   []
]