15.1. os
— 操作系统接口模块¶
该模块提供了一些方便使用操作系统相关功能的函数。 如果你是想读写一个文件,请参阅 open()
,如果你想操作路径,请参阅 os.path
模块,如果你想在命令行上读取所有文件中的所有行请参阅 fileinput
模块。 有关创建临时文件和目录的方法,请参阅 tempfile
模块,对于高级文件目录处理,请参阅 shutil
模块。
关于这些函数的适用性的说明:
所有 Python 内建的操作系统相关的模块的设计都是为了使得在同一功能可用的情况下,保持接口的一致性;例如,函数
os.stat(path)
以相同的格式返回关于 path 的统计信息(这个函数同时也是起源于 POSIX 接口)。针对特定的操作的拓展同样在可用于
os
模块,但是使用它们必然会对可移植性产生威胁。An “Availability: Unix” note means that this function is commonly found on Unix systems. It does not make any claims about its existence on a specific operating system.
If not separately noted, all functions that claim “Availability: Unix” are supported on Mac OS X, which builds on a Unix core.
注解
All functions in this module raise OSError
in the case of invalid or
inaccessible file names and paths, or other arguments that have the correct
type, but are not accepted by the operating system.
-
os.
name
¶ The name of the operating system dependent module imported. The following names have currently been registered:
'posix'
,'nt'
,'os2'
,'ce'
,'java'
,'riscos'
.
15.1.1. 进程参数¶
这些函数和数据项提供了操作当前进程和用户的信息。
-
os.
environ
¶ 一个表示字符串环境的 mapping 对象。 例如,
environ['HOME']
是你的主目录(在某些平台上)的路径名,相当于 C 中的getenv("HOME")
。这个映射是在第一次导入
os
模块时捕获的,通常作为 Python 启动时处理site.py
的一部分。除了通过直接修改os.environ
之外,在此之后对环境所做的更改不会反映在os.environ
中。如果平台支持
putenv()
函数,这个映射除了可以用于查询环境外还能用于修改环境。 当这个映射被修改时,putenv()
将被自动调用。注解
直接调用
putenv()
并不会影响os.environ
,所以推荐直接修改``os.environ``。注解
在某些平台上,包括 FreeBSD 和 Mac OS X,设置
environ
可能导致内存泄露。参阅putenv()
的系统文档。如果平台没有提供
putenv()
, 为了使启动的子进程使用修改后的环境,一份修改后的映射会被传给合适的进程创建函数。如果平台支持
unsetenv()
函数,你可以通过删除映射中元素的方式来删除对应的环境变量。当一个元素被从os.environ
删除时,以及pop()
或clear()
被调用时,unsetenv()
会被自动调用。在 2.6 版更改: Also unset environment variables when calling
os.environ.clear()
andos.environ.pop()
.
-
os.
chdir
(path) -
os.
fchdir
(fd) -
os.
getcwd
() 以上函数请参阅 文件和目录 。
-
os.
ctermid
()¶ 返回与进程控制终端对应的文件名。
Availability: Unix.
-
os.
getegid
()¶ 返回当前进程的有效组ID。对应当前进程执行文件的 “set id” 位。
Availability: Unix.
-
os.
geteuid
()¶ 返回当前进程的有效用户ID。
Availability: Unix.
-
os.
getgid
()¶ 返回当前进程的实际组ID。
Availability: Unix.
-
os.
getgroups
()¶ 返回当前进程关联的附加组ID列表
Availability: Unix.
注解
在Mac OS X系统中,
getgroups()
会和其他 Unix 平台有些不同。如果 Python 解释器是在10.5
或更早版本中部署,getgroups()
返回当前用户进程相关的有效组ID列表。 该列表长度由于系统预设的接口限制,最长为 16。 而且在适当的权限下,返回结果还会因getgroups()
而发生变化;如果 Python 解释器是在10.5
以上版本中部署,getgroups()
返回进程所属有效用户 ID 所对应的用户的组 ID 列表,组用户列表可能因为进程的生存周期而发生变动,而且也不会因为setgroups()
的调用而发生,返回的组用户列表长度也没有长度 16 的限制。在部署中,Python 解释器用到的变量MACOSX_DEPLOYMENT_TARGET
可以用sysconfig.get_config_var()
。
-
os.
initgroups
(username, gid)¶ 调用系统 initgroups(),使用指定用户所在的所有值来初始化组访问列表,包括指定的组ID。
Availability: Unix.
2.7 新版功能.
-
os.
getlogin
()¶ Return the name of the user logged in on the controlling terminal of the process. For most purposes, it is more useful to use the environment variable
LOGNAME
to find out who the user is, orpwd.getpwuid(os.getuid())[0]
to get the login name of the process’s real user id.Availability: Unix.
-
os.
getpgid
(pid)¶ 根据进程id pid 返回进程的组 ID 列表。如果 pid 为 0,则返回当前进程的进程组 ID 列表
Availability: Unix.
2.3 新版功能.
-
os.
getpgrp
()¶ 返回当时进程组的ID
Availability: Unix.
-
os.
getpid
()¶ 返回当前进程ID
Availability: Unix, Windows.
-
os.
getppid
()¶ Return the parent’s process id.
Availability: Unix.
-
os.
getresuid
()¶ 返回一个由 (ruid, euid, suid) 所组成的元组,分别表示当前进程的真实用户ID,有效用户ID和暂存用户ID。
Availability: Unix.
2.7 新版功能.
-
os.
getresgid
()¶ 返回一个由 (rgid, egid, sgid) 所组成的元组,分别表示当前进程的真实组ID,有效组ID和暂存组ID。
Availability: Unix.
2.7 新版功能.
-
os.
getuid
()¶ 返回当前进程的真实用户ID。
Availability: Unix.
-
os.
getenv
(varname[, value])¶ Return the value of the environment variable varname if it exists, or value if it doesn’t. value defaults to
None
.Availability: most flavors of Unix, Windows.
-
os.
putenv
(varname, value)¶ Set the environment variable named varname to the string value. Such changes to the environment affect subprocesses started with
os.system()
,popen()
orfork()
andexecv()
.Availability: most flavors of Unix, Windows.
注解
在一些平台,包括 FreeBSD 和 Mac OS X,设置
environ
可能导致内存泄露。详情参考 putenv 相关系统文档。当系统支持
putenv()
时,os.environ
中的参数赋值会自动转换为对putenv()
的调用。不过putenv()
的调用不会更新os.environ
,因此最好使用os.environ
对变量赋值。
-
os.
setegid
(egid)¶ 设置当前进程的有效组ID。
Availability: Unix.
-
os.
seteuid
(euid)¶ 设置当前进程的有效用户ID。
Availability: Unix.
-
os.
setgid
(gid)¶ 设置当前进程的组ID。
Availability: Unix.
-
os.
setgroups
(groups)¶ 将 group 参数值设置为与当进程相关联的附加组ID列表。group 参数必须为一个序列,每个元素应为每个组的数字ID。该操作通常只适用于超级用户。
Availability: Unix.
2.2 新版功能.
注解
在 Mac OS X 中,groups 的长度不能超过系统定义的最大有效组 ID 个数,一般为 16。 如果它没有返回与调用 setgroups() 所设置的相同的组列表,请参阅
getgroups()
的文档。
-
os.
setpgrp
()¶ 根据已实现的版本(如果有)来调用系统
setpgrp()
或setpgrp(0, 0)
。相关说明,请参考 Unix 手册。Availability: Unix.
-
os.
setpgid
(pid, pgrp)¶ 使用系统调用
setpgid()
,将 pid 对应进程的组ID设置为 pgrp。相关说明,请参考 Unix 手册。Availability: Unix.
-
os.
setregid
(rgid, egid)¶ 设置当前进程的真实和有效组ID。
Availability: Unix.
-
os.
setresgid
(rgid, egid, sgid)¶ 设置当前进程的真实,有效和暂存组ID。
Availability: Unix.
2.7 新版功能.
-
os.
setresuid
(ruid, euid, suid)¶ 设置当前进程的真实,有效和暂存用户ID。
Availability: Unix.
2.7 新版功能.
-
os.
setreuid
(ruid, euid)¶ 设置当前进程的真实和有效用户ID。
Availability: Unix.
-
os.
getsid
(pid)¶ 调用系统调用
getsid()
。 相关语义请参阅 Unix 手册。Availability: Unix.
2.4 新版功能.
-
os.
setsid
()¶ 使用系统调用
getsid()
。相关说明,请参考 Unix 手册。Availability: Unix.
-
os.
setuid
(uid)¶ 设置当前进程的用户ID。
Availability: Unix.
-
os.
strerror
(code)¶ 根据 code 中的错误码返回错误消息。 在某些平台上当给出未知错误码时
strerror()
将返回NULL
并会引发ValueError
。Availability: Unix, Windows.
-
os.
umask
(mask)¶ 设定当前数值掩码并返回之前的掩码。
Availability: Unix, Windows.
-
os.
uname
()¶ Return a 5-tuple containing information identifying the current operating system. The tuple contains 5 strings:
(sysname, nodename, release, version, machine)
. Some systems truncate the nodename to 8 characters or to the leading component; a better way to get the hostname issocket.gethostname()
or evensocket.gethostbyaddr(socket.gethostname())
.Availability: recent flavors of Unix.
-
os.
unsetenv
(varname)¶ Unset (delete) the environment variable named varname. Such changes to the environment affect subprocesses started with
os.system()
,popen()
orfork()
andexecv()
.当系统支持
unsetenv()
,删除在os.environ
中的变量会自动转换为对unsetenv()
的调用。但是unsetenv()
不能更新os.environ
,因此最好直接删除os.environ
中的变量。Availability: most flavors of Unix, Windows.
15.1.2. 创建文件对象¶
These functions create new file objects. (See also open()
.)
-
os.
fdopen
(fd[, mode[, bufsize]])¶ Return an open file object connected to the file descriptor fd. The mode and bufsize arguments have the same meaning as the corresponding arguments to the built-in
open()
function. Iffdopen()
raises an exception, it leaves fd untouched (unclosed).Availability: Unix, Windows.
在 2.3 版更改: When specified, the mode argument must now start with one of the letters
'r'
,'w'
, or'a'
, otherwise aValueError
is raised.在 2.5 版更改: On Unix, when the mode argument starts with
'a'
, the O_APPEND flag is set on the file descriptor (which thefdopen()
implementation already does on most platforms).
-
os.
popen
(command[, mode[, bufsize]])¶ Open a pipe to or from command. The return value is an open file object connected to the pipe, which can be read or written depending on whether mode is
'r'
(default) or'w'
. The bufsize argument has the same meaning as the corresponding argument to the built-inopen()
function. The exit status of the command (encoded in the format specified forwait()
) is available as the return value of theclose()
method of the file object, except that when the exit status is zero (termination without errors),None
is returned.Availability: Unix, Windows.
2.6 版后已移除: This function is obsolete. Use the
subprocess
module. Check especially the Replacing Older Functions with the subprocess Module section.在 2.0 版更改: This function worked unreliably under Windows in earlier versions of Python. This was due to the use of the
_popen()
function from the libraries provided with Windows. Newer versions of Python do not use the broken implementation from the Windows libraries.
-
os.
tmpfile
()¶ Return a new file object opened in update mode (
w+b
). The file has no directory entries associated with it and will be automatically deleted once there are no file descriptors for the file.Availability: Unix, Windows.
There are a number of different popen*()
functions that provide slightly
different ways to create subprocesses.
2.6 版后已移除: All of the popen*()
functions are obsolete. Use the subprocess
module.
For each of the popen*()
variants, if bufsize is specified, it
specifies the buffer size for the I/O pipes. mode, if provided, should be the
string 'b'
or 't'
; on Windows this is needed to determine whether the
file objects should be opened in binary or text mode. The default value for
mode is 't'
.
Also, for each of these variants, on Unix, cmd may be a sequence, in which
case arguments will be passed directly to the program without shell intervention
(as with os.spawnv()
). If cmd is a string it will be passed to the shell
(as with os.system()
).
These methods do not make it possible to retrieve the exit status from the child
processes. The only way to control the input and output streams and also
retrieve the return codes is to use the subprocess
module; these are only
available on Unix.
For a discussion of possible deadlock conditions related to the use of these functions, see Flow Control Issues.
-
os.
popen2
(cmd[, mode[, bufsize]])¶ Execute cmd as a sub-process and return the file objects
(child_stdin, child_stdout)
.2.6 版后已移除: This function is obsolete. Use the
subprocess
module. Check especially the Replacing Older Functions with the subprocess Module section.Availability: Unix, Windows.
2.0 新版功能.
-
os.
popen3
(cmd[, mode[, bufsize]])¶ Execute cmd as a sub-process and return the file objects
(child_stdin, child_stdout, child_stderr)
.2.6 版后已移除: This function is obsolete. Use the
subprocess
module. Check especially the Replacing Older Functions with the subprocess Module section.Availability: Unix, Windows.
2.0 新版功能.
-
os.
popen4
(cmd[, mode[, bufsize]])¶ Execute cmd as a sub-process and return the file objects
(child_stdin, child_stdout_and_stderr)
.2.6 版后已移除: This function is obsolete. Use the
subprocess
module. Check especially the Replacing Older Functions with the subprocess Module section.Availability: Unix, Windows.
2.0 新版功能.
(Note that child_stdin, child_stdout, and child_stderr
are named from the
point of view of the child process, so child_stdin is the child’s standard
input.)
This functionality is also available in the popen2
module using functions
of the same names, but the return values of those functions have a different
order.
15.1.3. 文件描述符操作¶
这些函数对文件描述符所引用的 I/O 流进行操作。
文件描述符是一些小的整数,对应于当前进程所打开的文件。例如,标准输入的文件描述符通常是0,标准输出是1,标准错误是2。之后被进程打开的文件的文件描述符会被依次指定为3,4,5等。“文件描述符”这个词有点误导性,在 Unix 平台中套接字和管道也被文件描述符所引用。
The fileno()
method can be used to obtain the file descriptor
associated with a file object when required. Note that using the file
descriptor directly will bypass the file object methods, ignoring aspects such
as internal buffering of data.
-
os.
close
(fd)¶ 关闭文件描述符 fd。
Availability: Unix, Windows.
-
os.
closerange
(fd_low, fd_high)¶ Close all file descriptors from fd_low (inclusive) to fd_high (exclusive), ignoring errors. Equivalent to:
for fd in xrange(fd_low, fd_high): try: os.close(fd) except OSError: pass
Availability: Unix, Windows.
2.6 新版功能.
-
os.
dup
(fd)¶ Return a duplicate of file descriptor fd.
Availability: Unix, Windows.
-
os.
dup2
(fd, fd2)¶ Duplicate file descriptor fd to fd2, closing the latter first if necessary.
Availability: Unix, Windows.
-
os.
fchmod
(fd, mode)¶ Change the mode of the file given by fd to the numeric mode. See the docs for
chmod()
for possible values of mode.Availability: Unix.
2.6 新版功能.
-
os.
fchown
(fd, uid, gid)¶ Change the owner and group id of the file given by fd to the numeric uid and gid. To leave one of the ids unchanged, set it to -1.
Availability: Unix.
2.6 新版功能.
-
os.
fdatasync
(fd)¶ 强制将文件描述符 fd 指定文件写入磁盘。不强制更新元数据。
Availability: Unix.
注解
该功能在 MacOS 中不可用。
-
os.
fpathconf
(fd, name)¶ 返回与打开的文件有关的系统配置信息。name 指定要查找的配置名称,它可以是字符串,是一个系统已定义的名称,这些名称定义在不同标准(POSIX.1,Unix 95,Unix 98 等)中。一些平台还定义了额外的其他名称。当前操作系统已定义的名称在
pathconf_names
字典中给出。对于未包含在该映射中的配置名称,也可以传递一个整数作为 name。如果 name 是一个字符串且不是已定义的名称,将抛出
ValueError
异常。如果当前系统不支持 name 指定的配置名称,即使该名称存在于pathconf_names
,也会抛出OSError
异常,错误码为errno.EINVAL
。Availability: Unix.
-
os.
fstatvfs
(fd)¶ Return information about the filesystem containing the file associated with file descriptor fd, like
statvfs()
.Availability: Unix.
-
os.
fsync
(fd)¶ 强制将文件描述符 fd 指向的文件写入磁盘。在 Unix,这将调用原生
fsync()
函数;在 Windows,则是 MS_commit()
函数。If you’re starting with a Python file object f, first do
f.flush()
, and then doos.fsync(f.fileno())
, to ensure that all internal buffers associated with f are written to disk.Availability: Unix, and Windows starting in 2.2.3.
-
os.
ftruncate
(fd, length)¶ Truncate the file corresponding to file descriptor fd, so that it is at most length bytes in size.
Availability: Unix.
-
os.
isatty
(fd)¶ 如果文件描述符 fd 打开且已连接至 tty 设备(或类 tty 设备),返回
True
,否则返回False
。
-
os.
lseek
(fd, pos, how)¶ 将文件描述符 fd 的当前位置设置为 pos,位置的计算方式 how 如下:设置为
SEEK_SET
或0
表示从文件开头计算,设置为SEEK_CUR
或1
表示从文件当前位置计算,设置为SEEK_END
或2
表示文件末尾计算。返回新指针位置,这个位置是从文件开头计算的,单位是字节。Availability: Unix, Windows.
-
os.
SEEK_SET
¶ -
os.
SEEK_CUR
¶ -
os.
SEEK_END
¶ lseek()
函数的参数,它们的值分别为 0、1 和 2。Availability: Windows, Unix.
2.5 新版功能.
-
os.
open
(file, flags[, mode])¶ Open the file file and set various flags according to flags and possibly its mode according to mode. The default mode is
0777
(octal), and the current umask value is first masked out. Return the file descriptor for the newly opened file.For a description of the flag and mode values, see the C run-time documentation; flag constants (like
O_RDONLY
andO_WRONLY
) are defined in this module too (see open() flag constants). In particular, on Windows addingO_BINARY
is needed to open files in binary mode.Availability: Unix, Windows.
-
os.
openpty
()¶ Open a new pseudo-terminal pair. Return a pair of file descriptors
(master, slave)
for the pty and the tty, respectively. For a (slightly) more portable approach, use thepty
module.Availability: some flavors of Unix.
-
os.
pipe
()¶ Create a pipe. Return a pair of file descriptors
(r, w)
usable for reading and writing, respectively.Availability: Unix, Windows.
-
os.
read
(fd, n)¶ Read at most n bytes from file descriptor fd. Return a string containing the bytes read. If the end of the file referred to by fd has been reached, an empty string is returned.
Availability: Unix, Windows.
-
os.
ttyname
(fd)¶ 返回一个字符串,该字符串表示与文件描述符 fd 关联的终端。如果 fd 没有与终端关联,则抛出异常。
Availability: Unix.
-
os.
write
(fd, str)¶ Write the string str to file descriptor fd. Return the number of bytes actually written.
Availability: Unix, Windows.
注解
该功能适用于低级 I/O 操作,必须用于
os.open()
或pipe()
返回的文件描述符。若要写入由内建函数open()
、popen()
、fdopen()
、sys.stdout
或sys.stderr
返回的 “文件对象”,则应使用其相应的write()
方法。
15.1.3.1. open()
flag constants¶
The following constants are options for the flags parameter to the
open()
function. They can be combined using the bitwise OR operator
|
. Some of them are not available on all platforms. For descriptions of
their availability and use, consult the open(2) manual page on Unix
or the MSDN on Windows.
-
os.
O_RDONLY
¶ -
os.
O_WRONLY
¶ -
os.
O_RDWR
¶ -
os.
O_APPEND
¶ -
os.
O_CREAT
¶ -
os.
O_EXCL
¶ -
os.
O_TRUNC
¶ 上述常量在 Unix 和 Windows 上均可用。
15.1.4. 文件和目录¶
-
os.
access
(path, mode)¶ 使用真实的 uid/gid 测试对 path 的访问。请注意,大多数测试操作将使用有效的 uid/gid,因此可以在 suid/sgid 环境中运用此例程,来测试调用用户是否具有对 path 的指定访问权限。mode 为
F_OK
时用于测试 path 是否存在,也可以对R_OK
、W_OK
和X_OK
中的一个或多个进行“或”运算来测试指定权限。允许访问则返回True
,否则返回False
。更多信息请参见 Unix 手册页 access(2)。Availability: Unix, Windows.
注解
使用
access()
来检查用户是否具有某项权限(如打开文件的权限),然后再使用open()
打开文件,这样做存在一个安全漏洞,因为用户可能会在检查和打开文件之间的时间里做其他操作。推荐使用 EAFP 技术。如:if os.access("myfile", os.R_OK): with open("myfile") as fp: return fp.read() return "some default data"
最好写成:
try: fp = open("myfile") except IOError as e: if e.errno == errno.EACCES: return "some default data" # Not a permission error. raise else: with fp: return fp.read()
注解
即使
access()
指示 I/O 操作会成功,但实际操作仍可能失败,尤其是对网络文件系统的操作,其权限语义可能超出常规的 POSIX 权限位模型。
-
os.
chdir
(path)¶ 将当前工作目录更改为 path。
Availability: Unix, Windows.
-
os.
fchdir
(fd)¶ Change the current working directory to the directory represented by the file descriptor fd. The descriptor must refer to an opened directory, not an open file.
Availability: Unix.
2.3 新版功能.
-
os.
getcwd
()¶ 返回表示当前工作目录的字符串。
Availability: Unix, Windows.
-
os.
getcwdu
()¶ Return a Unicode object representing the current working directory.
Availability: Unix, Windows.
2.3 新版功能.
-
os.
chflags
(path, flags)¶ 将 path 标志设置为数字 标志。标志 可以用以下值按位或组合起来(以下值在
stat
模块中定义):Availability: Unix.
2.6 新版功能.
-
os.
chroot
(path)¶ Change the root directory of the current process to path. Availability: Unix.
2.2 新版功能.
-
os.
chmod
(path, mode)¶ 将 path 的 mode 更改为其他由数字表示的 mode。mode 可以用以下值之一,也可以将它们按位或组合起来(以下值在
stat
模块中定义):Availability: Unix, Windows.
注解
Although Windows supports
chmod()
, you can only set the file’s read-only flag with it (via thestat.S_IWRITE
andstat.S_IREAD
constants or a corresponding integer value). All other bits are ignored.
-
os.
chown
(path, uid, gid)¶ Change the owner and group id of path to the numeric uid and gid. To leave one of the ids unchanged, set it to -1.
Availability: Unix.
-
os.
lchflags
(path, flags)¶ Set the flags of path to the numeric flags, like
chflags()
, but do not follow symbolic links.Availability: Unix.
2.6 新版功能.
-
os.
lchmod
(path, mode)¶ Change the mode of path to the numeric mode. If path is a symlink, this affects the symlink rather than the target. See the docs for
chmod()
for possible values of mode.Availability: Unix.
2.6 新版功能.
-
os.
lchown
(path, uid, gid)¶ Change the owner and group id of path to the numeric uid and gid. This function will not follow symbolic links.
Availability: Unix.
2.3 新版功能.
-
os.
link
(source, link_name)¶ Create a hard link pointing to source named link_name.
Availability: Unix.
-
os.
listdir
(path)¶ Return a list containing the names of the entries in the directory given by path. The list is in arbitrary order. It does not include the special entries
'.'
and'..'
even if they are present in the directory.Availability: Unix, Windows.
在 2.3 版更改: On Windows NT/2k/XP and Unix, if path is a Unicode object, the result will be a list of Unicode objects. Undecodable filenames will still be returned as string objects.
-
os.
lstat
(path)¶ Perform the equivalent of an
lstat()
system call on the given path. Similar tostat()
, but does not follow symbolic links. On platforms that do not support symbolic links, this is an alias forstat()
.
-
os.
mkfifo
(path[, mode])¶ Create a FIFO (a named pipe) named path with numeric mode mode. The default mode is
0666
(octal). The current umask value is first masked out from the mode.Availability: Unix.
FIFO 是可以像常规文件一样访问的管道。FIFO 如果没有被删除(如使用
os.unlink()
),会一直存在。通常,FIFO 用作“客户端”和“服务器”进程之间的汇合点:服务器打开 FIFO 进行读取,而客户端打开 FIFO 进行写入。请注意,mkfifo()
不会打开 FIFO — 它只是创建汇合点。
-
os.
mknod
(filename[, mode=0600[, device=0]])¶ Create a filesystem node (file, device special file or named pipe) named filename. mode specifies both the permissions to use and the type of node to be created, being combined (bitwise OR) with one of
stat.S_IFREG
,stat.S_IFCHR
,stat.S_IFBLK
, andstat.S_IFIFO
(those constants are available instat
). Forstat.S_IFCHR
andstat.S_IFBLK
, device defines the newly created device special file (probably usingos.makedev()
), otherwise it is ignored.2.3 新版功能.
-
os.
major
(device)¶ 提取主设备号,提取自原始设备号(通常是
stat
中的st_dev
或st_rdev
字段)。2.3 新版功能.
-
os.
minor
(device)¶ 提取次设备号,提取自原始设备号(通常是
stat
中的st_dev
或st_rdev
字段)。2.3 新版功能.
-
os.
makedev
(major, minor)¶ 将主设备号和次设备号组合成原始设备号。
2.3 新版功能.
-
os.
mkdir
(path[, mode])¶ Create a directory named path with numeric mode mode. The default mode is
0777
(octal). If the directory already exists,OSError
is raised.某些系统会忽略 mode。如果没有忽略它,那么将首先从它中减去当前的 umask 值。如果除最后 9 位(即 mode 八进制的最后 3 位)之外,还设置了其他位,则其他位的含义取决于各个平台。在某些平台上,它们会被忽略,应显式调用
chmod()
进行设置。如果需要创建临时目录,请参阅
tempfile
模块中的tempfile.mkdtemp()
函数。Availability: Unix, Windows.
-
os.
makedirs
(path[, mode])¶ Recursive directory creation function. Like
mkdir()
, but makes all intermediate-level directories needed to contain the leaf directory. Raises anerror
exception if the leaf directory already exists or cannot be created. The default mode is0777
(octal).The mode parameter is passed to
mkdir()
; see the mkdir() description for how it is interpreted.注解
makedirs()
will become confused if the path elements to create includeos.pardir
.1.5.2 新版功能.
在 2.3 版更改: This function now handles UNC paths correctly.
-
os.
pathconf
(path, name)¶ 返回所给名称的文件有关的系统配置信息。name 指定要查找的配置名称,它可以是字符串,是一个系统已定义的名称,这些名称定义在不同标准(POSIX.1,Unix 95,Unix 98 等)中。一些平台还定义了额外的其他名称。当前操作系统已定义的名称在
pathconf_names
字典中给出。对于未包含在该映射中的配置名称,也可以传递一个整数作为 name。如果 name 是一个字符串且不是已定义的名称,将抛出
ValueError
异常。如果当前系统不支持 name 指定的配置名称,即使该名称存在于pathconf_names
,也会抛出OSError
异常,错误码为errno.EINVAL
。Availability: Unix.
-
os.
pathconf_names
¶ Dictionary mapping names accepted by
pathconf()
andfpathconf()
to the integer values defined for those names by the host operating system. This can be used to determine the set of names known to the system. Availability: Unix.
-
os.
readlink
(path)¶ 返回一个字符串,为符号链接指向的实际路径。其结果可以是绝对或相对路径。如果是相对路径,则可用
os.path.join(os.path.dirname(path), result)
转换为绝对路径。在 2.6 版更改: If the path is a Unicode object the result will also be a Unicode object.
Availability: Unix.
-
os.
remove
(path)¶ Remove (delete) the file path. If path is a directory,
OSError
is raised; seermdir()
below to remove a directory. This is identical to theunlink()
function documented below. On Windows, attempting to remove a file that is in use causes an exception to be raised; on Unix, the directory entry is removed but the storage allocated to the file is not made available until the original file is no longer in use.Availability: Unix, Windows.
-
os.
removedirs
(path)¶ 递归删除目录。工作方式类似于
rmdir()
,不同之处在于,如果成功删除了末尾一级目录,removedirs()
会尝试依次删除 path 中提到的每个父目录,直到抛出错误为止(但该错误会被忽略,因为这通常表示父目录不是空目录)。例如,os.removedirs('foo/bar/baz')
将首先删除目录'foo/bar/baz'
,然后如果'foo/bar'
和'foo'
为空,则继续删除它们。如果无法成功删除末尾一级目录,则抛出OSError
异常。1.5.2 新版功能.
-
os.
rename
(src, dst)¶ Rename the file or directory src to dst. If dst is a directory,
OSError
will be raised. On Unix, if dst exists and is a file, it will be replaced silently if the user has permission. The operation may fail on some Unix flavors if src and dst are on different filesystems. If successful, the renaming will be an atomic operation (this is a POSIX requirement). On Windows, if dst already exists,OSError
will be raised even if it is a file; there may be no way to implement an atomic rename when dst names an existing file.Availability: Unix, Windows.
-
os.
renames
(old, new)¶ 递归重命名目录或文件。工作方式类似
rename()
,除了会首先创建新路径所需的中间目录。重命名后,将调用removedirs()
删除旧路径中不需要的目录。1.5.2 新版功能.
注解
如果用户没有权限删除末级的目录或文件,则本函数可能会无法建立新的目录结构。
-
os.
rmdir
(path)¶ Remove (delete) the directory path. Only works when the directory is empty, otherwise,
OSError
is raised. In order to remove whole directory trees,shutil.rmtree()
can be used.Availability: Unix, Windows.
-
os.
stat
(path)¶ Perform the equivalent of a
stat()
system call on the given path. (This function follows symlinks; to stat a symlink uselstat()
.)The return value is an object whose attributes correspond to the members of the
stat
structure, namely:st_mode
- protection bits,st_ino
- inode number,st_dev
- device,st_nlink
- number of hard links,st_uid
- user id of owner,st_gid
- group id of owner,st_size
- size of file, in bytes,st_atime
- time of most recent access,st_mtime
- time of most recent content modification,st_ctime
- platform dependent; time of most recent metadata change on Unix, or the time of creation on Windows)
在 2.3 版更改: If
stat_float_times()
returnsTrue
, the time values are floats, measuring seconds. Fractions of a second may be reported if the system supports that. Seestat_float_times()
for further discussion.在某些 Unix 系统上(如 Linux 上),以下属性可能也可用:
st_blocks
- number of 512-byte blocks allocated for filest_blksize
- filesystem blocksize for efficient file system I/Ost_rdev
- type of device if an inode devicest_flags
- user defined flags for file
在其他 Unix 系统上(如 FreeBSD 上),以下属性可能可用(但仅当 root 使用它们时才被填充):
st_gen
- file generation numberst_birthtime
- time of file creation
On RISCOS systems, the following attributes are also available:
st_ftype
(file type)st_attrs
(attributes)st_obtype
(object type).
注解
st_atime
、st_mtime
和st_ctime
属性的确切含义和分辨率取决于操作系统和文件系统。例如,在使用 FAT 或 FAT32 文件系统的 Windows 上,st_mtime
有 2 秒的分辨率,而st_atime
仅有 1 天的分辨率。详细信息请参阅操作系统文档。For backward compatibility, the return value of
stat()
is also accessible as a tuple of at least 10 integers giving the most important (and portable) members of thestat
structure, in the orderst_mode
,st_ino
,st_dev
,st_nlink
,st_uid
,st_gid
,st_size
,st_atime
,st_mtime
,st_ctime
. More items may be added at the end by some implementations.标准模块
stat
中定义了函数和常量,这些函数和常量可用于从stat
结构体中提取信息。(在 Windows 上,某些项填充的是虚值。)示例:
>>> import os >>> statinfo = os.stat('somefile.txt') >>> statinfo (33188, 422511, 769, 1, 1032, 100, 926, 1105022698,1105022732, 1105022732) >>> statinfo.st_size 926
Availability: Unix, Windows.
在 2.2 版更改: Added access to values as attributes of the returned object.
在 2.5 版更改: Added
st_gen
andst_birthtime
.
-
os.
stat_float_times
([newvalue])¶ Determine whether
stat_result
represents time stamps as float objects. If newvalue isTrue
, future calls tostat()
return floats, if it isFalse
, future calls return ints. If newvalue is omitted, return the current setting.For compatibility with older Python versions, accessing
stat_result
as a tuple always returns integers.在 2.5 版更改: Python now returns float values by default. Applications which do not work correctly with floating point time stamps can use this function to restore the old behaviour.
The resolution of the timestamps (that is the smallest possible fraction) depends on the system. Some systems only support second resolution; on these systems, the fraction will always be zero.
It is recommended that this setting is only changed at program startup time in the __main__ module; libraries should never change this setting. If an application uses a library that works incorrectly if floating point time stamps are processed, this application should turn the feature off until the library has been corrected.
-
os.
statvfs
(path)¶ Perform a
statvfs()
system call on the given path. The return value is an object whose attributes describe the filesystem on the given path, and correspond to the members of thestatvfs
structure, namely:f_bsize
,f_frsize
,f_blocks
,f_bfree
,f_bavail
,f_files
,f_ffree
,f_favail
,f_flag
,f_namemax
.For backward compatibility, the return value is also accessible as a tuple whose values correspond to the attributes, in the order given above. The standard module
statvfs
defines constants that are useful for extracting information from astatvfs
structure when accessing it as a sequence; this remains useful when writing code that needs to work with versions of Python that don’t support accessing the fields as attributes.Availability: Unix.
在 2.2 版更改: Added access to values as attributes of the returned object.
-
os.
symlink
(source, link_name)¶ Create a symbolic link pointing to source named link_name.
Availability: Unix.
-
os.
tempnam
([dir[, prefix]])¶ Return a unique path name that is reasonable for creating a temporary file. This will be an absolute path that names a potential directory entry in the directory dir or a common location for temporary files if dir is omitted or
None
. If given and notNone
, prefix is used to provide a short prefix to the filename. Applications are responsible for properly creating and managing files created using paths returned bytempnam()
; no automatic cleanup is provided. On Unix, the environment variableTMPDIR
overrides dir, while on WindowsTMP
is used. The specific behavior of this function depends on the C library implementation; some aspects are underspecified in system documentation.警告
Use of
tempnam()
is vulnerable to symlink attacks; consider usingtmpfile()
(section 创建文件对象) instead.Availability: Unix, Windows.
-
os.
tmpnam
()¶ Return a unique path name that is reasonable for creating a temporary file. This will be an absolute path that names a potential directory entry in a common location for temporary files. Applications are responsible for properly creating and managing files created using paths returned by
tmpnam()
; no automatic cleanup is provided.警告
Use of
tmpnam()
is vulnerable to symlink attacks; consider usingtmpfile()
(section 创建文件对象) instead.Availability: Unix, Windows. This function probably shouldn’t be used on Windows, though: Microsoft’s implementation of
tmpnam()
always creates a name in the root directory of the current drive, and that’s generally a poor location for a temp file (depending on privileges, you may not even be able to open a file using this name).
-
os.
unlink
(path)¶ Remove (delete) the file path. This is the same function as
remove()
; theunlink()
name is its traditional Unix name.Availability: Unix, Windows.
-
os.
utime
(path, times)¶ Set the access and modified times of the file specified by path. If times is
None
, then the file’s access and modified times are set to the current time. (The effect is similar to running the Unix program touch on the path.) Otherwise, times must be a 2-tuple of numbers, of the form(atime, mtime)
which is used to set the access and modified times, respectively. Whether a directory can be given for path depends on whether the operating system implements directories as files (for example, Windows does not). Note that the exact times you set here may not be returned by a subsequentstat()
call, depending on the resolution with which your operating system records access and modification times; seestat()
.在 2.0 版更改: Added support for
None
for times.Availability: Unix, Windows.
-
os.
walk
(top, topdown=True, onerror=None, followlinks=False)¶ 生成目录树中的文件名,方式是按上->下或下->上顺序浏览目录树。对于以 top 为根的目录树中的每个目录(包括 top 本身),它都会生成一个三元组
(dirpath, dirnames, filenames)
。dirpath 是一个字符串,表示目录的路径。dirnames 是一个列表,内含 dirpath 中子目录的名称(不包括
'.'
和'..'
)。filenames 也是列表,内含 dirpath 中非目录文件的名称。注意,列表中的名称不包含路径部分。要获取 dirpath 中文件或目录的完整路径(从 top 起始),请执行os.path.join(dirpath, name)
。如果可选参数 topdown 为
True
或未指定,则在所有子目录的三元组之前生成父目录的三元组(目录是自上而下生成的)。如果 topdown 为False
,则在所有子目录的三元组生成之后再生成父目录的三元组(目录是自下而上生成的)。无论 topdown 为何值,在生成目录及其子目录的元组之前,都将检索全部子目录列表。当 topdown 为
True
时,调用者可以就地修改 dirnames 列表(也许用到了del
或切片),而walk()
将仅仅递归到仍保留在 dirnames 中的子目录内。这可用于减少搜索、加入特定的访问顺序,甚至可在继续walk()
之前告知walk()
由调用者新建或重命名的目录的信息。当 topdown 为False
时,修改 dirnames 对 walk 的行为没有影响,因为在自下而上模式中,dirnames 中的目录是在 dirpath 本身之前生成的。By default, errors from the
listdir()
call are ignored. If optional argument onerror is specified, it should be a function; it will be called with one argument, anOSError
instance. It can report the error to continue with the walk, or raise the exception to abort the walk. Note that the filename is available as thefilename
attribute of the exception object.walk()
默认不会递归进指向目录的符号链接。可以在支持符号链接的系统上将 followlinks 设置为True
,以访问符号链接指向的目录。2.6 新版功能: The followlinks parameter.
注解
注意,如果链接指向自身的父目录,则将 followlinks 设置为
True
可能导致无限递归。walk()
不会记录它已经访问过的目录。下面的示例遍历起始目录内所有子目录,打印每个目录内的文件占用的字节数,CVS 子目录不会被遍历:
import os from os.path import join, getsize for root, dirs, files in os.walk('python/Lib/email'): print root, "consumes", print sum(getsize(join(root, name)) for name in files), print "bytes in", len(files), "non-directory files" if 'CVS' in dirs: dirs.remove('CVS') # don't visit CVS directories
在下一个示例中,必须使树自下而上遍历,因为
rmdir()
只允许在目录为空时删除目录:# Delete everything reachable from the directory named in "top", # assuming there are no symbolic links. # CAUTION: This is dangerous! For example, if top == '/', it # could delete all your disk files. import os for root, dirs, files in os.walk(top, topdown=False): for name in files: os.remove(os.path.join(root, name)) for name in dirs: os.rmdir(os.path.join(root, name))
2.3 新版功能.
15.1.5. 进程管理¶
下列函数可用于创建和管理进程。
所有 exec*
函数都接受一个参数列表,用来给新程序加载到它的进程中。在所有情况下,传递给新程序的第一个参数是程序本身的名称,而不是用户在命令行上输入的参数。对于 C 程序员来说,这就是传递给 main()
函数的 argv[0]
。例如,os.execv('/bin/echo', ['foo', 'bar'])
只会在标准输出上打印 bar
,而 foo
会被忽略。
-
os.
abort
()¶ 发送
SIGABRT
信号到当前进程。在 Unix 上,默认行为是生成一个核心转储。在 Windows 上,该进程立即返回退出代码3
。请注意,使用signal.signal()
可以为SIGABRT
注册 Python 信号处理程序,而调用本函数将不会调用按前述方法注册的程序。Availability: Unix, Windows.
-
os.
execl
(path, arg0, arg1, ...)¶ -
os.
execle
(path, arg0, arg1, ..., env)¶ -
os.
execlp
(file, arg0, arg1, ...)¶ -
os.
execlpe
(file, arg0, arg1, ..., env)¶ -
os.
execv
(path, args)¶ -
os.
execve
(path, args, env)¶ -
os.
execvp
(file, args)¶ -
os.
execvpe
(file, args, env)¶ 这些函数都将执行一个新程序,以替换当前进程。它们没有返回值。在 Unix 上,新程序会加载到当前进程中,且进程号与调用者相同。过程中的错误会被报告为
OSError
异常。当前进程会被立即替换。打开的文件对象和描述符都不会刷新,因此如果这些文件上可能缓冲了数据,则应在调用
exec*
函数之前使用sys.stdout.flush()
或os.fsync()
刷新它们。exec*
函数的 “l” 和 “v” 变体不同在于命令行参数的传递方式。如果在编码时固定了参数数量,则 “l” 变体可能是最方便的,各参数作为execl*()
函数的附加参数传入即可。当参数数量可变时,”v” 变体更方便,参数以列表或元组的形式作为 args 参数传递。在这两种情况下,子进程的第一个参数都应该是即将运行的命令名称,但这不是强制性的。结尾包含 “p” 的变体(
execlp()
、execlpe()
、execvp()
和execvpe()
)将使用PATH
环境变量来查找程序 file。当环境被替换时(使用下一段讨论的exec*e
变体之一),PATH
变量将来自于新环境。其他变体execl()
、execle()
、execv()
和execve()
不使用PATH
变量来查找程序,因此 path 必须包含正确的绝对或相对路径。对于
execle()
、execlpe()
、execve()
和execvpe()
(都以 “e” 结尾),env 参数是一个映射,用于定义新进程的环境变量(代替当前进程的环境变量)。而函数execl()
、execlp()
、execv()
和execvp()
会将当前进程的环境变量过继给新进程。Availability: Unix, Windows.
-
os.
_exit
(n)¶ 以状态码 n 退出进程,不会调用清理处理程序,不会刷新 stdio,等等。
Availability: Unix, Windows.
以下是已定义的退出代码,可以用于 _exit()
,尽管它们不是必需的。这些退出代码通常用于 Python 编写的系统程序,例如邮件服务器的外部命令传递程序。
注解
其中部分退出代码在部分 Unix 平台上可能不可用,因为平台间存在差异。如果底层平台定义了这些常量,那上层也会定义。
-
os.
EX_OK
¶ 退出代码,表示未发生任何错误。
Availability: Unix.
2.3 新版功能.
-
os.
EX_USAGE
¶ 退出代码,表示命令使用不正确,如给出的参数数量有误。
Availability: Unix.
2.3 新版功能.
-
os.
EX_DATAERR
¶ 退出代码,表示输入数据不正确。
Availability: Unix.
2.3 新版功能.
-
os.
EX_NOINPUT
¶ 退出代码,表示某个输入文件不存在或不可读。
Availability: Unix.
2.3 新版功能.
-
os.
EX_NOUSER
¶ 退出代码,表示指定的用户不存在。
Availability: Unix.
2.3 新版功能.
-
os.
EX_NOHOST
¶ 退出代码,表示指定的主机不存在。
Availability: Unix.
2.3 新版功能.
-
os.
EX_UNAVAILABLE
¶ 退出代码,表示所需的服务不可用。
Availability: Unix.
2.3 新版功能.
-
os.
EX_SOFTWARE
¶ 退出代码,表示检测到内部软件错误。
Availability: Unix.
2.3 新版功能.
-
os.
EX_OSERR
¶ 退出代码,表示检测到操作系统错误,例如无法 fork 或创建管道。
Availability: Unix.
2.3 新版功能.
-
os.
EX_OSFILE
¶ 退出代码,意味着某些系统文件不存在,无法打开或发生其他错误。
Availability: Unix.
2.3 新版功能.
-
os.
EX_CANTCREAT
¶ 退出代码,表示无法创建用户指定的输出文件。
Availability: Unix.
2.3 新版功能.
-
os.
EX_IOERR
¶ 退出代码,表示对某些文件进行读写时发生错误。
Availability: Unix.
2.3 新版功能.
-
os.
EX_TEMPFAIL
¶ 退出代码,表示发生了暂时性故障。它可能并非意味着真正的错误,例如在可重试的情况下无法建立网络连接。
Availability: Unix.
2.3 新版功能.
-
os.
EX_PROTOCOL
¶ 退出代码,表示协议交换是非法的、无效的或无法解读的。
Availability: Unix.
2.3 新版功能.
-
os.
EX_NOPERM
¶ 退出代码,表示没有足够的权限执行该操作(但不适用于文件系统问题)。
Availability: Unix.
2.3 新版功能.
-
os.
EX_CONFIG
¶ 退出代码,表示发生某种配置错误。
Availability: Unix.
2.3 新版功能.
-
os.
EX_NOTFOUND
¶ 退出代码,表示的内容类似于“找不到条目”。
Availability: Unix.
2.3 新版功能.
-
os.
fork
()¶ Fork 出一个子进程。在子进程中返回
0
,在父进程中返回子进程的进程号。如果发生错误,则抛出OSError
异常。Note that some platforms including FreeBSD <= 6.3, Cygwin and OS/2 EMX have known issues when using fork() from a thread.
警告
有关 SSL 模块与 fork() 结合的应用,请参阅
ssl
。Availability: Unix.
-
os.
forkpty
()¶ Fork 出一个子进程,使用新的伪终端作为子进程的控制终端。返回一对
(pid, fd)
,其中 pid 在子进程中为0
,这是父进程中新子进程的进程号,而 fd 是伪终端主设备的文件描述符。对于更便于移植的方法,请使用pty
模块。如果发生错误,则抛出OSError
异常。Availability: some flavors of Unix.
-
os.
kill
(pid, sig)¶ 将信号 sig 发送至进程 pid。特定平台上可用的信号常量定义在
signal
模块中。Windows:
signal.CTRL_C_EVENT
和signal.CTRL_BREAK_EVENT
信号是特殊信号,只能发送给共享同一个控制台窗口的控制台进程,如某些子进程。sig 取任何其他值将导致该进程被 TerminateProcess API 无条件终止,且退出代码为 sig。Windows 版本的kill()
还需要传入待结束进程的句柄。2.7 新版功能: Windows support
-
os.
killpg
(pgid, sig)¶ 将信号 sig 发送给进程组 pgid。
Availability: Unix.
2.3 新版功能.
-
os.
nice
(increment)¶ 将进程的优先级(nice 值)增加 increment,返回新的 nice 值。
Availability: Unix.
-
os.
plock
(op)¶ 将程序段锁定到内存中。op 的值(定义在
<sys/lock.h>
中)决定了哪些段被锁定。Availability: Unix.
-
os.
popen
(...) -
os.
popen2
(...) -
os.
popen3
(...) -
os.
popen4
(...) Run child processes, returning opened pipes for communications. These functions are described in section 创建文件对象.
-
os.
spawnl
(mode, path, ...)¶ -
os.
spawnle
(mode, path, ..., env)¶ -
os.
spawnlp
(mode, file, ...)¶ -
os.
spawnlpe
(mode, file, ..., env)¶ -
os.
spawnv
(mode, path, args)¶ -
os.
spawnve
(mode, path, args, env)¶ -
os.
spawnvp
(mode, file, args)¶ -
os.
spawnvpe
(mode, file, args, env)¶ 在新进程中执行程序 path。
(注意,
subprocess
模块提供了更强大的工具来生成新进程并跟踪执行结果,使用该模块比使用这些函数更好。尤其应当检查 Replacing Older Functions with the subprocess Module 部分。)mode 为
P_NOWAIT
时,本函数返回新进程的进程号。mode 为P_WAIT
时,如果进程正常退出,返回退出代码,如果被杀死,返回-signal
,其中 signal 是杀死进程的信号。在 Windows 上,进程号实际上是进程句柄,因此可以与waitpid()
函数一起使用。spawn*
函数的 “l” 和 “v” 变体不同在于命令行参数的传递方式。如果在编码时固定了参数数量,则 “l” 变体可能是最方便的,各参数作为spawnl*()
函数的附加参数传入即可。当参数数量可变时,”v” 变体更方便,参数以列表或元组的形式作为 args 参数传递。在这两种情况下,子进程的第一个参数都必须是即将运行的命令名称。结尾包含第二个 “p” 的变体(
spawnlp()
、spawnlpe()
、spawnvp()
和spawnvpe()
)将使用PATH
环境变量来查找程序 file。当环境被替换时(使用下一段讨论的spawn*e
变体之一),PATH
变量将来自于新环境。其他变体spawnl()
、spawnle()
、spawnv()
和spawnve()
不使用PATH
变量来查找程序,因此 path 必须包含正确的绝对或相对路径。对于
spawnle()
、spawnlpe()
、spawnve()
和spawnvpe()
(都以 “e” 结尾),env 参数是一个映射,用于定义新进程的环境变量(代替当前进程的环境变量)。而函数spawnl()
、spawnlp()
、spawnv()
和spawnvp()
会将当前进程的环境变量过继给新进程。注意,env 字典中的键和值必须是字符串。无效的键或值将导致函数出错,返回值为127
。例如,以下对
spawnlp()
和spawnvpe()
的调用是等效的:import os os.spawnlp(os.P_WAIT, 'cp', 'cp', 'index.html', '/dev/null') L = ['cp', 'index.html', '/dev/null'] os.spawnvpe(os.P_WAIT, 'cp', L, os.environ)
Availability: Unix, Windows.
spawnlp()
,spawnlpe()
,spawnvp()
andspawnvpe()
are not available on Windows.spawnle()
andspawnve()
are not thread-safe on Windows; we advise you to use thesubprocess
module instead.1.6 新版功能.
-
os.
P_NOWAIT
¶ -
os.
P_NOWAITO
¶ spawn*
系列函数的 mode 参数的可取值。如果给出这些值中的任何一个,则spawn*()
函数将在创建新进程后立即返回,且返回值为进程号。Availability: Unix, Windows.
1.6 新版功能.
-
os.
P_WAIT
¶ spawn*
系列函数的 mode 参数的可取值。如果将 mode 指定为该值,则spawn*()
函数将在新进程运行完毕后返回,运行成功则返回进程的退出代码,被信号终止则返回-signal
。Availability: Unix, Windows.
1.6 新版功能.
-
os.
P_DETACH
¶ -
os.
P_OVERLAY
¶ Possible values for the mode parameter to the
spawn*
family of functions. These are less portable than those listed above.P_DETACH
is similar toP_NOWAIT
, but the new process is detached from the console of the calling process. IfP_OVERLAY
is used, the current process will be replaced; thespawn*()
function will not return.Availability: Windows.
1.6 新版功能.
-
os.
startfile
(path[, operation])¶ 使用已关联的应用程序打开文件。
当 operation 未指定或指定为
'open'
时,这类似于在 Windows 资源管理器中双击文件,或在交互式命令行中将文件名作为 start 命令的参数:通过扩展名相关联的应用程序(如果有)打开文件。当指定另一个 operation 时,它必须是一个“命令动词” (“command verb”),该词指定对文件执行的操作。Microsoft 文档中的常用动词有
'print'
和'edit'
(用于文件),以及'explore'
和'find'
(用于目录)。关联的应用程序启动后
startfile()
就会立即返回。本函数没有等待应用程序关闭的选项,也没有办法检索应用程序的退出状态。path 参数是基于当前目录的相对路径。如果要使用绝对路径,请确保第一个字符不是斜杠 ('/'
),是斜杠的话底层的 Win32ShellExecute()
函数将失效。使用os.path.normpath()
函数确保路径已针对 Win32 正确编码。Availability: Windows.
2.0 新版功能.
2.5 新版功能: The operation parameter.
-
os.
system
(command)¶ Execute the command (a string) in a subshell. This is implemented by calling the Standard C function
system()
, and has the same limitations. Changes tosys.stdin
, etc. are not reflected in the environment of the executed command.在 Unix 上,返回值是进程的退出状态,编码格式与为
wait()
指定的格式相同。注意,POSIX 没有指定 C 函数system()
返回值的含义,因此 Python 函数的返回值与系统有关。On Windows, the return value is that returned by the system shell after running command, given by the Windows environment variable
COMSPEC
: on command.com systems (Windows 95, 98 and ME) this is always0
; on cmd.exe systems (Windows NT, 2000 and XP) this is the exit status of the command run; on systems using a non-native shell, consult your shell documentation.subprocess
模块提供了更强大的工具来生成新进程并跟踪执行结果,使用该模块比使用本函数更好。参阅subprocess
文档中的 Replacing Older Functions with the subprocess Module 部分以获取有用的帮助。Availability: Unix, Windows.
-
os.
times
()¶ Return a 5-tuple of floating point numbers indicating accumulated (processor or other) times, in seconds. The items are: user time, system time, children’s user time, children’s system time, and elapsed real time since a fixed point in the past, in that order. See the Unix manual page times(2) or the corresponding Windows Platform API documentation. On Windows, only the first two items are filled, the others are zero.
Availability: Unix, Windows
-
os.
wait
()¶ 等待子进程执行完毕,返回一个元组,包含其 pid 和退出状态指示:一个 16 位数字,其低字节是终止该进程的信号编号,高字节是退出状态码(信号编号为零的情况下),如果生成了核心文件,则低字节的高位会置位。
Availability: Unix.
-
os.
waitpid
(pid, options)¶ 本函数的细节在 Unix 和 Windows 上有不同之处。
在 Unix 上:等待进程号为 pid 的子进程执行完毕,返回一个元组,内含其进程 ID 和退出状态指示(编码与
wait()
相同)。调用的语义受整数 options 的影响,常规操作下该值应为0
。如果 pid 大于
0
,则waitpid()
会获取该指定进程的状态信息。如果 pid 为0
,则获取当前进程所在进程组中的所有子进程的状态。如果 pid 为-1
,则获取当前进程的子进程状态。如果 pid 小于-1
,则获取进程组-pid
( pid 的绝对值)中所有进程的状态。当系统调用返回 -1 时,将抛出带有错误码的
OSError
异常。在 Windows 上:等待句柄为 pid 的进程执行完毕,返回一个元组,内含 pid 以及左移 8 位后的退出状态(移位简化了跨平台使用本函数)。小于或等于
0
的 pid 在 Windows 上没有特殊含义,且会抛出异常。整数值 options 无效。pid 可以指向任何 ID 已知的进程,不一定是子进程。调用spawn*
函数时传入P_NOWAIT
将返回合适的进程句柄。
-
os.
wait3
(options)¶ 与
waitpid()
相似,差别在于没有进程 ID 参数,且返回一个 3 元组,其中包括子进程 ID,退出状态指示和资源使用信息。关于资源使用信息的详情,请参考resource
.getrusage()
。option 参数与传入waitpid()
和wait4()
的相同。Availability: Unix.
2.5 新版功能.
-
os.
wait4
(pid, options)¶ 与
waitpid()
相似,差别在本方法返回一个 3 元组,其中包括子进程 ID,退出状态指示和资源使用信息。关于资源使用信息的详情,请参考resource
.getrusage()
。wait4()
的参数与waitpid()
的参数相同。Availability: Unix.
2.5 新版功能.
-
os.
WCONTINUED
¶ 被作业控制停止的子进程,如果自上次报告状态以来,已继续进行,则此选项将报告这些子进程。
Availability: Some Unix systems.
2.3 新版功能.
-
os.
WUNTRACED
¶ 已停止的子进程,如果自停止以来尚未报告其当前状态,则此选项将报告这些子进程。
Availability: Unix.
2.3 新版功能.
下列函数采用进程状态码作为参数,状态码由 system()
、wait()
或 waitpid()
返回。它们可用于确定进程上发生的操作。
-
os.
WCOREDUMP
(status)¶ 如果为该进程生成了核心转储,返回
True
,否则返回False
。Availability: Unix.
2.3 新版功能.
-
os.
WIFCONTINUED
(status)¶ Return
True
if the process has been continued from a job control stop, otherwise returnFalse
.Availability: Unix.
2.3 新版功能.
-
os.
WIFSTOPPED
(status)¶ Return
True
if the process has been stopped, otherwise returnFalse
.Availability: Unix.
-
os.
WIFSIGNALED
(status)¶ Return
True
if the process exited due to a signal, otherwise returnFalse
.Availability: Unix.
-
os.
WIFEXITED
(status)¶ Return
True
if the process exited using the exit(2) system call, otherwise returnFalse
.Availability: Unix.
-
os.
WEXITSTATUS
(status)¶ If
WIFEXITED(status)
is true, return the integer parameter to the exit(2) system call. Otherwise, the return value is meaningless.Availability: Unix.
-
os.
WSTOPSIG
(status)¶ 返回导致进程停止的信号。
Availability: Unix.
-
os.
WTERMSIG
(status)¶ Return the signal which caused the process to exit.
Availability: Unix.
15.1.6. 其他系统信息¶
-
os.
confstr
(name)¶ 返回字符串格式的系统配置信息。name 指定要查找的配置名称,它可以是字符串,是一个系统已定义的名称,这些名称定义在不同标准(POSIX,Unix 95,Unix 98 等)中。一些平台还定义了额外的其他名称。当前操作系统已定义的名称在
confstr_names
字典的键中给出。对于未包含在该映射中的配置名称,也可以传递一个整数作为 name。如果 name 指定的配置值未定义,返回
None
。如果 name 是一个字符串且不是已定义的名称,将抛出
ValueError
异常。如果当前系统不支持 name 指定的配置名称,即使该名称存在于confstr_names
,也会抛出OSError
异常,错误码为errno.EINVAL
。Availability: Unix
-
os.
confstr_names
¶ 字典,表示映射关系,为
confstr()
可接受名称与操作系统为这些名称定义的整数值之间的映射。这可用于判断系统已定义了哪些名称。Availability: Unix.
-
os.
getloadavg
()¶ 返回系统运行队列中最近 1、5 和 15 分钟内的平均进程数。无法获得平均负载则抛出
OSError
异常。Availability: Unix.
2.3 新版功能.
-
os.
sysconf
(name)¶ 返回整数格式的系统配置信息。如果 name 指定的配置值未定义,返回
-1
。对confstr()
的 name 参数的注释在此处也适用。当前已知的配置名称在sysconf_names
字典中提供。Availability: Unix.
-
os.
sysconf_names
¶ 字典,表示映射关系,为
sysconf()
可接受名称与操作系统为这些名称定义的整数值之间的映射。这可用于判断系统已定义了哪些名称。Availability: Unix.
以下数据值用于支持对路径本身的操作。所有平台都有定义。
对路径的高级操作在 os.path
模块中定义。
-
os.
sep
¶ 操作系统用来分隔路径不同部分的字符。在 POSIX 上是
'/'
,在 Windows 上是是'\\'
。注意,仅了解它不足以能解析或连接路径,请使用os.path.split()
和os.path.join()
,但它有时是有用的。在os.path
中也可用。
-
os.
linesep
¶ 当前平台用于分隔(或终止)行的字符串。它可以是单个字符,如 POSIX 上是
'\n'
,也可以是多个字符,如 Windows 上是'\r\n'
。在写入以文本模式(默认模式)打开的文件时,请不要使用 os.linesep 作为行终止符,请在所有平台上都使用一个'\n'
代替。
15.1.7. Miscellaneous Functions¶
-
os.
urandom
(n)¶ Return a string of n random bytes suitable for cryptographic use.
This function returns random bytes from an OS-specific randomness source. The returned data should be unpredictable enough for cryptographic applications, though its exact quality depends on the OS implementation. On a UNIX-like system this will query
/dev/urandom
, and on Windows it will useCryptGenRandom()
. If a randomness source is not found,NotImplementedError
will be raised.For an easy-to-use interface to the random number generator provided by your platform, please see
random.SystemRandom
.2.4 新版功能.