os - 操作系统

2023-11-01

这个模块实现了相应 CPython 模块的一个子集，如下所述。有关更多信息，请参阅原始CPython文档: os

os 模块包含文件系统访问和 urandom 功能

一般功能

os.uname()

返回一个元组(可能是一个命名元组)，其中包含关于底层和/或其操作系统的信息。元组有五个字段，每个字段的顺序如下:

  • sysname -- 底层系统的名称
  • nodename -- 网络名称（和sysname相同）
  • release -- 底层系统的版本
  • version -- MiroPython版本和构建日期
  • machine --底层硬件的标识符(eg board, CPU)

示例:

>>> import os
>>> os.uname()
(sysname='esp32', nodename='esp32', release='1.9.1', version='v1.9.1-224-g83d3f3f-dirty on 2017-12-12', machine='ESP32 module with ESP32')

os.urandom(n)

返回一个带有n个随机字节的字节对象。它是由硬件随机数生成器生成。

示例:

>>> os.urandom(20)
b'f\x92\x85t28\xa1\xf0\xaf3\xf5\xd9\xcdx\xc3\n\xedm\xf8\xb7'

文件系统访问

os.getcwd()

获取当前目录。

os.chdir(path)

更改当前目录。

示例:

>>> os.getcwd()
'/'
>>> os.chdir("./lib")
>>> os.getcwd()
'/lib'
>>> os.chdir("..")
>>> os.getcwd()
'/'

os.ilistdir([dir])

此函数返回一个迭代器，然后生成与列出的目录中的条目对应的元组。没有参数，它列出了当前目录，否则它列出了dir给出的目录。

The 3-tuples have the form (name, type, inode):

  • name 是一个字符串（如果dir是一个字节对象，则为字节），并且是条目的名称;
  • type 是一个整数，指定条目的类型，目录为0x4000，常规文件为0x8000;
  • inode 是对应于文件inode的整数，对于没有这种概念的文件系统可以是0。

目前条目的含义目前尚未定义。

os.listdir([dir])

如果没有参数，请列出当前目录。否则列出给定目录。

示例:

>>> os.listdir()
['boot.py', 'lib']
>>> os.listdir("./lib")
['test.py']

os.mkdir(path)

创建目录，path为创建目录的路径。

示例:

>>> os.listdir()
['boot.py']
>>> path = "./lib"
>>> os.mkdir(path)
>>> os.listdir()
['boot.py', 'lib']

os.rmdir(path)

删除目录。

示例:

>>> os.listdir()
['boot.py', 'lib']
>>> os.rmdir("./lib")
>>> os.listdir()
['boot.py']

os.remove(path)

删除文件。

示例:

>>> os.listdir("./lib")
['test.py']
>>> os.remove("./lib/test.py")
>>> os.listdir("./lib")
[]

os.rename(old_path, new_path)

重命名文件。

示例:

>>> os.listdir(os.getcwd())
['test.py']
>>> os.rename("test.py", "mytest.py")
>>> os.listdir(os.getcwd())
['mytest.py']

os.stat(path)

获取文件或目录的状态。

示例:

>>> os.stat("./lib")
(16384, 0, 0, 0, 0, 0, 0, 0, 0, 0)
>>> os.stat("./lib/test.py")
(32768, 0, 0, 0, 0, 0, 1, 0, 0, 0)

os.statvfs(path)

获取文件系统的状态。

返回包含以下顺序的文件系统信息的元组：

  • f_bsize -- 文件系统块大小
  • f_frsize -- 片段大小
  • f_blocks --f_frsize单位的fs大小
  • f_bfree -- free blocks数量
  • f_bavail -- number of free blocks for unpriviliged users
  • f_files -- inodes数量
  • f_ffree -- number of free inodes
  • f_favail -- number of free inodes for unpriviliged users
  • f_flag -- mount flags
  • f_namemax -- 最大文件名长度

相关信息节点参数： f_files ，f_ffree ，f_avail 和 f_flags 参数可能会返回0。

os.sync()

同步所有文件系统。

os.dupterm(stream_object, index=0)

复制或切换给定类似stream对象上的MicroPython终端（REPL）。该stream_object参数必须实现 readinto() 和 write() 方法。
流应处于非阻塞模式，如果没有可用于读取的数据， readinto() 则应返回 None 。

调用此函数后，将在此流上重复所有终端输出，并且流上可用的任何输入都将传递到终端输入。

所述索引参数应该是哪个复制时隙设置一个非负整数，并且指定。给定端口可以实现多个槽（槽0将始终可用），
并且在这种情况下，终端输入和输出在所有设置的槽上复制。

如果 None 作为 stream_object 传递，则在索引给出的槽上取消复制。

该函数返回给定槽中的上一个类似流的对象。