mirror of https://github.com/python/cpython
Patch #1679379: add documentation for fnmatch.translate().
(backport from rev. 54323)
This commit is contained in:
parent
e19d7a3c0a
commit
0a24d10524
|
@ -36,6 +36,19 @@ lower- or upper-case before the comparison is performed. If you
|
|||
require a case-sensitive comparison regardless of whether that's
|
||||
standard for your operating system, use \function{fnmatchcase()}
|
||||
instead.
|
||||
|
||||
This example will print all file names in the current directory with the
|
||||
extension \code{.txt}:
|
||||
|
||||
\begin{verbatim}
|
||||
import fnmatch
|
||||
import os
|
||||
|
||||
for file in os.listdir('.'):
|
||||
if fnmatch.fnmatch(file, '*.txt'):
|
||||
print file
|
||||
\end{verbatim}
|
||||
|
||||
\end{funcdesc}
|
||||
|
||||
\begin{funcdesc}{fnmatchcase}{filename, pattern}
|
||||
|
@ -50,6 +63,24 @@ implemented more efficiently.
|
|||
\versionadded{2.2}
|
||||
\end{funcdesc}
|
||||
|
||||
\begin{funcdesc}{translate}{pattern}
|
||||
Return the shell-style \var{pattern} converted to a regular
|
||||
expression.
|
||||
|
||||
Example:
|
||||
|
||||
\begin{verbatim}
|
||||
>>> import fnmatch, re
|
||||
>>>
|
||||
>>> regex = fnmatch.translate('*.txt')
|
||||
>>> regex
|
||||
'.*\\.txt$'
|
||||
>>> reobj = re.compile(regex)
|
||||
>>> print reobj.match('foobar.txt')
|
||||
<_sre.SRE_Match object at 0x...>
|
||||
\end{verbatim}
|
||||
\end{funcdesc}
|
||||
|
||||
\begin{seealso}
|
||||
\seemodule{glob}{\UNIX{} shell-style path expansion.}
|
||||
\end{seealso}
|
||||
|
|
Loading…
Reference in New Issue