Staging
v0.8.1
https://github.com/python/cpython
Raw File
Tip revision: 49b5230a6c058e56d0f57c844327f0ca77352767 authored by cvs2svn on 25 July 2003, 01:12:48 UTC
This commit was manufactured by cvs2svn to create tag 'r23c2'.
Tip revision: 49b5230
libcmp.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}
back to top