Class ListAccessor (1.25.0)

ListAccessor(
    data=None,
    index: vendored_pandas_typing.Axes | None = None,
    dtype: typing.Optional[
        bigframes.dtypes.DtypeString | bigframes.dtypes.Dtype
    ] = None,
    name: str | None = None,
    copy: typing.Optional[bool] = None,
    *,
    session: typing.Optional[bigframes.session.Session] = None
)

Accessor object for list data properties of the Series values.

Methods

__getitem__

__getitem__(key: typing.Union[int, slice]) -> bigframes.series.Series

Index or slice lists in the Series.

Examples:

>>> import bigframes.pandas as bpd
>>> import pyarrow as pa
>>> bpd.options.display.progress_bar = None
>>> s = bpd.Series(
...     [
...         [1, 2, 3],
...         [3],
...     ],
...     dtype=bpd.ArrowDtype(pa.list_(pa.int64())),
... )
>>> s.list[0]
0    1
1    3
dtype: Int64
Parameter
Name Description
key int slice

Index or slice of indices to access from each list. For integer indices, only non-negative values are accepted. For slices, you must use a non-negative start, a non-negative end, and a step of 1.

Returns
Type Description
bigframes.series.Series The list at requested index.

len

len()

Compute the length of each list in the Series.

See Also:

- `StringMethods.len` : Compute the length of each element in the Series/Index.

Examples:

>>> import bigframes.pandas as bpd
>>> import pyarrow as pa
>>> bpd.options.display.progress_bar = None
>>> s = bpd.Series(
...     [
...         [1, 2, 3],
...         [3],
...     ],
...     dtype=bpd.ArrowDtype(pa.list_(pa.int64())),
... )
>>> s.list.len()
0    3
1    1
dtype: Int64
Returns
Type Description
bigframes.series.Series A Series or Index of integer values indicating the length of each element in the Series or Index.