uio – 输入/输出流

• 概要
• uio API详解
  • 函数
    • uio.open(name, mode='r', **kwargs)
  • 类
    • class uio.FileIO(...)
    • class uio.TextIOWrapper(...)
    • class uio.StringIO([string])
    • class uio.BytesIO([string])
    • class uio.StringIO(alloc_size)
    • class uio.BytesIO(alloc_size)

概要

  此模块包含其他类型的“流”（类似文件）对象和辅助函数。

uio API详解

函数

uio.open(name, mode='r', **kwargs)

  函数说明：打开一个文件。内置的 open() 函数别名为此函数。所有端口（提供对文件系统的访问）都需要支持 mode 参数，但对其他参数的支持因端口而异。

示例：

>>>import uio
>>>uio.open("test.txt",mode='r')
<io.TextIOWrapper>

类

class uio.FileIO(...)

  函数说明：这是一种以二进制模式打开的文件类型，例如使用 open(name, "rb")。您不应该直接实例化这个类。

示例：

>>>import uio
>>>uio.open("test.txt","rb")
<io.FileIO>

class uio.TextIOWrapper(...)

  函数说明：这是以文本模式打开的文件类型，例如使用 open(name, "rt")。您不应该直接实例化这个类。

示例：

>>>import uio
>>>uio.open("test.txt","rt")
<io.TextIOWrapper>

class uio.StringIO([string])

class uio.BytesIO([string])

  用于输入/输出的内存中类似文件的对象 StringIO 用于文本模式 I/O （类似于使用 “t” 修饰符打开的普通文件）BytesIO 用于二进制模式 I/O （类似于使用 “b” 修饰符打开的普通文件）。类文件对象的初始内容可以使用 string 参数指定（对于 StringIO 应该是普通字符串，对于 StringIO，应该是 bytes 对象）。所有常用的文件方法，如 read(), write(), seek(), flush(), close() 都可用于这些对象，此外，还有以下方法：

getvalue()

  获取保存数据的基础缓冲区的当前内容。

示例：

>>>import uio
>>>a = uio.StringIO("waffle mciro")
>>>a.read(6) # 向后读6个字符串此时指针指在第7位
'waffle'
>>>a.getvalue() # 获取保存数据的基础缓冲区的当前内容
'wafflemicro'
>>>a.write("-") # 向第7位写入 - 替换字符指针指向 第 8 位
1
>>>a.getvalue()
'waffle-mciro'
>>>a.read(6) # 向后读6个字符串此时指针指在第14位
'mciro'
>>>a.seek(0)# 将指针指向 0 位
0
>>>a.read(6)
'waffle'

class uio.StringIO(alloc_size)

class uio.BytesIO(alloc_size)

  创建一个空的 StringIO/BytesIO 对象，预分配为最多容纳 alloc_size 字节数。这意味着写入该数量的字节不会导致缓冲区的重新分配，因此不会出现内存不足的情况或导致内存碎片。这些构造函数是一个 MicroPython 扩展，建议仅在特殊情况下和系统级库中使用，而不是在最终用户应用程序中使用。