fnmatch
--- Unix filename pattern matching¶
Code source : Lib/fnmatch.py
Ce module fournit la gestion des caractères de remplacement de style shell Unix, qui ne sont pas identiques à ceux utilisés dans les expressions régulières (documentés dans le module re
). Les caractères spéciaux utilisés comme caractères de remplacement de style shell sont :
Motif |
Signification |
---|---|
|
reconnaît n'importe quoi |
|
reconnaît n'importe quel caractère unique |
|
reconnaît n'importe quel caractère dans seq |
|
reconnaît n'importe quel caractère qui n'est pas dans seq |
Pour une correspondance littérale, il faut entourer le métacaractère par des crochets. Par exemple, '[?]'
reconnaît le caractère '?'
.
Notons que le séparateur de nom de fichiers ('/'
sous Unix) n'est pas traité de manière spéciale par ce module. Voir le module glob
pour la recherche de chemins (glob
utilise filter()
pour reconnaître les composants d'un chemin). De la même manière, les noms de fichiers commençant par un point ne sont pas traités de manière spéciale par ce module, et sont reconnus par les motifs *
et ?
.
Also note that functools.lru_cache()
with the maxsize of 32768 is used to
cache the compiled regex patterns in the following functions: fnmatch()
,
fnmatchcase()
, filter()
.
- fnmatch.fnmatch(name, pat)¶
Test whether the filename string name matches the pattern string pat, returning
True
orFalse
. Both parameters are case-normalized usingos.path.normcase()
.fnmatchcase()
can be used to perform a case-sensitive comparison, regardless of whether that's standard for the operating system.Cet exemple affiche tous les noms de fichiers du répertoire courant ayant pour extension
.txt
:import fnmatch import os for file in os.listdir('.'): if fnmatch.fnmatch(file, '*.txt'): print(file)
- fnmatch.fnmatchcase(name, pat)¶
Test whether the filename string name matches the pattern string pat, returning
True
orFalse
; the comparison is case-sensitive and does not applyos.path.normcase()
.
- fnmatch.filter(names, pat)¶
Construct a list from those elements of the iterable names that match pattern pat. It is the same as
[n for n in names if fnmatch(n, pat)]
, but implemented more efficiently.
- fnmatch.translate(pat)¶
Return the shell-style pattern pat converted to a regular expression for using with
re.match()
.Exemple :
>>> 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'>
Voir aussi
- Module
glob
Recherche de chemins de style shell Unix.