:mod:`os` -- 基本的操作系统
.. module:: os :synopsis: 操作系统
这个模块实现了相应 :term:`CPython` 模块的一个子集,如下所述。有关更多信息,请参阅原始CPython文档: os
该uos模块包含文件系统访问和安装,终端重定向和复制 uname
以及 urandom
功能的功能。
.. function:: 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')
.. function:: urandom(n)
返回一个带有n个随机字节的字节对象。它是由硬件随机数生成器生成。
示例:
>>> os.urandom(20) b'f\x92\x85t28\xa1\xf0\xaf3\xf5\xd9\xcdx\xc3\n\xedm\xf8\xb7'
.. function:: getcwd()
获取当前目录。
.. function:: chdir(path)
更改当前目录。
示例:
>>> os.getcwd() '/' >>> os.chdir("./lib") >>> os.getcwd() '/lib' >>> os.chdir("..") >>> os.getcwd() '/'
.. function:: ilistdir([dir])
此函数返回一个迭代器,然后生成与列出的目录中的条目对应的元组。没有参数,它列出了当前目录,否则它列出了dir给出的目录。
The 3-tuples have the form (name, type, inode):
- name 是一个字符串(如果dir是一个字节对象,则为字节),并且是条目的名称;
- type 是一个整数,指定条目的类型,目录为0x4000,常规文件为0x8000;
- inode 是对应于文件inode的整数,对于没有这种概念的文件系统可以是0。
目前条目的含义目前尚未定义。
.. function:: listdir([dir])
如果没有参数,请列出当前目录。否则列出给定目录。
- 示例::
>>> os.listdir() ['boot.py', 'lib'] >>> os.listdir("./lib") ['test.py']
.. function:: mkdir(path)
创建目录,path为创建目录的路径。
示例:
>>> os.listdir() ['boot.py'] >>> path = "./lib" >>> os.mkdir(path) >>> os.listdir() ['boot.py', 'lib']
.. function:: rmdir(path)
删除目录。
示例:
>>> os.listdir() ['boot.py', 'lib'] >>> os.rmdir("./lib") >>> os.listdir() ['boot.py']
.. function:: remove(path)
删除文件。
示例:
>>> os.listdir("./lib") ['test.py'] >>> os.remove("./lib/test.py") >>> os.listdir("./lib") []
.. function:: rename(old_path, new_path)
重命名文件。
示例:
>>> os.listdir(os.getcwd()) ['test.py'] >>> os.rename("test.py", "mytest.py") >>> os.listdir(os.getcwd()) ['mytest.py']
.. function:: 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)
.. function:: statvfs(path)
获取文件系统的状态。
返回包含以下顺序的文件系统信息的元组:
f_bsize
-- 文件系统块大小f_frsize
-- 片段大小f_blocks
-- f_frsize单位的fs大小f_bfree
-- free blocks数量f_bavail
-- number of free blocks for unpriviliged usersf_files
-- inodes数量f_ffree
-- number of free inodesf_favail
-- number of free inodes for unpriviliged usersf_flag
-- mount flagsf_namemax
-- 最大文件名长度
相关信息节点参数: f_files
,f_ffree
,f_avail
和 f_flags
参数可能会返回0。
.. function:: sync()
同步所有文件系统。
.. function:: dupterm(stream_object, index=0)
复制或切换给定类似 stream
对象上的MicroPython终端(REPL)。所述 stream_object 参数必须是一个本地流对象,或从导出 uio.IOBase
并实施 readinto()
和 write()
方法。流应处于非阻塞模式,如果没有可用于读取的数据, readinto()
则应返回 None
。
调用此函数后,将在此流上重复所有终端输出,并且流上可用的任何输入都将传递到终端输入。
所述索引参数应该是哪个复制时隙设置一个非负整数,并且指定。给定端口可以实现多个槽(槽0将始终可用),并且在这种情况下,终端输入和输出在所有设置的槽上复制。
如果 None
作为 stream_object 传递,则在索引给出的槽上取消复制。
该函数返回给定槽中的前一个类似流的对象。
提供虚拟文件系统(VFS)以及在此VFS中安装多个“真实”文件系统的功能。文件系统对象可以安装在VFS的根目录中,也可以安装在根目录中的子目录中。
这允许Python程序看到的文件系统的动态和灵活配置。提供 mount()
和 umount()
功能,以及可能由VFS类表示的各种文件系统实现。
.. function:: mount(fsobj, mount_point, \*, readonly) 将文件系统对象 `fsobj` 挂载到mount_point字符串指定的VFS中的位置。 fsobj可以是具有 ``mount()`` 方法或块设备的VFS对象。如果它是块设备,则会自动检测文件系统类型(如果未识别文件系统,则会引发异常)。 `mount_point` 可以是在根目录下'/'挂载 `fsobj` ,也'/<name>'可以将它挂载在根目录下的子目录中。
如果是 readonly 为 True 则文件系统以只读方式挂载。
在挂载过程中,将 mount()
在文件系统对象上调用该方法。
OSError(EPERM)
如果 mount_point 已经安装,则会引发。
.. function:: umount(mount_point) 卸载文件系统。`mount_point` 可以是命名安装位置的字符串,也可以是先前安装的文件系统对象。在卸载过程中,将 `umount()` 在文件系统对象上调用该方法。
OSError(EINVAL)
如果找不到 mount_point ,则会引发。
创建使用 FAT 文件系统格式的文件系统对象。FAT文件系统的存储由 block_dev 提供。可以使用此构造函数创建的对象 mount()
。
.. staticmethod:: mkfs(block_dev) 在 `block_dev` 上构建FAT文件系统。