From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/python~3.12/library%2Ffnmatch.html | 41 ++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 devdocs/python~3.12/library%2Ffnmatch.html (limited to 'devdocs/python~3.12/library%2Ffnmatch.html') diff --git a/devdocs/python~3.12/library%2Ffnmatch.html b/devdocs/python~3.12/library%2Ffnmatch.html new file mode 100644 index 00000000..e736db27 --- /dev/null +++ b/devdocs/python~3.12/library%2Ffnmatch.html @@ -0,0 +1,41 @@ +

fnmatch — Unix filename pattern matching

Source code: Lib/fnmatch.py

This module provides support for Unix shell-style wildcards, which are not the same as regular expressions (which are documented in the re module). The special characters used in shell-style wildcards are:

+ + + + +

Pattern

Meaning

*

matches everything

?

matches any single character

[seq]

matches any character in seq

[!seq]

matches any character not in seq

For a literal match, wrap the meta-characters in brackets. For example, '[?]' matches the character '?'.

Note that the filename separator ('/' on Unix) is not special to this module. See module glob for pathname expansion (glob uses filter() to match pathname segments). Similarly, filenames starting with a period are not special for this module, and are matched by the * and ? patterns.

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(filename, pattern)
+

Test whether the filename string matches the pattern string, returning True or False. Both parameters are case-normalized using os.path.normcase(). fnmatchcase() can be used to perform a case-sensitive comparison, regardless of whether that’s standard for the operating system.

This example will print all file names in the current directory with the extension .txt:

import fnmatch
+import os
+
+for file in os.listdir('.'):
+    if fnmatch.fnmatch(file, '*.txt'):
+        print(file)
+
+
+fnmatch.fnmatchcase(filename, pattern)
+

Test whether filename matches pattern, returning True or False; the comparison is case-sensitive and does not apply os.path.normcase().

+
+fnmatch.filter(names, pattern)
+

Construct a list from those elements of the iterable names that match pattern. It is the same as [n for n in names if fnmatch(n, pattern)], but implemented more efficiently.

+
+fnmatch.translate(pattern)
+

Return the shell-style pattern converted to a regular expression for using with re.match().

Example:

>>> 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'>
+
+

See also

+Module glob +
+
+

Unix shell-style path expansion.

+

+ © 2001–2023 Python Software Foundation
Licensed under the PSF License.
+ https://docs.python.org/3.12/library/fnmatch.html +

+
-- cgit v1.2.3