Send feedback
Class ListAccessor (2.17.0)
Stay organized with collections
Save and categorize content based on your preferences.
Version latestkeyboard_arrow_down
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.
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.
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class ListAccessor (2.17.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.17.0 (latest)](/python/docs/reference/bigframes/latest/bigframes.operations.lists.ListAccessor)\n- [2.16.0](/python/docs/reference/bigframes/2.16.0/bigframes.operations.lists.ListAccessor)\n- [2.15.0](/python/docs/reference/bigframes/2.15.0/bigframes.operations.lists.ListAccessor)\n- [2.14.0](/python/docs/reference/bigframes/2.14.0/bigframes.operations.lists.ListAccessor)\n- [2.13.0](/python/docs/reference/bigframes/2.13.0/bigframes.operations.lists.ListAccessor)\n- [2.12.0](/python/docs/reference/bigframes/2.12.0/bigframes.operations.lists.ListAccessor)\n- [2.11.0](/python/docs/reference/bigframes/2.11.0/bigframes.operations.lists.ListAccessor)\n- [2.10.0](/python/docs/reference/bigframes/2.10.0/bigframes.operations.lists.ListAccessor)\n- [2.9.0](/python/docs/reference/bigframes/2.9.0/bigframes.operations.lists.ListAccessor)\n- [2.8.0](/python/docs/reference/bigframes/2.8.0/bigframes.operations.lists.ListAccessor)\n- [2.7.0](/python/docs/reference/bigframes/2.7.0/bigframes.operations.lists.ListAccessor)\n- [2.6.0](/python/docs/reference/bigframes/2.6.0/bigframes.operations.lists.ListAccessor)\n- [2.5.0](/python/docs/reference/bigframes/2.5.0/bigframes.operations.lists.ListAccessor)\n- [2.4.0](/python/docs/reference/bigframes/2.4.0/bigframes.operations.lists.ListAccessor)\n- [2.3.0](/python/docs/reference/bigframes/2.3.0/bigframes.operations.lists.ListAccessor)\n- [2.2.0](/python/docs/reference/bigframes/2.2.0/bigframes.operations.lists.ListAccessor)\n- [2.1.0](/python/docs/reference/bigframes/2.1.0/bigframes.operations.lists.ListAccessor)\n- [2.0.0](/python/docs/reference/bigframes/2.0.0/bigframes.operations.lists.ListAccessor)\n- [1.42.0](/python/docs/reference/bigframes/1.42.0/bigframes.operations.lists.ListAccessor)\n- [1.41.0](/python/docs/reference/bigframes/1.41.0/bigframes.operations.lists.ListAccessor)\n- [1.40.0](/python/docs/reference/bigframes/1.40.0/bigframes.operations.lists.ListAccessor)\n- [1.39.0](/python/docs/reference/bigframes/1.39.0/bigframes.operations.lists.ListAccessor)\n- [1.38.0](/python/docs/reference/bigframes/1.38.0/bigframes.operations.lists.ListAccessor)\n- [1.37.0](/python/docs/reference/bigframes/1.37.0/bigframes.operations.lists.ListAccessor)\n- [1.36.0](/python/docs/reference/bigframes/1.36.0/bigframes.operations.lists.ListAccessor)\n- [1.35.0](/python/docs/reference/bigframes/1.35.0/bigframes.operations.lists.ListAccessor)\n- [1.34.0](/python/docs/reference/bigframes/1.34.0/bigframes.operations.lists.ListAccessor)\n- [1.33.0](/python/docs/reference/bigframes/1.33.0/bigframes.operations.lists.ListAccessor)\n- [1.32.0](/python/docs/reference/bigframes/1.32.0/bigframes.operations.lists.ListAccessor)\n- [1.31.0](/python/docs/reference/bigframes/1.31.0/bigframes.operations.lists.ListAccessor)\n- [1.30.0](/python/docs/reference/bigframes/1.30.0/bigframes.operations.lists.ListAccessor)\n- [1.29.0](/python/docs/reference/bigframes/1.29.0/bigframes.operations.lists.ListAccessor)\n- [1.28.0](/python/docs/reference/bigframes/1.28.0/bigframes.operations.lists.ListAccessor)\n- [1.27.0](/python/docs/reference/bigframes/1.27.0/bigframes.operations.lists.ListAccessor)\n- [1.26.0](/python/docs/reference/bigframes/1.26.0/bigframes.operations.lists.ListAccessor)\n- [1.25.0](/python/docs/reference/bigframes/1.25.0/bigframes.operations.lists.ListAccessor)\n- [1.24.0](/python/docs/reference/bigframes/1.24.0/bigframes.operations.lists.ListAccessor)\n- [1.22.0](/python/docs/reference/bigframes/1.22.0/bigframes.operations.lists.ListAccessor)\n- [1.21.0](/python/docs/reference/bigframes/1.21.0/bigframes.operations.lists.ListAccessor)\n- [1.20.0](/python/docs/reference/bigframes/1.20.0/bigframes.operations.lists.ListAccessor)\n- [1.19.0](/python/docs/reference/bigframes/1.19.0/bigframes.operations.lists.ListAccessor)\n- [1.18.0](/python/docs/reference/bigframes/1.18.0/bigframes.operations.lists.ListAccessor)\n- [1.17.0](/python/docs/reference/bigframes/1.17.0/bigframes.operations.lists.ListAccessor)\n- [1.16.0](/python/docs/reference/bigframes/1.16.0/bigframes.operations.lists.ListAccessor)\n- [1.15.0](/python/docs/reference/bigframes/1.15.0/bigframes.operations.lists.ListAccessor)\n- [1.14.0](/python/docs/reference/bigframes/1.14.0/bigframes.operations.lists.ListAccessor)\n- [1.13.0](/python/docs/reference/bigframes/1.13.0/bigframes.operations.lists.ListAccessor)\n- [1.12.0](/python/docs/reference/bigframes/1.12.0/bigframes.operations.lists.ListAccessor)\n- [1.11.1](/python/docs/reference/bigframes/1.11.1/bigframes.operations.lists.ListAccessor)\n- [1.10.0](/python/docs/reference/bigframes/1.10.0/bigframes.operations.lists.ListAccessor)\n- [1.9.0](/python/docs/reference/bigframes/1.9.0/bigframes.operations.lists.ListAccessor)\n- [1.8.0](/python/docs/reference/bigframes/1.8.0/bigframes.operations.lists.ListAccessor)\n- [1.7.0](/python/docs/reference/bigframes/1.7.0/bigframes.operations.lists.ListAccessor)\n- [1.6.0](/python/docs/reference/bigframes/1.6.0/bigframes.operations.lists.ListAccessor)\n- [1.5.0](/python/docs/reference/bigframes/1.5.0/bigframes.operations.lists.ListAccessor)\n- [1.4.0](/python/docs/reference/bigframes/1.4.0/bigframes.operations.lists.ListAccessor)\n- [1.3.0](/python/docs/reference/bigframes/1.3.0/bigframes.operations.lists.ListAccessor)\n- [1.2.0](/python/docs/reference/bigframes/1.2.0/bigframes.operations.lists.ListAccessor)\n- [1.1.0](/python/docs/reference/bigframes/1.1.0/bigframes.operations.lists.ListAccessor)\n- [1.0.0](/python/docs/reference/bigframes/1.0.0/bigframes.operations.lists.ListAccessor)\n- [0.26.0](/python/docs/reference/bigframes/0.26.0/bigframes.operations.lists.ListAccessor)\n- [0.25.0](/python/docs/reference/bigframes/0.25.0/bigframes.operations.lists.ListAccessor)\n- [0.24.0](/python/docs/reference/bigframes/0.24.0/bigframes.operations.lists.ListAccessor)\n- [0.23.0](/python/docs/reference/bigframes/0.23.0/bigframes.operations.lists.ListAccessor)\n- [0.22.0](/python/docs/reference/bigframes/0.22.0/bigframes.operations.lists.ListAccessor)\n- [0.21.0](/python/docs/reference/bigframes/0.21.0/bigframes.operations.lists.ListAccessor)\n- [0.20.1](/python/docs/reference/bigframes/0.20.1/bigframes.operations.lists.ListAccessor)\n- [0.19.2](/python/docs/reference/bigframes/0.19.2/bigframes.operations.lists.ListAccessor)\n- [0.18.0](/python/docs/reference/bigframes/0.18.0/bigframes.operations.lists.ListAccessor)\n- [0.17.0](/python/docs/reference/bigframes/0.17.0/bigframes.operations.lists.ListAccessor)\n- [0.16.0](/python/docs/reference/bigframes/0.16.0/bigframes.operations.lists.ListAccessor)\n- [0.15.0](/python/docs/reference/bigframes/0.15.0/bigframes.operations.lists.ListAccessor)\n- [0.14.1](/python/docs/reference/bigframes/0.14.1/bigframes.operations.lists.ListAccessor)\n- [0.13.0](/python/docs/reference/bigframes/0.13.0/bigframes.operations.lists.ListAccessor)\n- [0.12.0](/python/docs/reference/bigframes/0.12.0/bigframes.operations.lists.ListAccessor)\n- [0.11.0](/python/docs/reference/bigframes/0.11.0/bigframes.operations.lists.ListAccessor)\n- [0.10.0](/python/docs/reference/bigframes/0.10.0/bigframes.operations.lists.ListAccessor)\n- [0.9.0](/python/docs/reference/bigframes/0.9.0/bigframes.operations.lists.ListAccessor)\n- [0.8.0](/python/docs/reference/bigframes/0.8.0/bigframes.operations.lists.ListAccessor)\n- [0.7.0](/python/docs/reference/bigframes/0.7.0/bigframes.operations.lists.ListAccessor)\n- [0.6.0](/python/docs/reference/bigframes/0.6.0/bigframes.operations.lists.ListAccessor)\n- [0.5.0](/python/docs/reference/bigframes/0.5.0/bigframes.operations.lists.ListAccessor)\n- [0.4.0](/python/docs/reference/bigframes/0.4.0/bigframes.operations.lists.ListAccessor)\n- [0.3.0](/python/docs/reference/bigframes/0.3.0/bigframes.operations.lists.ListAccessor)\n- [0.2.0](/python/docs/reference/bigframes/0.2.0/bigframes.operations.lists.ListAccessor) \n\n ListAccessor(\n data=None,\n index: vendored_pandas_typing.Axes | None = None,\n dtype: typing.Optional[\n bigframes.dtypes.DtypeString | bigframes.dtypes.Dtype\n ] = None,\n name: str | None = None,\n copy: typing.Optional[bool] = None,\n *,\n session: typing.Optional[bigframes.session.Session] = None\n )\n\nAccessor object for list data properties of the Series values.\n\nMethods\n-------\n\n### __getitem__\n\n __getitem__(key: typing.Union[int, slice]) -\u003e bigframes.series.Series\n\nIndex or slice lists in the Series.\n\n**Examples:** \n\n \u003e\u003e\u003e import bigframes.pandas as bpd\n \u003e\u003e\u003e import pyarrow as pa\n \u003e\u003e\u003e bpd.options.display.progress_bar = None\n \u003e\u003e\u003e s = bpd.Series(\n ... [\n ... [1, 2, 3],\n ... [3],\n ... ],\n ... dtype=bpd.ArrowDtype(pa.list_(pa.int64())),\n ... )\n \u003e\u003e\u003e s.list[0]\n 0 1\n 1 3\n dtype: Int64\n\n### len\n\n len()\n\nCompute the length of each list in the Series.\n\n**See Also:** \n\n - `StringMethods.len` : Compute the length of each element in the Series/Index.\n\n**Examples:** \n\n \u003e\u003e\u003e import bigframes.pandas as bpd\n \u003e\u003e\u003e import pyarrow as pa\n \u003e\u003e\u003e bpd.options.display.progress_bar = None\n \u003e\u003e\u003e s = bpd.Series(\n ... [\n ... [1, 2, 3],\n ... [3],\n ... ],\n ... dtype=bpd.ArrowDtype(pa.list_(pa.int64())),\n ... )\n \u003e\u003e\u003e s.list.len()\n 0 3\n 1 1\n dtype: Int64"]]