postgresql/contrib/fuzzystrmatch
Joe Conway 13629df5a1 Add double metaphone code from Andrew Dunstan. Also change metaphone so that
an empty input string causes an empty output string to be returned, instead of
throwing an ERROR -- per complaint from Aaron Hillegass, and consistent with
double metaphone. Fix examples in README.soundex pointed out by James Robinson.
2004-07-01 03:25:48 +00:00
..
Makefile Add double metaphone code from Andrew Dunstan. Also change metaphone so that 2004-07-01 03:25:48 +00:00
README.fuzzystrmatch Add double metaphone code from Andrew Dunstan. Also change metaphone so that 2004-07-01 03:25:48 +00:00
README.soundex Add double metaphone code from Andrew Dunstan. Also change metaphone so that 2004-07-01 03:25:48 +00:00
dmetaphone.c Add double metaphone code from Andrew Dunstan. Also change metaphone so that 2004-07-01 03:25:48 +00:00
fuzzystrmatch.c Add double metaphone code from Andrew Dunstan. Also change metaphone so that 2004-07-01 03:25:48 +00:00
fuzzystrmatch.h Fix some copyright notices that weren't updated. Improve copyright tool 2003-08-04 23:59:41 +00:00
fuzzystrmatch.sql.in Add double metaphone code from Andrew Dunstan. Also change metaphone so that 2004-07-01 03:25:48 +00:00

README.soundex

NOTE: Modified August 07, 2001 by Joe Conway. Updated for accuracy
	after combining soundex code into the fuzzystrmatch contrib
---------------------------------------------------------------------
The Soundex system is a method of matching similar sounding names
(or any words) to the same code.  It was initially used by the
United States Census in 1880, 1900, and 1910, but it has little use
beyond English names (or the English pronunciation of names), and
it is not a linguistic tool.

The following are some usage examples:

SELECT soundex('hello world!');

CREATE TABLE s (nm text)\g

insert into s values ('john')\g
insert into s values ('joan')\g
insert into s values ('wobbly')\g

select * from s
where soundex(nm) = soundex('john')\g

select a.nm, b.nm from s a, s b
where soundex(a.nm) = soundex(b.nm)
and a.oid <> b.oid\g

CREATE FUNCTION text_sx_eq(text, text) RETURNS bool AS
'select soundex($1) = soundex($2)'
LANGUAGE 'sql'\g

CREATE FUNCTION text_sx_lt(text,text) RETURNS bool AS
'select soundex($1) < soundex($2)'
LANGUAGE 'sql'\g

CREATE FUNCTION text_sx_gt(text,text) RETURNS bool AS
'select soundex($1) > soundex($2)'
LANGUAGE 'sql';

CREATE FUNCTION text_sx_le(text,text) RETURNS bool AS
'select soundex($1) <= soundex($2)'
LANGUAGE 'sql';

CREATE FUNCTION text_sx_ge(text,text) RETURNS bool AS
'select soundex($1) >= soundex($2)'
LANGUAGE 'sql';

CREATE FUNCTION text_sx_ne(text,text) RETURNS bool AS
'select soundex($1) <> soundex($2)'
LANGUAGE 'sql';

DROP OPERATOR #= (text,text)\g

CREATE OPERATOR #= (leftarg=text, rightarg=text, procedure=text_sx_eq,
commutator = #=)\g

SELECT *
FROM s
WHERE text_sx_eq(nm,'john')\g

SELECT *
from s
where s.nm #= 'john';