mirror of
https://github.com/python/cpython.git
synced 2024-12-11 18:53:56 +08:00
29052482d1
in the docs to indicate the next version before we decided on 1.6. Adjusted winsound.Beep() description slightly as well.
37 lines
1.0 KiB
TeX
37 lines
1.0 KiB
TeX
\section{\module{cmp} ---
|
|
File comparisons}
|
|
|
|
\declaremodule{standard}{cmp}
|
|
\sectionauthor{Moshe Zadka}{moshez@zadka.site.co.il}
|
|
\modulesynopsis{Compare files very efficiently.}
|
|
|
|
\deprecated{1.6}{Use the \refmodule{filecmp} module instead.}
|
|
|
|
The \module{cmp} module defines a function to compare files, taking all
|
|
sort of short-cuts to make it a highly efficient operation.
|
|
|
|
The \module{cmp} module defines the following function:
|
|
|
|
\begin{funcdesc}{cmp}{f1, f2}
|
|
Compare two files given as names. The following tricks are used to
|
|
optimize the comparisons:
|
|
|
|
\begin{itemize}
|
|
\item Files with identical type, size and mtime are assumed equal.
|
|
\item Files with different type or size are never equal.
|
|
\item The module only compares files it already compared if their
|
|
signature (type, size and mtime) changed.
|
|
\item No external programs are called.
|
|
\end{itemize}
|
|
\end{funcdesc}
|
|
|
|
Example:
|
|
|
|
\begin{verbatim}
|
|
>>> import cmp
|
|
>>> cmp.cmp('libundoc.tex', 'libundoc.tex')
|
|
1
|
|
>>> cmp.cmp('libundoc.tex', 'lib.tex')
|
|
0
|
|
\end{verbatim}
|