Skip to content

narwhals.Series.struct

field(name: str) -> SeriesT

Retrieve a Struct field as a new expression.

Parameters:

Name Type Description Default
name str

Name of the struct field to retrieve.

required

Returns:

Type Description
SeriesT

A new Series.

Examples:

>>> import polars as pl
>>> import narwhals as nw
>>> s_native = pl.Series(
...     [
...         {"id": "0", "name": "john"},
...         {"id": "1", "name": "jane"},
...     ]
... )
>>> s = nw.from_native(s_native, series_only=True)
>>> s.struct.field("name").to_list()
['john', 'jane']