Python2.7-csv

时间:2022-10-20 18:12:51

csv模块,用于读写 csv 文件,常用 reader 和 writer 对象进行操作

1、模块的类

1.1 Dialect 对象,设置 csv 文件的各种格式,包括分隔符,引用符,转义符等

1.1.1 对象属性

delimiter:单字符分隔符,默认','
quotechar:单字符引用符,当内容中包含特定字符时,如分隔符、引用符、换行符等,将内容用指定字符括起来,排除歧义,默认'"'
escapechar:单字符转义符,写文件时如果 quoting 为 QUOTE_NONE 则转义分隔符,如果 doublequote 为 False 则转义引用符。读文件时,可以正确识别转义后的内容。默认 None,不支持转义
doublequote:控制内容里出现了引用符时的操作,默认 True,引用符成倍出现,为 False 时,在引用符前加转义符
quoting:控制何时使用引用符,默认 QUOTE_MINIMAL,模块内还定义了其他 QUOTE_* 常量
lineterminator:写文件时指定换行符,默认 '\r\n'
skipinitialspace:默认 False,不忽略分隔符后的空格
strict:默认 False,输入 csv 损坏时不抛出异常

1.2 reader 对象

1.2.1 初始化构建类:reader(csvfile, dialect='excel', **fmtparams)

参数设置:
csvfile:要打开读取的文件对象或是列表对象,只要每次迭代可以返回一个字符串,文件对象用‘b’模式打开能避免不同平台产生错误
dialect:设置 csv 文件的格式,是 Dialect 类的一个子类
fmtparams:也用于设置格式,可以覆盖 dialect 的设置

1.2.2 实例方法

next():列表形式返回下一行数据

1.2.3 对象属性

dialect:只读的 dialect 描述
line_num:从源迭代器读到的行数

1.3 writer 对象

1.3.1 初始化构建类:writer(csvfile, dialect='excel', **fmtparams),参数设置同 reader 对象

1.3.2 实例方法

writerow(row):写一行,格式根据指定的 dialect
writerows(rows):写许多行

1.3.3 对象属性

dialect:只读的 dialect 描述

1.4 DictReader 对象,本质上是 reader 对象的子类

1.4.1 初始化构建类:DictReader(f, fieldnames=None, restkey=None, restval=None, dialect='excel', *args, **kwds),将文件内容读入一个字典中

参数设置:
f:文件对象
fieldnames:字典的键值,如果省略了,就以文件第一行作为字典键值
restkey:键个数少于一行中内容数,多余内容就被加入到 restkey 中
restval:键个数多于一行中内容数,剩余键对应值用 restval 代替
dialect、args、kwds:设置格式,会传入 reader 对象里

1.4.2 实例方法,同 reader 对象

1.4.3 对象额外属性

fieldnames:字典键值

1.5 DictWriter 对象,本质上是 writer 对象的子类

1.5.1 初始化构建类:DictWriter(f, fieldnames, restval='', extrasaction='raise', dialect='excel', *args, **kwds),将内容根据字典对应写入文件中

参数设置:
f:文件对象
fieldnames:字典的键值
restval:内容里缺少了一些键-值,缺少的键-值用 restval 代替
extrasaction:内容里有不包含在 fieldnames 里的键,设置 'raise' 抛出异常,'ignore' 忽略多出来的内容
dialect、args、kwds:设置格式,会传入 writer 对象里

1.5.2 实例额外方法

writeheader():输出包含内容名的一行

1.5.3 对象属性,同 writer 对象

1.6 excel 对象,定义了通常情况下 excel 生成的 csv 文件格式,dialect 名 'excel'

1.7 excel_tab 对象,定义了通常情况下 excel 生成的用 tab 分割的 csv 文件格式,dialect 名 'excel-tab'

1.8 Sniffer 对象,用于推断 csv 文件格式

1.8.1 实例方法

sniff(sample, delimiters=None):分析给定样本,返回拥有找到的参数的值的 Dialect 对象,delimiter 指定时,样本内容会根据指定值分割
has_header(sample):分析样本文本,假设成 csv 格式,判断第一行是否是一系列的标题

2、模块常量

csv.QUOTE_ALL:指定 writer 对象对所有内容都加上引用符
csv.QUOTE_MINIMAL:指定 writer 对象只对出现特定字符的内容加引用符
csv.QUOTE_NONNUMERIC:指定 writer 对象对所有非数字内容加引用符,指定 reader 对象把所有没加引用符的内容转换成 float 类型
csv.QUOTE_NONE:指定 writer 对象不对任何内容加引用符,当内容中出现了分隔符用转义字符标注,未定义转义字符则抛异常,指定 reader 对象不做任何引用符的预处理

3、模块方法

csv.register_dialect(name, [dialect, ]**fmtparams):把特定格式与 name 绑定
csv.unregister_dialect(name):删除格式与 name 的绑定
csv.get_dialect(name):返回指定 name 的格式
csv.list_dialects():返回所有绑定的名字
csv.field_size_limit([new_limit]):返回当前每个内容允许的最大大小,给定 new_limit 则改成指定值

相关文章