fnmatch.md

1> **Источник:** https://python-all.ru/3.11/library/fnmatch.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# [`fnmatch`](https://python-all.ru/3.11/library/fnmatch.html#module-fnmatch) – сопоставление с шаблонами имён файлов в стиле Unix89**Исходный код:** [Lib/fnmatch.py](https://python-all.ru/src/3.11/Lib/fnmatch.py)1011---1213Этот модуль обеспечивает поддержку шаблонов с подстановочными символами в стиле оболочки Unix, которые *не* совпадают с регулярными выражениями (документированными в модуле [`re`](https://python-all.ru/3.11/library/re.html#module-re)). Специальные символы, используемые в шаблонах оболочки:1415| Шаблон | Значение |16| --- | --- |17| `*` | соответствует всему |18| `?` | соответствует одному любому символу |19| `[seq]` | соответствует любому символу из *seq* |20| `[!seq]` | соответствует любому символу не из *seq* |2122Для точного совпадения заключите метасимволы в скобки. Например, `'[?]'` соответствует символу `'?'`.2324Обратите внимание, что разделитель имён файлов (`'/'` в Unix) *не* является специальным для этого модуля. Смотрите модуль [`glob`](https://python-all.ru/3.11/library/glob.html#module-glob) для раскрытия путей ([`glob`](https://python-all.ru/3.11/library/glob.html#module-glob) использует [`filter()`](https://python-all.ru/3.11/library/fnmatch.html#fnmatch.filter) для сопоставления сегментов путей). Аналогично, имена файлов, начинающиеся с точки, не являются специальными для этого модуля и сопоставляются с помощью шаблонов `*` и `?`.2526Также обратите внимание, что [`functools.lru_cache()`](https://python-all.ru/3.11/library/functools.html#functools.lru_cache) с *maxsize*, равным 32768, используется для кэширования скомпилированных регулярных выражений в следующих функциях: [`fnmatch()`](https://python-all.ru/3.11/library/fnmatch.html#module-fnmatch), [`fnmatchcase()`](https://python-all.ru/3.11/library/fnmatch.html#fnmatch.fnmatchcase), [`filter()`](https://python-all.ru/3.11/library/fnmatch.html#fnmatch.filter).2728#### `fnmatch.fnmatch(name, pat)`2930Проверяет, соответствует ли строка имени файла *name* строке шаблона *pat*, возвращая `True` или `False`. Оба параметра нормализуются по регистру с помощью [`os.path.normcase()`](https://python-all.ru/3.11/library/os.path.html#os.path.normcase). [`fnmatchcase()`](https://python-all.ru/3.11/library/fnmatch.html#fnmatch.fnmatchcase) можно использовать для выполнения регистрозависимого сравнения, независимо от того, является ли это стандартным для операционной системы.3132Этот пример выведет все имена файлов в текущем каталоге с расширением `.txt`:3334```python35import fnmatch36import os3738for file in os.listdir('.'):39    if fnmatch.fnmatch(file, '*.txt'):40        print(file)41```4243#### `fnmatch.fnmatchcase(name, pat)`4445Проверяет, соответствует ли строка имени файла *name* строке шаблона *pat*, возвращая `True` или `False`; сравнение регистрозависимо и не применяет [`os.path.normcase()`](https://python-all.ru/3.11/library/os.path.html#os.path.normcase).4647#### `fnmatch.filter(names, pat)`4849Создает список из тех элементов [iterable](https://python-all.ru/3.11/glossary.html#term-iterable) *names*, которые соответствуют шаблону *pat*. Это то же самое, что и `[n for n in names if fnmatch(n, pat)]`, но реализовано более эффективно.5051#### `fnmatch.translate(pat)`5253Возвращает шаблон в стиле shell *pat*, преобразованный в регулярное выражение для использования с [`re.match()`](https://python-all.ru/3.11/library/re.html#re.match).5455Пример:5657```python58>>> import fnmatch, re59>>>60>>> regex = fnmatch.translate('*.txt')61>>> regex62'(?s:.*\\.txt)\\Z'63>>> reobj = re.compile(regex)64>>> reobj.match('foobar.txt')65<re.Match object; span=(0, 10), match='foobar.txt'>66```6768> **См. также**69>70> **Модуль [`glob`](https://python-all.ru/3.11/library/glob.html#module-glob)**71>72> Раскрытие путей в стиле оболочки Unix.73