stat
源代码： Lib / stat.py
stat模块定义用于解释结果的常数和函数os.stat()，os.fstat()以及os.lstat()（如果它们存在）。有关完整的详细信息stat()，fstat()并lstat()呼叫，请咨询您的系统的文档。
stat模块定义了以下功能来测试特定的文件类型：
stat.S_ISDIR(mode)
如果模式来自目录，则返回非零值。
stat.S_ISCHR(mode)
如果模式来自字符特殊设备文件，则返回非零值。
stat.S_ISBLK(mode)
如果模式来自块特殊设备文件，则返回非零值。
stat.S_ISREG(mode)
如果模式来自常规文件，则返回非零值。
stat.S_ISFIFO(mode)
如果模式来自FIFO（命名管道），则返回非零值。
stat.S_ISLNK(mode)
如果模式来自符号链接，则返回非零值。
stat.S_ISSOCK(mode)
如果模式来自套接字，则返回非零值。
为更一般的文件模式操作定义了两个额外的功能：
stat.S_IMODE(mode)
返回可由os.chmod()文件的权限位，粘滞位，set-group-id和set-user-id位（在支持它们的系统上）设置的文件模式部分。
stat.S_IFMT(mode)
返回描述文件类型的文件模式部分（由上述S_IS*()函数使用）。
通常，您可以使用这些os.path.is*()函数来测试文件的类型; 当您对同一文件进行多个测试并希望避免stat()每次测试的系统调用开销时，此处的函数都很有用。当检查有关未处理的文件的信息时，这些也很有用os.path，例如对块和字符设备的测试。
例：
import os, sys
from stat import *
def walktree(top, callback):
'''recursively descend the directory tree rooted at top,
calling the callback function for each regular file'''
for f in os.listdir(top):
pathname = os.path.join(top, f)
mode = os.stat(pathname).st_mode
if S_ISDIR(mode):
# It's a directory, recurse into it
walktree(pathname, callback)
elif S_ISREG(mode):
# It's a file, call the callback function
callback(pathname)
else:
# Unknown file type, print a message
print 'Skipping %s' % pathname
def visitfile(file):
print 'visiting', file
if __name__ == '__main__':
walktree(sys.argv[1], visitfile)下面所有的变量都只是象征性的指标到返回的10元组os.stat()，os.fstat()或os.lstat()。
stat.ST_MODE
Inode保护模式。
stat.ST_INO
Inode号码。
stat.ST_DEV
设备inode驻留在上。
stat.ST_NLINK
到inode的链接数。
stat.ST_UID
所有者的用户标识。
stat.ST_GID
所有者的组ID。
stat.ST_SIZE
纯文件的字节大小；等待某些特殊文件的数据量。
stat.ST_ATIME
上次访问的时间。
stat.ST_MTIME
上次修改时间。
stat.ST_CTIME
操作系统报告的“ctime”。在某些系统上（如Unix）是最后一次元数据更改的时间，而在另一些系统上（如Windows）则是创建时间（有关详细信息，请参阅平台文档）。
“文件大小”的解释根据文件类型而改变。对于普通文件，这是文件的大小（以字节为单位）。对于在Unix（包括Linux尤其是）的最风味FIFO和插座，“大小”是在等待调用时要读取的字节数os.stat()，os.fstat()或os.lstat(); 这有时会很有用，特别是在非阻塞打开后轮询其中一个特殊文件。根据底层系统调用的实现，其他字符和块设备的大小字段的含义各不相同。
下面的变量定义了ST_MODE字段中使用的标志。
使用上述函数比使用第一组标志更具可移植性：
stat.S_IFSOCK
插座。
stat.S_IFLNK
符号链接。
stat.S_IFREG
普通文件。
stat.S_IFBLK
阻止设备。
stat.S_IFDIR
目录。
stat.S_IFCHR
字符设备。
stat.S_IFIFO
FIFO。
以下标志也可用于模式参数os.chmod()：
stat.S_ISUID
设置UID位。
stat.S_ISGID
设置组ID位。这个位有几个特殊用途。对于一个目录，它表示BSD语义将被用于该目录：其中创建的文件从目录中继承它们的组ID，而不是从创建过程的有效组ID中继承它们，并且在那里创建的目录也将获得该S_ISGID位设置。对于没有设置组执行位（S_IXGRP）的文件，set-group-ID位指示强制文件/记录锁定（另请参见S_ENFMT）。
stat.S_ISVTX
粘滞的位。在目录上设置此位时，表示该目录中的文件只能由文件所有者，目录所有者或特权进程重命名或删除。
stat.S_IRWXU
文件所有者权限的掩码。
stat.S_IRUSR
所有者已阅读权限。
stat.S_IWUSR
所有者拥有写入权限。
stat.S_IXUSR
所有者拥有执行权限。
stat.S_IRWXG
组权限掩码。
stat.S_IRGRP
组具有读取权限。
stat.S_IWGRP
组有写入权限。
stat.S_IXGRP
组拥有执行权限。
stat.S_IRWXO
面向其他人的权限（不在组中）。
stat.S_IROTH
其他人已阅读权限。
stat.S_IWOTH
其他人有写权限。
stat.S_IXOTH
其他人有执行许可。
stat.S_ENFMT
系统V文件锁定实施。该标志与S_ISGID以下内容共享：对没有设置组执行位（S_IXGRP）的文件执行文件/记录锁定。
stat.S_IREAD
Unix V7的代名词S_IRUSR。
stat.S_IWRITE
Unix V7的代名词S_IWUSR。
stat.S_IEXEC
Unix V7的代名词S_IXUSR。
以下标志可用于flags参数中os.chflags()：
stat.UF_NODUMP
不要转储文件。
stat.UF_IMMUTABLE
该文件可能不会更改。
stat.UF_APPEND
该文件只能附加到。
stat.UF_OPAQUE
通过联合堆栈查看时，该目录是不透明的。
stat.UF_NOUNLINK
该文件可能不会被重命名或删除。
stat.UF_COMPRESSED
该文件被压缩存储（Mac OS X 10.6+）。
stat.UF_HIDDEN
该文件不应该显示在GUI（Mac OS X 10.5+）中。
stat.SF_ARCHIVED
该文件可能已存档。
stat.SF_IMMUTABLE
该文件可能不会更改。
stat.SF_APPEND
该文件只能附加到。
stat.SF_NOUNLINK
该文件可能不会被重命名或删除。
stat.SF_SNAPSHOT
该文件是一个快照文件。
有关更多信息，请参阅* BSD或Mac OS系统手册页chflags（2）。
本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com
