glob --- Unix 風格的路徑名稱模式擴展¶
原始碼：Lib/glob.py
The glob module finds pathnames
using pattern matching rules similar to the Unix shell.
No tilde expansion is done, but *, ?, and character
ranges expressed with [] will be correctly matched. This is done by using
the os.scandir() and fnmatch.fnmatch() functions in concert, and
not by actually invoking a subshell.
備註
The pathnames are returned in no particular order. If you need a specific order, sort the results.
Files beginning with a dot (.) can only be matched by
patterns that also start with a dot,
unlike fnmatch.fnmatch() or pathlib.Path.glob().
For tilde and shell variable expansion, use os.path.expanduser() and
os.path.expandvars().
對於文本 (literal) 匹配，將元字元 (meta-character) 括在方括號中。例如，'[?]' 會匹配 '?' 字元。
The glob module defines the following functions:
- glob.glob(pathname, *, root_dir=None, dir_fd=None, recursive=False, include_hidden=False)¶
回傳與 pathname 匹配、可能為空的路徑名稱 list，它必須是包含路徑規範的字串。 pathname 可以是絕對的（如
/usr/src/Python-1.5/Makefile）或相對的（如../../Tools/*/*.gif），並且可以包含 shell 樣式的通用字元 (wildcard)。已損壞的符號連接也會（如同在 shell）被包含在結果中。結果是否排序取決於檔案系統 (file system)。如果在呼叫此函式期間刪除或新增滿足條件的檔案，則結果不一定會包含該檔案的路徑名稱。If root_dir is not
None, it should be a path-like object specifying the root directory for searching. It has the same effect onglob()as changing the current directory before calling it. If pathname is relative, the result will contain paths relative to root_dir.此函式可以支援以 dir_fd 參數使用相對目錄描述器的路徑。
如果 recursive 為真，模式 "
**" 將匹配任何檔案、零個或多個目錄、子目錄和目錄的符號連結。如果模式後面有os.sep或os.altsep那麼檔案將不會被匹配。如果 include_hidden 為真，"
**" 模式將匹配被隱藏的目錄。引發一個附帶引數
pathname、recursive的稽核事件glob.glob。引發一個附帶引數
pathname、recursive、root_dir、dir_fd的稽核事件glob.glob/2。備註
在大型目錄樹中使用 "
**" 模式可能會消耗過多的時間。備註
This function may return duplicate path names if pathname contains multiple "
**" patterns and recursive is true.在 3.5 版的變更: 支援以 "
**" 使用遞迴 glob。在 3.10 版的變更: 新增 root_dir 與 dir_fd 參數。
在 3.11 版的變更: 新增 include_hidden 參數。
- glob.iglob(pathname, *, root_dir=None, dir_fd=None, recursive=False, include_hidden=False)¶
回傳一個會產生與
glob()相同的值的 iterator ，而不是同時儲存全部的值。引發一個附帶引數
pathname、recursive的稽核事件glob.glob。引發一個附帶引數
pathname、recursive、root_dir、dir_fd的稽核事件glob.glob/2。備註
This function may return duplicate path names if pathname contains multiple "
**" patterns and recursive is true.在 3.5 版的變更: 支援以 "
**" 使用遞迴 glob。在 3.10 版的變更: 新增 root_dir 與 dir_fd 參數。
在 3.11 版的變更: 新增 include_hidden 參數。
- glob.escape(pathname)¶
跳脫 (escape) 所有特殊字元（
'?'、'*'和'['）。如果你想匹配其中可能包含特殊字元的任意文本字串，這將會很有用。驅動器 (drive)/UNC 共享點 (sharepoints) 中的特殊字元不會被跳脫，例如在 Windows 上，escape('//?/c:/Quo vadis?.txt')會回傳'//?/c:/Quo vadis[?].txt'。在 3.4 版被加入.
- glob.translate(pathname, *, recursive=False, include_hidden=False, seps=None)¶
Convert the given path specification to a regular expression for use with
re.match(). The path specification can contain shell-style wildcards.舉例來說：
>>> import glob, re >>> >>> regex = glob.translate('**/*.txt', recursive=True, include_hidden=True) >>> regex '(?s:(?:.+/)?[^/]*\\.txt)\\z' >>> reobj = re.compile(regex) >>> reobj.match('foo/bar/baz.txt') <re.Match object; span=(0, 15), match='foo/bar/baz.txt'>
Path separators and segments are meaningful to this function, unlike
fnmatch.translate(). By default wildcards do not match path separators, and*pattern segments match precisely one path segment.If recursive is true, the pattern segment "
**" will match any number of path segments.If include_hidden is true, wildcards can match path segments that start with a dot (
.).A sequence of path separators may be supplied to the seps argument. If not given,
os.sepandaltsep(if available) are used.也參考
pathlib.PurePath.full_match()andpathlib.Path.glob()methods, which call this function to implement pattern matching and globbing.在 3.13 版被加入.
範例¶
例如，在一個包含以下檔案的目錄：1.gif、2.txt、card.gif，和一個僅包含 3.txt 檔案的子目錄 sub，glob() 將產生以下結果。請注意路徑的任何前導部分是如何保留的。
>>> import glob
>>> glob.glob('./[0-9].*')
['./1.gif', './2.txt']
>>> glob.glob('*.gif')
['1.gif', 'card.gif']
>>> glob.glob('?.gif')
['1.gif']
>>> glob.glob('**/*.txt', recursive=True)
['2.txt', 'sub/3.txt']
>>> glob.glob('./**/', recursive=True)
['./', './sub/']
如果目錄包含以 . 開頭的檔案，則預設情況下不會去匹配到它們。例如，一個包含 card.gif 和 .card.gif 的目錄：
>>> import glob
>>> glob.glob('*.gif')
['card.gif']
>>> glob.glob('.c*')
['.card.gif']
也參考
fnmatch 模組提供了 shell 風格檔案名（不是路徑）的擴展
也參考
pathlib 模組提供高階路徑物件。