11.11 dircache -- 缓存的目录列表

dircache 模块定义一个使用缓存读取目录列表的函数，并且使用目录的 mtime 是缓存失效，另外，它定义一个通过附加一个斜线注释是否是目录的函数。

dircache 模块定义下列函数：

reset(

)

重置目录缓存。

listdir(

path)

返回 path 的目录列表，os.listdir()一样。注意除非 path 改变，再次调用 listdir() 将不在重新读取目录结构。

注意返回的列表应该仅被视为只读。(可能将来的版本可以该变它返回一个元组？)

opendir(

path)

同listdir()一样。它的定义是为了向后的兼容性。

annotate(

head, list)

假定 list 是相对于 head 的路径的一个列表，并且在合适的位置，每一个指向目录的路径都会被添加一个 "/" 。

>>> import dircache
>>> a = dircache.listdir('/')
>>> a = a[:] # Copy the return value so we can change 'a'
>>> a
['bin', 'boot', 'cdrom', 'dev', 'etc', 'floppy', 'home', 'initrd', 'lib', 'lost+
found', 'mnt', 'proc', 'root', 'sbin', 'tmp', 'usr', 'var', 'vmlinuz']
>>> dircache.annotate('/', a)
>>> a
['bin/', 'boot/', 'cdrom/', 'dev/', 'etc/', 'floppy/', 'home/', 'initrd/', 'lib/
', 'lost+found/', 'mnt/', 'proc/', 'root/', 'sbin/', 'tmp/', 'usr/', 'var/', 'vm
linuz']

由zkfarmer翻译整理。