~s-friedemann/tomdroid/sshfs

« back to all changes in this revision

Viewing changes to lib/commons-codec-1.4/apidocs/org/apache/commons/codec/language/Soundex.html

  • Committer: Guilherme Salgado
  • Date: 2010-08-31 21:44:24 UTC
  • mfrom: (185.1.51 sync-ui)
  • mto: (185.1.54 sync-ui)
  • mto: This revision was merged to the branch mainline in revision 186.
  • Revision ID: salgado@canonical.com-20100831214424-06b64zz707lwpmcl
mergeĀ lp:~tomdroid-developers/sync-ui

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2
 
<!--NewPage-->
3
 
<HTML>
4
 
<HEAD>
5
 
<!-- Generated by javadoc (build 1.6.0_07) on Thu Aug 06 17:42:38 BST 2009 -->
6
 
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
7
 
<TITLE>
8
 
Soundex (Commons Codec 1.4 API)
9
 
</TITLE>
10
 
 
11
 
<META NAME="date" CONTENT="2009-08-06">
12
 
 
13
 
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
14
 
 
15
 
<SCRIPT type="text/javascript">
16
 
function windowTitle()
17
 
{
18
 
    if (location.href.indexOf('is-external=true') == -1) {
19
 
        parent.document.title="Soundex (Commons Codec 1.4 API)";
20
 
    }
21
 
}
22
 
</SCRIPT>
23
 
<NOSCRIPT>
24
 
</NOSCRIPT>
25
 
 
26
 
</HEAD>
27
 
 
28
 
<BODY BGCOLOR="white" onload="windowTitle();">
29
 
<HR>
30
 
 
31
 
 
32
 
<!-- ========= START OF TOP NAVBAR ======= -->
33
 
<A NAME="navbar_top"><!-- --></A>
34
 
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
35
 
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
36
 
<TR>
37
 
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
38
 
<A NAME="navbar_top_firstrow"><!-- --></A>
39
 
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
40
 
  <TR ALIGN="center" VALIGN="top">
41
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
42
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
43
 
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
44
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Soundex.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
45
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
46
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
47
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
48
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
49
 
  </TR>
50
 
</TABLE>
51
 
</TD>
52
 
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
53
 
</EM>
54
 
</TD>
55
 
</TR>
56
 
 
57
 
<TR>
58
 
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
59
 
&nbsp;<A HREF="../../../../../org/apache/commons/codec/language/RefinedSoundex.html" title="class in org.apache.commons.codec.language"><B>PREV CLASS</B></A>&nbsp;
60
 
&nbsp;NEXT CLASS</FONT></TD>
61
 
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
62
 
  <A HREF="../../../../../index.html?org/apache/commons/codec/language/Soundex.html" target="_top"><B>FRAMES</B></A>  &nbsp;
63
 
&nbsp;<A HREF="Soundex.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
64
 
&nbsp;<SCRIPT type="text/javascript">
65
 
  <!--
66
 
  if(window==top) {
67
 
    document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
68
 
  }
69
 
  //-->
70
 
</SCRIPT>
71
 
<NOSCRIPT>
72
 
  <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
73
 
</NOSCRIPT>
74
 
 
75
 
 
76
 
</FONT></TD>
77
 
</TR>
78
 
<TR>
79
 
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
80
 
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
81
 
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
82
 
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
83
 
</TR>
84
 
</TABLE>
85
 
<A NAME="skip-navbar_top"></A>
86
 
<!-- ========= END OF TOP NAVBAR ========= -->
87
 
 
88
 
<HR>
89
 
<!-- ======== START OF CLASS DATA ======== -->
90
 
<H2>
91
 
<FONT SIZE="-1">
92
 
org.apache.commons.codec.language</FONT>
93
 
<BR>
94
 
Class Soundex</H2>
95
 
<PRE>
96
 
<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</A>
97
 
  <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><B>org.apache.commons.codec.language.Soundex</B>
98
 
</PRE>
99
 
<DL>
100
 
<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../../org/apache/commons/codec/Encoder.html" title="interface in org.apache.commons.codec">Encoder</A>, <A HREF="../../../../../org/apache/commons/codec/StringEncoder.html" title="interface in org.apache.commons.codec">StringEncoder</A></DD>
101
 
</DL>
102
 
<HR>
103
 
<DL>
104
 
<DT><PRE>public class <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.30"><B>Soundex</B></A><DT>extends <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A><DT>implements <A HREF="../../../../../org/apache/commons/codec/StringEncoder.html" title="interface in org.apache.commons.codec">StringEncoder</A></DL>
105
 
</PRE>
106
 
 
107
 
<P>
108
 
Encodes a string into a Soundex value. Soundex is an encoding used to relate similar names, but can also be used as a
109
 
 general purpose scheme to find word with similar phonemes.
110
 
<P>
111
 
 
112
 
<P>
113
 
<DL>
114
 
<DT><B>Version:</B></DT>
115
 
  <DD>$Id: Soundex.java 794026 2009-07-14 19:21:23Z ggregory $</DD>
116
 
<DT><B>Author:</B></DT>
117
 
  <DD>Apache Software Foundation</DD>
118
 
</DL>
119
 
<HR>
120
 
 
121
 
<P>
122
 
<!-- =========== FIELD SUMMARY =========== -->
123
 
 
124
 
<A NAME="field_summary"><!-- --></A>
125
 
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
126
 
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
127
 
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
128
 
<B>Field Summary</B></FONT></TH>
129
 
</TR>
130
 
<TR BGCOLOR="white" CLASS="TableRowColor">
131
 
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
132
 
<CODE>static&nbsp;<A HREF="../../../../../org/apache/commons/codec/language/Soundex.html" title="class in org.apache.commons.codec.language">Soundex</A></CODE></FONT></TD>
133
 
<TD><CODE><B><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#US_ENGLISH">US_ENGLISH</A></B></CODE>
134
 
 
135
 
<BR>
136
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;An instance of Soundex using the US_ENGLISH_MAPPING mapping.</TD>
137
 
</TR>
138
 
<TR BGCOLOR="white" CLASS="TableRowColor">
139
 
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
140
 
<CODE>static&nbsp;char[]</CODE></FONT></TD>
141
 
<TD><CODE><B><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#US_ENGLISH_MAPPING">US_ENGLISH_MAPPING</A></B></CODE>
142
 
 
143
 
<BR>
144
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This is a default mapping of the 26 letters used in US English.</TD>
145
 
</TR>
146
 
<TR BGCOLOR="white" CLASS="TableRowColor">
147
 
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
148
 
<CODE>static&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
149
 
<TD><CODE><B><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#US_ENGLISH_MAPPING_STRING">US_ENGLISH_MAPPING_STRING</A></B></CODE>
150
 
 
151
 
<BR>
152
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This is a default mapping of the 26 letters used in US English.</TD>
153
 
</TR>
154
 
</TABLE>
155
 
&nbsp;
156
 
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
157
 
 
158
 
<A NAME="constructor_summary"><!-- --></A>
159
 
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
160
 
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
161
 
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
162
 
<B>Constructor Summary</B></FONT></TH>
163
 
</TR>
164
 
<TR BGCOLOR="white" CLASS="TableRowColor">
165
 
<TD><CODE><B><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#Soundex()">Soundex</A></B>()</CODE>
166
 
 
167
 
<BR>
168
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates an instance using US_ENGLISH_MAPPING</TD>
169
 
</TR>
170
 
<TR BGCOLOR="white" CLASS="TableRowColor">
171
 
<TD><CODE><B><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#Soundex(char[])">Soundex</A></B>(char[]&nbsp;mapping)</CODE>
172
 
 
173
 
<BR>
174
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a soundex instance using the given mapping.</TD>
175
 
</TR>
176
 
<TR BGCOLOR="white" CLASS="TableRowColor">
177
 
<TD><CODE><B><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#Soundex(java.lang.String)">Soundex</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;mapping)</CODE>
178
 
 
179
 
<BR>
180
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a refined soundex instance using a custom mapping.</TD>
181
 
</TR>
182
 
</TABLE>
183
 
&nbsp;
184
 
<!-- ========== METHOD SUMMARY =========== -->
185
 
 
186
 
<A NAME="method_summary"><!-- --></A>
187
 
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
188
 
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
189
 
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
190
 
<B>Method Summary</B></FONT></TH>
191
 
</TR>
192
 
<TR BGCOLOR="white" CLASS="TableRowColor">
193
 
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
194
 
<CODE>&nbsp;int</CODE></FONT></TD>
195
 
<TD><CODE><B><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#difference(java.lang.String, java.lang.String)">difference</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;s1,
196
 
                     <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;s2)</CODE>
197
 
 
198
 
<BR>
199
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Encodes the Strings and returns the number of characters in the two encoded Strings that are the same.</TD>
200
 
</TR>
201
 
<TR BGCOLOR="white" CLASS="TableRowColor">
202
 
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
203
 
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
204
 
<TD><CODE><B><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#encode(java.lang.Object)">encode</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;pObject)</CODE>
205
 
 
206
 
<BR>
207
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Encodes an Object using the soundex algorithm.</TD>
208
 
</TR>
209
 
<TR BGCOLOR="white" CLASS="TableRowColor">
210
 
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
211
 
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
212
 
<TD><CODE><B><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#encode(java.lang.String)">encode</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;pString)</CODE>
213
 
 
214
 
<BR>
215
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Encodes a String using the soundex algorithm.</TD>
216
 
</TR>
217
 
<TR BGCOLOR="white" CLASS="TableRowColor">
218
 
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
219
 
<CODE>&nbsp;int</CODE></FONT></TD>
220
 
<TD><CODE><B><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#getMaxLength()">getMaxLength</A></B>()</CODE>
221
 
 
222
 
<BR>
223
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>This feature is not needed since the encoding size must be constant. Will be removed in 2.0.</I></TD>
224
 
</TR>
225
 
<TR BGCOLOR="white" CLASS="TableRowColor">
226
 
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
227
 
<CODE>&nbsp;void</CODE></FONT></TD>
228
 
<TD><CODE><B><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#setMaxLength(int)">setMaxLength</A></B>(int&nbsp;maxLength)</CODE>
229
 
 
230
 
<BR>
231
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;<I>This feature is not needed since the encoding size must be constant. Will be removed in 2.0.</I></TD>
232
 
</TR>
233
 
<TR BGCOLOR="white" CLASS="TableRowColor">
234
 
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
235
 
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
236
 
<TD><CODE><B><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#soundex(java.lang.String)">soundex</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;str)</CODE>
237
 
 
238
 
<BR>
239
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Retrieves the Soundex code for a given String object.</TD>
240
 
</TR>
241
 
</TABLE>
242
 
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
243
 
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
244
 
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
245
 
<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></B></TH>
246
 
</TR>
247
 
<TR BGCOLOR="white" CLASS="TableRowColor">
248
 
<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
249
 
</TR>
250
 
</TABLE>
251
 
&nbsp;
252
 
<P>
253
 
 
254
 
<!-- ============ FIELD DETAIL =========== -->
255
 
 
256
 
<A NAME="field_detail"><!-- --></A>
257
 
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
258
 
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
259
 
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
260
 
<B>Field Detail</B></FONT></TH>
261
 
</TR>
262
 
</TABLE>
263
 
 
264
 
<A NAME="US_ENGLISH_MAPPING_STRING"><!-- --></A><H3>
265
 
US_ENGLISH_MAPPING_STRING</H3>
266
 
<PRE>
267
 
public static final <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.42"><B>US_ENGLISH_MAPPING_STRING</B></A></PRE>
268
 
<DL>
269
 
<DD>This is a default mapping of the 26 letters used in US English. A value of <code>0</code> for a letter position
270
 
 means do not encode.
271
 
 <p>
272
 
 (This constant is provided as both an implementation convenience and to allow Javadoc to pick
273
 
 up the value for the constant values page.)
274
 
 </p>
275
 
<P>
276
 
<DL>
277
 
<DT><B>See Also:</B><DD><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#US_ENGLISH_MAPPING"><CODE>US_ENGLISH_MAPPING</CODE></A>, 
278
 
<A HREF="../../../../../constant-values.html#org.apache.commons.codec.language.Soundex.US_ENGLISH_MAPPING_STRING">Constant Field Values</A></DL>
279
 
</DL>
280
 
<HR>
281
 
 
282
 
<A NAME="US_ENGLISH_MAPPING"><!-- --></A><H3>
283
 
US_ENGLISH_MAPPING</H3>
284
 
<PRE>
285
 
public static final char[] <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.50"><B>US_ENGLISH_MAPPING</B></A></PRE>
286
 
<DL>
287
 
<DD>This is a default mapping of the 26 letters used in US English. A value of <code>0</code> for a letter position
288
 
 means do not encode.
289
 
<P>
290
 
<DL>
291
 
<DT><B>See Also:</B><DD><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#Soundex(char[])"><CODE>Soundex(char[])</CODE></A></DL>
292
 
</DL>
293
 
<HR>
294
 
 
295
 
<A NAME="US_ENGLISH"><!-- --></A><H3>
296
 
US_ENGLISH</H3>
297
 
<PRE>
298
 
public static final <A HREF="../../../../../org/apache/commons/codec/language/Soundex.html" title="class in org.apache.commons.codec.language">Soundex</A> <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.57"><B>US_ENGLISH</B></A></PRE>
299
 
<DL>
300
 
<DD>An instance of Soundex using the US_ENGLISH_MAPPING mapping.
301
 
<P>
302
 
<DL>
303
 
<DT><B>See Also:</B><DD><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#US_ENGLISH_MAPPING"><CODE>US_ENGLISH_MAPPING</CODE></A></DL>
304
 
</DL>
305
 
 
306
 
<!-- ========= CONSTRUCTOR DETAIL ======== -->
307
 
 
308
 
<A NAME="constructor_detail"><!-- --></A>
309
 
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
310
 
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
311
 
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
312
 
<B>Constructor Detail</B></FONT></TH>
313
 
</TR>
314
 
</TABLE>
315
 
 
316
 
<A NAME="Soundex()"><!-- --></A><H3>
317
 
Soundex</H3>
318
 
<PRE>
319
 
public <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.102"><B>Soundex</B></A>()</PRE>
320
 
<DL>
321
 
<DD>Creates an instance using US_ENGLISH_MAPPING
322
 
<P>
323
 
<DL>
324
 
<DT><B>See Also:</B><DD><A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#Soundex(char[])"><CODE>Soundex(char[])</CODE></A>, 
325
 
<A HREF="../../../../../org/apache/commons/codec/language/Soundex.html#US_ENGLISH_MAPPING"><CODE>US_ENGLISH_MAPPING</CODE></A></DL>
326
 
</DL>
327
 
<HR>
328
 
 
329
 
<A NAME="Soundex(char[])"><!-- --></A><H3>
330
 
Soundex</H3>
331
 
<PRE>
332
 
public <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.116"><B>Soundex</B></A>(char[]&nbsp;mapping)</PRE>
333
 
<DL>
334
 
<DD>Creates a soundex instance using the given mapping. This constructor can be used to provide an internationalized
335
 
 mapping for a non-Western character set.
336
 
 
337
 
 Every letter of the alphabet is "mapped" to a numerical value. This char array holds the values to which each
338
 
 letter is mapped. This implementation contains a default map for US_ENGLISH
339
 
<P>
340
 
<DL>
341
 
<DT><B>Parameters:</B><DD><CODE>mapping</CODE> - Mapping array to use when finding the corresponding code for a given character</DL>
342
 
</DL>
343
 
<HR>
344
 
 
345
 
<A NAME="Soundex(java.lang.String)"><!-- --></A><H3>
346
 
Soundex</H3>
347
 
<PRE>
348
 
public <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.129"><B>Soundex</B></A>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;mapping)</PRE>
349
 
<DL>
350
 
<DD>Creates a refined soundex instance using a custom mapping. This constructor can be used to customize the mapping,
351
 
 and/or possibly provide an internationalized mapping for a non-Western character set.
352
 
<P>
353
 
<DL>
354
 
<DT><B>Parameters:</B><DD><CODE>mapping</CODE> - Mapping string to use when finding the corresponding code for a given character<DT><B>Since:</B></DT>
355
 
  <DD>1.4</DD>
356
 
</DL>
357
 
</DL>
358
 
 
359
 
<!-- ============ METHOD DETAIL ========== -->
360
 
 
361
 
<A NAME="method_detail"><!-- --></A>
362
 
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
363
 
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
364
 
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
365
 
<B>Method Detail</B></FONT></TH>
366
 
</TR>
367
 
</TABLE>
368
 
 
369
 
<A NAME="difference(java.lang.String, java.lang.String)"><!-- --></A><H3>
370
 
difference</H3>
371
 
<PRE>
372
 
public int <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.79"><B>difference</B></A>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;s1,
373
 
                      <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;s2)
374
 
               throws <A HREF="../../../../../org/apache/commons/codec/EncoderException.html" title="class in org.apache.commons.codec">EncoderException</A></PRE>
375
 
<DL>
376
 
<DD>Encodes the Strings and returns the number of characters in the two encoded Strings that are the same. This
377
 
 return value ranges from 0 through 4: 0 indicates little or no similarity, and 4 indicates strong similarity or
378
 
 identical values.
379
 
<P>
380
 
<DD><DL>
381
 
</DL>
382
 
</DD>
383
 
<DD><DL>
384
 
<DT><B>Parameters:</B><DD><CODE>s1</CODE> - A String that will be encoded and compared.<DD><CODE>s2</CODE> - A String that will be encoded and compared.
385
 
<DT><B>Returns:</B><DD>The number of characters in the two encoded Strings that are the same from 0 to 4.
386
 
<DT><B>Throws:</B>
387
 
<DD><CODE><A HREF="../../../../../org/apache/commons/codec/EncoderException.html" title="class in org.apache.commons.codec">EncoderException</A></CODE> - if an error occurs encoding one of the strings<DT><B>Since:</B></DT>
388
 
  <DD>1.3</DD>
389
 
<DT><B>See Also:</B><DD><CODE>SoundexUtils.difference(StringEncoder,String,String)</CODE>, 
390
 
<a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/tsqlref/ts_de-dz_8co5.asp"> MS
391
 
          T-SQL DIFFERENCE </a></DL>
392
 
</DD>
393
 
</DL>
394
 
<HR>
395
 
 
396
 
<A NAME="encode(java.lang.Object)"><!-- --></A><H3>
397
 
encode</H3>
398
 
<PRE>
399
 
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.146"><B>encode</B></A>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;pObject)
400
 
              throws <A HREF="../../../../../org/apache/commons/codec/EncoderException.html" title="class in org.apache.commons.codec">EncoderException</A></PRE>
401
 
<DL>
402
 
<DD>Encodes an Object using the soundex algorithm. This method is provided in order to satisfy the requirements of
403
 
 the Encoder interface, and will throw an EncoderException if the supplied object is not of type java.lang.String.
404
 
<P>
405
 
<DD><DL>
406
 
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../org/apache/commons/codec/Encoder.html#encode(java.lang.Object)">encode</A></CODE> in interface <CODE><A HREF="../../../../../org/apache/commons/codec/Encoder.html" title="interface in org.apache.commons.codec">Encoder</A></CODE></DL>
407
 
</DD>
408
 
<DD><DL>
409
 
<DT><B>Parameters:</B><DD><CODE>pObject</CODE> - Object to encode
410
 
<DT><B>Returns:</B><DD>An object (or type java.lang.String) containing the soundex code which corresponds to the String
411
 
             supplied.
412
 
<DT><B>Throws:</B>
413
 
<DD><CODE><A HREF="../../../../../org/apache/commons/codec/EncoderException.html" title="class in org.apache.commons.codec">EncoderException</A></CODE> - if the parameter supplied is not of type java.lang.String
414
 
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if a character is not mapped</DL>
415
 
</DD>
416
 
</DL>
417
 
<HR>
418
 
 
419
 
<A NAME="encode(java.lang.String)"><!-- --></A><H3>
420
 
encode</H3>
421
 
<PRE>
422
 
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.162"><B>encode</B></A>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;pString)</PRE>
423
 
<DL>
424
 
<DD>Encodes a String using the soundex algorithm.
425
 
<P>
426
 
<DD><DL>
427
 
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../org/apache/commons/codec/StringEncoder.html#encode(java.lang.String)">encode</A></CODE> in interface <CODE><A HREF="../../../../../org/apache/commons/codec/StringEncoder.html" title="interface in org.apache.commons.codec">StringEncoder</A></CODE></DL>
428
 
</DD>
429
 
<DD><DL>
430
 
<DT><B>Parameters:</B><DD><CODE>pString</CODE> - A String object to encode
431
 
<DT><B>Returns:</B><DD>A Soundex code corresponding to the String supplied
432
 
<DT><B>Throws:</B>
433
 
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if a character is not mapped</DL>
434
 
</DD>
435
 
</DL>
436
 
<HR>
437
 
 
438
 
<A NAME="getMaxLength()"><!-- --></A><H3>
439
 
getMaxLength</H3>
440
 
<PRE>
441
 
public int <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.202"><B>getMaxLength</B></A>()</PRE>
442
 
<DL>
443
 
<DD><B>Deprecated.</B>&nbsp;<I>This feature is not needed since the encoding size must be constant. Will be removed in 2.0.</I>
444
 
<P>
445
 
<DD>Returns the maxLength. Standard Soundex
446
 
<P>
447
 
<DD><DL>
448
 
</DL>
449
 
</DD>
450
 
<DD><DL>
451
 
 
452
 
<DT><B>Returns:</B><DD>int</DL>
453
 
</DD>
454
 
</DL>
455
 
<HR>
456
 
 
457
 
<A NAME="setMaxLength(int)"><!-- --></A><H3>
458
 
setMaxLength</H3>
459
 
<PRE>
460
 
public void <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.239"><B>setMaxLength</B></A>(int&nbsp;maxLength)</PRE>
461
 
<DL>
462
 
<DD><B>Deprecated.</B>&nbsp;<I>This feature is not needed since the encoding size must be constant. Will be removed in 2.0.</I>
463
 
<P>
464
 
<DD>Sets the maxLength.
465
 
<P>
466
 
<DD><DL>
467
 
</DL>
468
 
</DD>
469
 
<DD><DL>
470
 
<DT><B>Parameters:</B><DD><CODE>maxLength</CODE> - The maxLength to set</DL>
471
 
</DD>
472
 
</DL>
473
 
<HR>
474
 
 
475
 
<A NAME="soundex(java.lang.String)"><!-- --></A><H3>
476
 
soundex</H3>
477
 
<PRE>
478
 
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../../src-html/org/apache/commons/codec/language/Soundex.html#line.252"><B>soundex</B></A>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;str)</PRE>
479
 
<DL>
480
 
<DD>Retrieves the Soundex code for a given String object.
481
 
<P>
482
 
<DD><DL>
483
 
</DL>
484
 
</DD>
485
 
<DD><DL>
486
 
<DT><B>Parameters:</B><DD><CODE>str</CODE> - String to encode using the Soundex algorithm
487
 
<DT><B>Returns:</B><DD>A soundex code for the String supplied
488
 
<DT><B>Throws:</B>
489
 
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if a character is not mapped</DL>
490
 
</DD>
491
 
</DL>
492
 
<!-- ========= END OF CLASS DATA ========= -->
493
 
<HR>
494
 
 
495
 
 
496
 
<!-- ======= START OF BOTTOM NAVBAR ====== -->
497
 
<A NAME="navbar_bottom"><!-- --></A>
498
 
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
499
 
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
500
 
<TR>
501
 
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
502
 
<A NAME="navbar_bottom_firstrow"><!-- --></A>
503
 
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
504
 
  <TR ALIGN="center" VALIGN="top">
505
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
506
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
507
 
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
508
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Soundex.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
509
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
510
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
511
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
512
 
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
513
 
  </TR>
514
 
</TABLE>
515
 
</TD>
516
 
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
517
 
</EM>
518
 
</TD>
519
 
</TR>
520
 
 
521
 
<TR>
522
 
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
523
 
&nbsp;<A HREF="../../../../../org/apache/commons/codec/language/RefinedSoundex.html" title="class in org.apache.commons.codec.language"><B>PREV CLASS</B></A>&nbsp;
524
 
&nbsp;NEXT CLASS</FONT></TD>
525
 
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
526
 
  <A HREF="../../../../../index.html?org/apache/commons/codec/language/Soundex.html" target="_top"><B>FRAMES</B></A>  &nbsp;
527
 
&nbsp;<A HREF="Soundex.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
528
 
&nbsp;<SCRIPT type="text/javascript">
529
 
  <!--
530
 
  if(window==top) {
531
 
    document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
532
 
  }
533
 
  //-->
534
 
</SCRIPT>
535
 
<NOSCRIPT>
536
 
  <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
537
 
</NOSCRIPT>
538
 
 
539
 
 
540
 
</FONT></TD>
541
 
</TR>
542
 
<TR>
543
 
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
544
 
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
545
 
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
546
 
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
547
 
</TR>
548
 
</TABLE>
549
 
<A NAME="skip-navbar_bottom"></A>
550
 
<!-- ======== END OF BOTTOM NAVBAR ======= -->
551
 
 
552
 
<HR>
553
 
Copyright &#169; 2002-2009 <a href="http://www.apache.org/">The Apache Software Foundation</a>. All Rights Reserved.
554
 
</BODY>
555
 
</HTML>