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
|
require a case-sensitive comparison regardless of whether that's
|
||||||
standard for your operating system, use \function{fnmatchcase()}
|
standard for your operating system, use \function{fnmatchcase()}
|
||||||
instead.
|
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}
|
\end{funcdesc}
|
||||||
|
|
||||||
\begin{funcdesc}{fnmatchcase}{filename, pattern}
|
\begin{funcdesc}{fnmatchcase}{filename, pattern}
|
||||||
|
@ -50,6 +63,24 @@ implemented more efficiently.
|
||||||
\versionadded{2.2}
|
\versionadded{2.2}
|
||||||
\end{funcdesc}
|
\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}
|
\begin{seealso}
|
||||||
\seemodule{glob}{\UNIX{} shell-style path expansion.}
|
\seemodule{glob}{\UNIX{} shell-style path expansion.}
|
||||||
\end{seealso}
|
\end{seealso}
|
||||||
|
|
|
@ -503,6 +503,8 @@ Tests
|
||||||
Documentation
|
Documentation
|
||||||
-------------
|
-------------
|
||||||
|
|
||||||
|
- Patch #1679379: add documentation for fnmatch.translate().
|
||||||
|
|
||||||
- Patch #1671450: add a section about subclassing builtin types to the
|
- Patch #1671450: add a section about subclassing builtin types to the
|
||||||
"extending and embedding" tutorial.
|
"extending and embedding" tutorial.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue