你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

InputStream 类

表示输入 Blob 的类似文件的对象。

继承
InputStream
InputStream

构造函数

InputStream()

方法

close

刷新并关闭 IO 对象。

如果文件已关闭,此方法不起作用。

detach

断开此缓冲区与其基础原始流的连接,并返回它。

分离原始流后,缓冲区将处于不可用状态。

fileno

返回基础文件描述符(如果存在)。

如果 IO 对象不使用文件描述符,则会引发 OSError。

flush

刷新写入缓冲区(如果适用)。

对于只读和非阻塞流,不实现此操作。

isatty

返回此流是否为“交互式”流。

如果无法确定,则返回 False。

read

返回并读取最大 字节大小

read1

读取并返回最多 n 个字节,最多对基础原始流进行一次读取 () 调用。 简短的结果并不意味着 EOF 迫在眉睫。

返回 EOF 上的空字节对象。

readable

返回对象是否已打开以供读取。

如果为 False,则读取 () 将引发 OSError。

readinto
readinto1
readline

从流中读取并返回一行。

如果指定了大小,则最多读取大小字节。

对于二进制文件,行终止符始终为 b'n';对于文本文件,可以使用要打开的 newlines 参数来选择 () 识别的行终止符。

readlines

从流中返回行列表。

可以指定 hint 来控制读取的行数:如果到目前为止所有行的总大小 (字节/字符) 数超过提示,则不会再读取行。

seek

更改流位置。

将流位置更改为给定字节偏移量。 偏移量相对于 whence 指示的位置进行解释。 whence 的值为:

  • 0 – (默认) 开始流;偏移量应为零或正

  • 1 – 当前流位置;偏移量可以为负数

  • 2 – 流结束;偏移量通常为负

返回新的绝对位置。

seekable

返回 对象是否支持随机访问。

如果为 False,则 seek () 、tell () 和 truncate () 将引发 OSError。 此方法可能需要执行测试查找 () 。

tell

返回当前流位置。

truncate

截断文件以调整字节大小。

文件指针保持不变。 大小默认为通过 tell () 报告的当前 IO 位置。 返回新大小。

writable

返回是否打开对象进行写入。

如果为 False,则 write () 将引发 OSError。

write

将给定缓冲区写入 IO 流。

返回写入的字节数,始终是 b 的长度(以字节为单位)。

如果缓冲区已满且基础原始流目前无法接受更多数据,则引发 BlockingIOError。

writelines

编写要流式传输的行列表。

不添加行分隔符,因此提供的每一行通常都有一个行分隔符。

close

刷新并关闭 IO 对象。

如果文件已关闭,此方法不起作用。

close()

detach

断开此缓冲区与其基础原始流的连接,并返回它。

分离原始流后,缓冲区将处于不可用状态。

detach()

fileno

返回基础文件描述符(如果存在)。

如果 IO 对象不使用文件描述符,则会引发 OSError。

fileno()

flush

刷新写入缓冲区(如果适用)。

对于只读和非阻塞流,不实现此操作。

flush()

isatty

返回此流是否为“交互式”流。

如果无法确定,则返回 False。

isatty()

read

返回并读取最大 字节大小

abstract read(size=-1) -> bytes

参数

size
int
默认值: -1

要读取的字节数。 如果省略参数、 None或负参数,则读取并返回数据,直到达到 EOF。

返回

从输入流读取的字节数。

read1

读取并返回最多 n 个字节,最多对基础原始流进行一次读取 () 调用。 简短的结果并不意味着 EOF 迫在眉睫。

返回 EOF 上的空字节对象。

read1()

readable

返回对象是否已打开以供读取。

如果为 False,则读取 () 将引发 OSError。

readable()

readinto

readinto(buffer, /)

参数

buffer
必需

readinto1

readinto1(buffer, /)

参数

buffer
必需

readline

从流中读取并返回一行。

如果指定了大小,则最多读取大小字节。

对于二进制文件,行终止符始终为 b'n';对于文本文件,可以使用要打开的 newlines 参数来选择 () 识别的行终止符。

readline(size=-1, /)

参数

size
默认值: -1

readlines

从流中返回行列表。

可以指定 hint 来控制读取的行数:如果到目前为止所有行的总大小 (字节/字符) 数超过提示,则不会再读取行。

readlines(hint=-1, /)

参数

hint
默认值: -1

seek

更改流位置。

将流位置更改为给定字节偏移量。 偏移量相对于 whence 指示的位置进行解释。 whence 的值为:

  • 0 – (默认) 开始流;偏移量应为零或正

  • 1 – 当前流位置;偏移量可以为负数

  • 2 – 流结束;偏移量通常为负

返回新的绝对位置。

seek()

seekable

返回 对象是否支持随机访问。

如果为 False,则 seek () 、tell () 和 truncate () 将引发 OSError。 此方法可能需要执行测试查找 () 。

seekable()

tell

返回当前流位置。

tell()

truncate

截断文件以调整字节大小。

文件指针保持不变。 大小默认为通过 tell () 报告的当前 IO 位置。 返回新大小。

truncate()

writable

返回是否打开对象进行写入。

如果为 False,则 write () 将引发 OSError。

writable()

write

将给定缓冲区写入 IO 流。

返回写入的字节数,始终是 b 的长度(以字节为单位)。

如果缓冲区已满且基础原始流目前无法接受更多数据,则引发 BlockingIOError。

write()

writelines

编写要流式传输的行列表。

不添加行分隔符,因此提供的每一行通常都有一个行分隔符。

writelines(lines, /)

参数

lines
必需

属性

closed

length

name

uri