注意

这是最新开发分支配套的文档,可能包含已发布版本中尚未提供的功能。如果您要查看特定版本的文档,请使用左侧的下拉菜单并选择所需要的版本。

uos – 基本操作系统服务#

该模块提供了部分 CPython 操作系统模块的功能子集。有关详细信息,请参阅原始 CPython 文档:os

uos 模块包含用于文件系统的访问与挂载、终端重定向与复制,以及诸如 unameurandom 等系统信息和随机数生成函数。

函数#

基础功能#

uname#

uos.uname()

返回一个包含有关底层机器及其操作系统信息的元组。该元组包含以下五个字段,每个字段均为字符串:

  • sysname – 底层操作系统名称。

  • nodename – 节点名称(可能与 sysname 相同)。

  • release – 操作系统的版本号。

  • version – MicroPython 版本及构建日期。

  • machine – 硬件标识符(如主板型号、CPU 类型等)。

urandom#

uos.urandom(n)

生成并返回包含 n 个随机字节的字节对象。随机字节尽可能由硬件随机数生成器提供。

cpu_usage#

uos.cpu_usage()

返回当前系统 CPU 的使用率,范围为 0100

文件系统操作#

chdir#

uos.chdir(path)

更改当前工作目录。

getcwd#

uos.getcwd()

获取当前工作目录的路径。

ilistdir#

uos.ilistdir([dir])

返回指定目录(或当前目录)的条目信息。该函数生成一个元组迭代器,其中每个元组的形式为 (name, type, inode [, size])

  • name:条目名称,字符串类型。

  • type:条目类型,目录为 0x4000,普通文件为 0x8000

  • inode:文件系统的 inode 值,对于不支持 inode 的文件系统则为 0

  • size(可选):文件大小,若无法获取则为 -1

listdir#

uos.listdir([dir])

列出指定目录中的所有条目。如果未指定目录,则列出当前目录。

mkdir#

uos.mkdir(path)

在指定路径创建一个新目录。

remove#

uos.remove(path)

删除指定路径的文件。

rmdir#

uos.rmdir(path)

删除指定路径的目录。

rename#

uos.rename(old_path, new_path)

重命名指定路径的文件或目录。

stat#

uos.stat(path)

返回指定路径的文件或目录的状态信息。

statvfs#

uos.statvfs(path)

获取指定路径文件系统的状态,返回一个元组,包含以下字段:

  • f_bsize – 文件系统块大小。

  • f_frsize – 片段大小。

  • f_blocks – 文件系统总大小,以 f_frsize 为单位。

  • f_bfree – 空闲块数。

  • f_bavail – 非特权用户可用的空闲块数。

  • f_files – inode 总数。

  • f_ffree – 可用 inode 数量。

  • f_favail – 非特权用户可用的 inode 数量。

  • f_flag – 挂载标志。

  • f_namemax – 最大文件名长度。

目前仅 f_bsizef_blocksf_bfree 有效

sync#

uos.sync()

同步所有文件系统,将挂起的写操作写入存储设备。

dupterm#

uos.dupterm(stream_object, index = 0)

在指定的 stream 对象上复制或切换 MicroPython 终端(REPL)。stream_object 必须实现 readinto()write() 方法。stream 应以非阻塞模式运行,readinto() 在没有可读数据时应返回 None

调用后,所有终端输出将被复制到该流对象,同时该流上提供的任何输入也将被传递到终端。index 参数应为非负整数,指定要设置的复制槽。

如果 stream_objectNone,则取消指定槽的终端复制。

返回先前在指定槽中的流对象。

评论列表
条评论
登录