pandas.DataFrame.itertuples#

DataFrame.itertuples(index=True, name='Pandas')[源代码]#

将DataFrame行作为命名元组进行迭代。

参数

index布尔值，默认为True: 如果为True，则将索引作为元组的第一个元素返回。
name字符串或无，默认为“Pandas”: 返回的命名元组的名称，或返回常规元组的None。

退货

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

参见

DataFrame.iterrows: 将DataFrame行作为(索引，系列)对进行迭代。
DataFrame.items: 迭代(列名，系列)对。

注意事项

如果列名称是无效的、重复的或以下划线开头的，则列名称将重命名为位置名称。

示例

>>> 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)

pandas.DataFrame.iterrows

pandas.DataFrame.join