fnmatch — Unix 文件名模式匹配

源代码: Lib/fnmatch.py


此模块提供对 Unix shell 风格通配符的支持,这与正则表达式(在 re 模块中介绍)不同。shell 风格通配符中使用的特殊字符有:

模式

含义

*

*

?

匹配所有内容

?

匹配任何单个字符

[seq]

匹配 seq 中的任何字符

[!seq]

匹配 seq 中没有的任何字符

对于字面量匹配,请将元字符括在括号中。例如,'[?]' 匹配字符 '?'

请注意,文件名分隔符(Unix 上为 '/')对该模块来说不是特殊的。有关路径名扩展,请参阅模块 globglob 使用 filter() 来匹配路径名段)。类似地,以句点开头的文件名对该模块来说也不是特殊的,并且可以通过 *? 模式进行匹配。

另请注意,在以下函数中,使用 maxsize 为 32768 的 functools.lru_cache() 来缓存已编译的正则表达式模式:fnmatch()fnmatchcase()filter()

fnmatch.fnmatch(name, pat)

import fnmatch
import os

for file in os.listdir('.'):
    if fnmatch.fnmatch(file, '*.txt'):
        print(file)
测试文件名字符串 name 是否与模式字符串 pat 匹配,返回 TrueFalse。两个参数都使用 os.path.normcase() 进行大小写规范化。可以使用 fnmatchcase() 执行区分大小写的比较,而不管这是否是操作系统的标准。

此示例将打印当前目录中所有扩展名为 .txt 的文件名

fnmatch.fnmatchcase(name, pat)

测试文件名字符串 name 是否与模式字符串 pat 匹配,返回 TrueFalse;比较区分大小写,并且不应用 os.path.normcase()

fnmatch.filter(names, pat)

可迭代对象 names 中构造一个列表,其中包含与模式 pat 匹配的元素。它与 [n for n in names if fnmatch(n, pat)] 相同,但实现效率更高。

fnmatch.translate(pat)

>>> import fnmatch, re
>>>
>>> regex = fnmatch.translate('*.txt')
>>> regex
'(?s:.*\\.txt)\\Z'
>>> reobj = re.compile(regex)
>>> reobj.match('foobar.txt')
<re.Match object; span=(0, 10), match='foobar.txt'>

返回 shell 风格模式 pat 转换为用于 re.match() 的正则表达式。

示例

另请参阅