Python2.7-io

io 模块，用于处理流数据，在 python2 下，是内置 file 对象的另一种选择，在 python3 下，此模块是默认的文件和流数据的接口。

1、模块继承关系

IOBase
--RawIOBase
----FileIO
--BufferedIOBase
----BufferedWriter
----BufferedReader
----BufferedRWPair
----BufferedRandom
----BytesIO
--TextIOBase
----TextIOWrapper
------StringIO

2、模块属性

io.DEFAULT_BUFFER_SIZE：模块进行 I/O 时的默认缓存大小

3、模块方法

io.open(file, mode='r', buffering=-1, encoding=None, errors=None, newline=None, closefd=True)：打开一个文件

参数设置：
file：文件路径或文件描述符
mode：文件打开方式，有 r/w/a/b/t/+/U，默认‘rt’
buffering：0 关闭缓存（只能在二进制模式下），1 表示线性缓存（只能在文本模式下），大于1 表示设置缓冲区大小
encoding：文件的编码
errors：编码遇到错误时的处理
newline：控制换行符
closefd：用文件描述符打开文件时，设置为True，关闭文件对象同时关闭文件描述符

4、模块异常

io.BlockingIOError：对非阻塞（non-blocking）流进行了阻塞
io.UnsupportedOperation：对流进行了不支持的操作

5、模块的类

5.1 IOBase 基类，不能直接构建，是所有类的抽象基类

5.1.1 类的方法

flush()：更新缓冲区数据至流，对只读和非阻塞流无效
close()：更新并关闭流
fileno()：返回文件描述符，如果不是用文件描述符打开的抛出 IOError
isatty()：判断流是否和终端相连
readable()：判断流是否可被读取
writable()：判断流是否支持写
seekable()：判断流是否支持随机访问
readline(limit=-1)：读一行数据，最多 limit 字节
readlines(hint=-1)：读 hint 行数据
writelines(lines)：向流写入数据
seek(offset[, whence])：同内置文件对象 open 后的 seek
tell()：返回当前流中的位置
truncate(size=None)：截取流的 size 字节，为 none 时以当前位置为准
__del__()：析构函数，销毁对象

5.1.2 类的属性

closed：返回流是否被关闭

5.2 RawIOBase，raw binary I/O 的基类，不能直接构建，继承于 IOBase

5.2.1 类的额外方法

read(n=-1)：读 n 个字节并返回，默认的会执行 readall()
readall()：读取并返回流中所有字节
readinto(b)：从流中读取 b 长度的字节并赋值给 b，b 是预先申请过地址的可写对象
write(b)：将 b 写入流中

5.3 BufferedIOBase，支持缓存的二进制流的基类，不能直接构建，继承于 IOBase，同 RawIOBase 的主要区别在于读写时会尽可能多的处理数据

5.3.1 类的额外方法

detach()：将正在处理的流从缓冲区中分离出来并返回，然后缓冲区会出于一个不可用状态
read(n=-1)：读 n 个字节并返回，默认的会读完整个流
read1(n=-1)：读 n 个字节并返回，但只会执行一次
readinto(b)：从流中读取 b 长度的字节并赋值给 b，b 是预先申请过地址的可写对象
write(b)：将 b 写入流中

5.4 FileIO 对象，继承自 RawIOBase

5.4.1 初始化实例：FileIO(name, mode='r', closefd=True)

参数设置：
name：文件名或文件描述符
mode：文件打开方式，同模块方法
closefd：同模块方法

5.4.2 类的额外属性

mode：返回构造时的参数
name：返回文件名或文件描述符

5.5 BytesIO 对象，继承自 BufferedIOBase，根据内存字节缓冲区实现的流

5.5.1 初始化实例：BytesIO([initial_bytes])

参数设置：
initial_bytes：包含初始化信息的 bytes 对象

5.5.2 类的额外方法

getvalue()：返回缓冲区内所有数据
read1()：同read()

5.6 BufferedReader 对象，继承自 BufferedIOBase，更高层的用于读的缓冲区对象

5.6.1 初始化实例：BufferedReader(raw, buffer_size=DEFAULT_BUFFER_SIZE)

参数设置：
raw：包含初始化信息的流
buffer_size：缓冲区大小

5.6.2 类的额外方法

peek([n])：返回 n 字节数据，保持流的位置不动
read([n])：读取并返回 n 字节数据
read1(n=-1)：读 n 个字节并返回，但只会执行一次

5.7 BufferedWriter 对象，继承自 BufferedIOBase，更高层的用于写的缓冲区对象

5.7.1 初始化实例：BufferedWriter(raw, buffer_size=DEFAULT_BUFFER_SIZE)

参数设置：
raw：包含初始化信息的流
buffer_size：缓冲区大小

5.7.2 类的额外方法

flush()：将缓冲区数据更新至流中
write(b)：向缓冲区写入 b，并返回写入字节数

5.8 BufferedRandom 对象，继承自 BufferedIOBase，支持随机读写的缓冲区对象

5.8.1 初始化实例：BufferedRandom(raw, buffer_size=DEFAULT_BUFFER_SIZE)

参数设置：
raw：包含初始化信息的流
buffer_size：缓冲区大小

5.9 BufferedRWPair 对象，继承自 BufferedIOBase，支持读写的缓冲区对象

5.9.1 初始化实例：BufferedRWPair(reader, writer, buffer_size=DEFAULT_BUFFER_SIZE)

参数设置：
reader：可读对象
writer：可写对象
buffer_size：缓冲区大小

5.10 TextIOBase，文本流的基类，不能直接构建，继承自 IOBase

5.10.1 类的额外方法

detach()：将正在处理的流从缓冲区中分离出来并返回，然后缓冲区会出于一个不可用状态
read(n)：读 n 个字符并返回，默认的会读完整个流
readline(limit=-1)：读一行并返回一个 unicode 对象，limit 设置读的字符数
write(s)：将字符串 s 写入流中

5.11 TextIOWrapper，继承自 TextIOBase，缓冲区文本流

5.11.1 初始化实例：TextIOWrapper(buffer, encoding=None, errors=None, newline=None, line_buffering=False)

参数设置：
buffer：缓冲区信息
encoding：文件的编码
errors：编码遇到错误时的处理
newline：控制换行符
line_buffering：为 True 时，每次遇到换行符都执行一次 flush，更新数据至流

5.12 StringIO，继承自 TextIOWrapper，内存文本流

5.12.1 初始化实例：StringIO(initial_value=u'', newline=u'\n')

参数设置：
initial_value：初始数据
newline：控制换行符

5.12.2 类的额外方法

getvalue()：返回缓冲区内所有数据