cpython-withatomic / Doc / libglob.tex

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 \section{Standard Module \sectcode{glob}} \label{module-glob} \stmodindex{glob} \renewcommand{\indexsubitem}{(in module glob)} The \code{glob} module finds all the pathnames matching a specified pattern according to the rules used by the \UNIX{} shell. No tilde expansion is done, but \verb\*\, \verb\?\, and character ranges expressed with \verb\[]\ will be correctly matched. This is done by using the \code{os.listdir()} and \code{fnmatch.fnmatch()} functions in concert, and not by actually invoking a subshell. (For tilde and shell variable expansion, use \code{os.path.expanduser(}) and \code{os.path.expandvars()}.) \begin{funcdesc}{glob}{pathname} Returns a possibly-empty list of path names that match \var{pathname}, which must be a string containing a path specification. \var{pathname} can be either absolute (like \file{/usr/src/Python1.4/Makefile}) or relative (like \file{../../Tools/*.gif}), and can contain shell-style wildcards. \end{funcdesc} For example, consider a directory containing only the following files: \file{1.gif}, \file{2.txt}, and \file{card.gif}. \code{glob.glob()} will produce the following results. Notice how any leading components of the path are preserved. \bcode\begin{verbatim} >>> import glob >>> glob.glob('./[0-9].*') ['./1.gif', './2.txt'] >>> glob.glob('*.gif') ['1.gif', 'card.gif'] >>> glob.glob('?.gif') ['1.gif'] \end{verbatim}\ecode 
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.