📒 表头的使用

本节介绍表头相关内容。只有 xlsx、csv 和 db 文件支持使用表头（其中 db 文件只支持读取和设置自动更新表头，不能设置表头和表头行）。

写入数据时，可根据表头自动匹配列，读取数据时，可根据表头生成dict数据。

✅️ `header`属性

Recorder对象的header属性获取当前文件（数据表）的表头。

表头是个字典，格式是{列序号: 表头值}。
如{1: '序号', 2: '姓名', 3: '性别', 4: '年龄'}。

xlsx 文件每个数据表有各自对应的表头。

示例，有如下 csv 文件：

序号	姓名	性别	年龄
1	张三	男	20
2	李四	女	21

from DrissionRecord import Recorder

r = Recorder('data.csv')
print(r.header)

打印结果：

{1: '序号', 2: '姓名', 3: '性别', 4: '年龄'}

默认情况下，Recorder读取文件时会自动从设置的行获取表头（初始第 1 行）。

可通过set.header_row()设置表头行号。

如果设置为0，以列号为表头值，如'A'。

💡 set.header_row()

参数名称	类型	默认值	说明
`num`	`int`	必填	行号，设置`0`时以列号为表头值
`table`	`str` `None` `True`	`None`	表名，仅 xlsx 文件生效，为`True`表示活动数据表，为`None`表示不改变设置

返回类型	说明
`Setter`	设置对象

可以用set.header()手动设置Recorder对象的表头。

可选择是否同时写入文件，写入文件时，会用新表头替换指定行数据。

支持 xlsx 和 csv 格式文件。

💡 set.header()

参数名称	类型	默认值	说明
`header`	`list` `tuple`	必填	表头值组成的列表
`to_file`	`bool`	`True`	是否写入到文件
`row`	`int`	`None`	指定写入文件的行号，不改变对象已设置的`header_row`属性，`to_file`不为`True`时无效
`table`	`str` `None` `True`	`None`	表名，只 xlsx 格式文件有效，为`True`表示活动数据表，为`None`表示不改变设置

返回类型	说明
`Setter`	设置对象

from DrissionRecord import Recorder

r = Recorder('data.csv')
r.set.header(['序号', '姓名', '性别', '年龄'])

在录入dict数据时，数据中有表头不存在的列，可使用set.auto_new_header()设置自动添加到表头。

此设置初始时是False。

支持 xlsx、csv、db 文件。

💡 set.auto_new_header()

参数名称	类型	默认值	说明
`on_off`	`bool`	`True`	开或关

返回类型	说明
`Setter`	设置对象

from DrissionRecord import Recorder

r = Recorder('data.xlsx')
r.set.auto_new_header(True)