summaryrefslogtreecommitdiffstats
path: root/Doc/libmd5.tex
blob: 29e4b31c097191843acf4515979dfe7c5ffc23c0 (plain)
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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
\section{Built-in module \sectcode{md5}}
\bimodindex{md5}

This module implements the interface to RSA's MD5 message digest
algorithm (see also the file \file{md5.doc}). It's use is very
straightforward: use the function \code{md5} to create an
\dfn{md5}-object. You can now ``feed'' this object with arbitrary
strings.

At any time you can ask the ``final'' digest of the object. Internally,
a temorary copy of the object is made and the digest is computed and
returned. Because of the copy, the digest operation is not desctructive
for the object. Before a more exact description of the use, a small
example: to obtain the digest of the string \code{'abc'}, use \ldots

\bcode\begin{verbatim}
>>> from md5 import md5
>>> m = md5()
>>> m.update('abc')
>>> m.digest()
'\220\001P\230<\322O\260\326\226?}(\341\177r'
\end{verbatim}\ecode

More condensed:

\bcode\begin{verbatim}
>>> md5('abc').digest()
'\220\001P\230<\322O\260\326\226?}(\341\177r'
\end{verbatim}\ecode

\renewcommand{\indexsubitem}{(in module md5)}
\begin{funcdesc}{md5}{arg}
  Create a new md5-object. \var{arg} is optional: if present, an initial
  \code{update} method is called with \var{arg} as argument.
\end{funcdesc}

An md5-object has the following methods:

\renewcommand{\indexsubitem}{(md5 method)}
\begin{funcdesc}{update}{arg}
  Update this md5-object with the string \var{arg}.
\end{funcdesc}

\begin{funcdesc}{digest}{}
  Return the \dfn{digest} of this md5-object. Internally, a copy is made
  and the \C-function \code{MD5Final} is called. Finally the digest is
  returned.
\end{funcdesc}

\begin{funcdesc}{copy}{}
  Return a separate copy of this md5-object.  An \code{update} to this
  copy won't affect the original object.
\end{funcdesc}