pandas.DataFrame.itertuples

DataFrame.itertuples(index=True, name='Pandas')

将DataFrame行迭代为命名元组。

Parameters:

indexbool, default True

如果为 True，则返回索引作为元组的第一个元素。

namestr 或 None，默认为 “Pandas”

返回的命名元组的名称，或者为 None 返回常规元组。

Returns:

迭代器

一个用于迭代 DataFrame 中每一行命名元组的对象，其中第一个字段可能是索引，后续字段是列值。

参见

DataFrame.iterrows

迭代DataFrame行作为（索引，Series）对。

DataFrame.items

迭代（列名，Series）对。

Notes

如果列名是无效的 Python 标识符、重复或以下划线开头，则会被重命名为位置名称。

Examples

>>> df = pd.DataFrame({'num_legs': [4, 2], 'num_wings': [0, 2]},
...                   index=['dog', 'hawk'])
>>> df
      num_legs  num_wings
dog          4          0
hawk         2          2
>>> for row in df.itertuples():
...     print(row)
...
Pandas(Index='dog', num_legs=4, num_wings=0)
Pandas(Index='hawk', num_legs=2, num_wings=2)

通过将 index 参数设置为 False，我们可以将索引从元组的第一个元素中删除：

>>> for row in df.itertuples(index=False):
...     print(row)
...
Pandas(num_legs=4, num_wings=0)
Pandas(num_legs=2, num_wings=2)

设置 name 参数后，我们可以为生成的命名元组设置自定义名称：

>>> for row in df.itertuples(name='Animal'):
...     print(row)
...
Animal(Index='dog', num_legs=4, num_wings=0)
Animal(Index='hawk', num_legs=2, num_wings=2)