annotate Doc/lib/libsoundex.tex @ 5817:48b94de85bf3 legacy-trunk

Extensive changes by AMK.
author Guido van Rossum <guido@python.org>
date Thu, 17 Jul 1997 16:29:42 +0000
parents 2c10395921e1
children 3468ea8645ca
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4694
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
1 \section{Standard Module \sectcode{soundex}}
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
2 \stmodindex{soundex}
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
3
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
4 \renewcommand{\indexsubitem}{(in module soundex)}
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
5 The soundex algorithm takes an English word, and returns an
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
6 easily-computed hash of it; this hash is intended to be the same for
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
7 words that sound alike. This module provides an interface to the
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
8 soundex algorithm.
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
9
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
10 Note that the soundex algorithm is quite simple-minded, and isn't
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
11 perfect by any measure. Its main purpose is to help looking up names
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
12 in databases, when the name may be misspelled -- soundex hashes common
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
13 misspellings together.
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
14
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
15 \begin{funcdesc}{get_soundex}{string}
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
16 Return the soundex hash value for a word; it will always be a
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
17 6-character string. \var{string} must contain the word to be hashed,
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
18 with no leading whitespace; the case of the word is ignored.
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
19 \end{funcdesc}
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
20
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
21 \begin{funcdesc}{sound_similar}{string1, string2}
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
22 Compare the word in \var{string1} with the word in \var{string2}; this
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
23 is equivalent to
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
24 \code{get_soundex(\var{string1})==get_soundex(\var{string2})}.
2c10395921e1 Added soundex (sigh)
Guido van Rossum <guido@python.org>
parents:
diff changeset
25 \end{funcdesc}