Skip to content

narwhals.Series.struct

field

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']