KezvhLib/lib/com.google.com.collect/javadoc/com/google/common/base/Join.html

   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.5.0_06) on Wed Aug 20 17:16:43 PDT 2008 -->
   6 <TITLE>
   7 Join (Google Collections Library - snapshot-20080820 (ALPHA))
   8 </TITLE>
   9
  10 <META NAME="keywords" CONTENT="com.google.common.base.Join class">
  11
  12 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
  13
  14 <SCRIPT type="text/javascript">
  15 function windowTitle()
  16 {
  17     parent.document.title="Join (Google Collections Library - snapshot-20080820 (ALPHA))";
  18 }
  19 </SCRIPT>
  20 <NOSCRIPT>
  21 </NOSCRIPT>
  22
  23 </HEAD>
  24
  25 <BODY BGCOLOR="white" onload="windowTitle();">
  26
  27
  28 <!-- ========= START OF TOP NAVBAR ======= -->
  29 <A NAME="navbar_top"><!-- --></A>
  30 <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
  31 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
  32 <TR>
  33 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  34 <A NAME="navbar_top_firstrow"><!-- --></A>
  35 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  36   <TR ALIGN="center" VALIGN="top">
  37   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  38   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  39   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  40   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  41   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  42   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  43   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  44   </TR>
  45 </TABLE>
  46 </TD>
  47 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  48 </EM>
  49 </TD>
  50 </TR>
  51
  52 <TR>
  53 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  54 &nbsp;<A HREF="../../../../com/google/common/base/Functions.html" title="class in com.google.common.base"><B>PREV CLASS</B></A>&nbsp;
  55 &nbsp;<A HREF="../../../../com/google/common/base/Join.JoinException.html" title="class in com.google.common.base"><B>NEXT CLASS</B></A></FONT></TD>
  56 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  57   <A HREF="../../../../index.html?com/google/common/base/Join.html" target="_top"><B>FRAMES</B></A>  &nbsp;
  58 &nbsp;<A HREF="Join.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
  59 &nbsp;<SCRIPT type="text/javascript">
  60   <!--
  61   if(window==top) {
  62     document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
  63   }
  64   //-->
  65 </SCRIPT>
  66 <NOSCRIPT>
  67   <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
  68 </NOSCRIPT>
  69
  70
  71 </FONT></TD>
  72 </TR>
  73 <TR>
  74 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  75   SUMMARY:&nbsp;<A HREF="#nested_class_summary">NESTED</A>&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  76 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  77 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  78 </TR>
  79 </TABLE>
  80 <A NAME="skip-navbar_top"></A>
  81 <!-- ========= END OF TOP NAVBAR ========= -->
  82
  83 <HR>
  84 <!-- ======== START OF CLASS DATA ======== -->
  85 <H2>
  86 <FONT SIZE="-1">
  87 com.google.common.base</FONT>
  88 <BR>
  89 Class Join</H2>
  90 <PRE>
  91 <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">java.lang.Object</A>
  92   <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>com.google.common.base.Join</B>
  93 </PRE>
  94 <HR>
  95 <DL>
  96 <DT><PRE>public final class <B>Join</B><DT>extends <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></DL>
  97 </PRE>
  98
  99 <P>
 100 Utility for joining pieces of text separated by a delimiter. It can handle
 101  iterators, collections, arrays, and varargs, and can append to any
 102  <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html" title="class or interface in java.lang"><CODE>Appendable</CODE></A> or just return a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang"><CODE>String</CODE></A>. For example,
 103  <code>join(":", "a", "b", "c")</code> returns <code>"a:b:c"</code>.
 104
 105  <p>All methods of this class throw <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html" title="class or interface in java.lang"><CODE>NullPointerException</CODE></A> when a value
 106  of <code>null</code> is supplied for any parameter. The elements within the
 107  collection, iterator, array, or varargs parameter list <i>may</i> be null --
 108  these will be represented in the output by the string <code>"null"</code>.
 109 <P>
 110
 111 <P>
 112 <DL>
 113 <DT><B>Author:</B></DT>
 114   <DD>Kevin Bourrillion</DD>
 115 </DL>
 116 <HR>
 117
 118 <P>
 119 <!-- ======== NESTED CLASS SUMMARY ======== -->
 120
 121 <A NAME="nested_class_summary"><!-- --></A>
 122 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 123 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 124 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
 125 <B>Nested Class Summary</B></FONT></TH>
 126 </TR>
 127 <TR BGCOLOR="white" CLASS="TableRowColor">
 128 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 129 <CODE>static&nbsp;class</CODE></FONT></TD>
 130 <TD><CODE><B><A HREF="../../../../com/google/common/base/Join.JoinException.html" title="class in com.google.common.base">Join.JoinException</A></B></CODE>
 131
 132 <BR>
 133 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Exception thrown in response to an <A HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html" title="class or interface in java.io"><CODE>IOException</CODE></A> from the supplied
 134  <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html" title="class or interface in java.lang"><CODE>Appendable</CODE></A>.</TD>
 135 </TR>
 136 </TABLE>
 137 &nbsp;
 138 <!-- ========== METHOD SUMMARY =========== -->
 139
 140 <A NAME="method_summary"><!-- --></A>
 141 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 142 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 143 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
 144 <B>Method Summary</B></FONT></TH>
 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/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
 149 <TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(java.lang.String, java.lang.Iterable)">join</A></B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 150      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html" title="class or interface in java.lang">Iterable</A>&lt;?&gt;&nbsp;tokens)</CODE>
 151
 152 <BR>
 153 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a string containing the <code>tokens</code>, converted to strings if
 154  necessary, separated by <code>delimiter</code>.</TD>
 155 </TR>
 156 <TR BGCOLOR="white" CLASS="TableRowColor">
 157 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 158 <CODE>static&nbsp;<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
 159 <TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(java.lang.String, java.util.Iterator)">join</A></B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 160      <A HREF="http://java.sun.com/javase/6/docs/api/java/util/Iterator.html" title="class or interface in java.util">Iterator</A>&lt;?&gt;&nbsp;tokens)</CODE>
 161
 162 <BR>
 163 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a string containing the <code>tokens</code>, converted to strings if
 164  necessary, separated by <code>delimiter</code>.</TD>
 165 </TR>
 166 <TR BGCOLOR="white" CLASS="TableRowColor">
 167 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 168 <CODE>static&nbsp;<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
 169 <TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(java.lang.String, java.lang.Object[])">join</A></B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 170      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>[]&nbsp;tokens)</CODE>
 171
 172 <BR>
 173 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a string containing the <code>tokens</code>, converted to strings if
 174  necessary, separated by <code>delimiter</code>.</TD>
 175 </TR>
 176 <TR BGCOLOR="white" CLASS="TableRowColor">
 177 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 178 <CODE>static&nbsp;<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
 179 <TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(java.lang.String, java.lang.Object, java.lang.Object...)">join</A></B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 180      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>&nbsp;firstToken,
 181      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>...&nbsp;otherTokens)</CODE>
 182
 183 <BR>
 184 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a string containing the <code>tokens</code>, converted to strings if
 185  necessary, separated by <code>delimiter</code>.</TD>
 186 </TR>
 187 <TR BGCOLOR="white" CLASS="TableRowColor">
 188 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 189 <CODE>static&nbsp;<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
 190 <TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(java.lang.String, java.lang.String, java.util.Map)">join</A></B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;keyValueSeparator,
 191      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;entryDelimiter,
 192      <A HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html" title="class or interface in java.util">Map</A>&lt;?,?&gt;&nbsp;map)</CODE>
 193
 194 <BR>
 195 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a string containing the contents of <code>map</code>, with entries
 196  separated by <code>entryDelimiter</code>, and keys and values separated with
 197  <code>keyValueSeparator</code>.</TD>
 198 </TR>
 199 <TR BGCOLOR="white" CLASS="TableRowColor">
 200 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 201 <CODE>static
 202 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
 203 <TR ALIGN="right" VALIGN="">
 204 <TD NOWRAP><FONT SIZE="-1">
 205 <CODE>&lt;T extends <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html" title="class or interface in java.lang">Appendable</A>&gt;
 206 <BR>
 207 T</CODE></FONT></TD>
 208 </TR>
 209 </TABLE>
 210 </CODE></FONT></TD>
 211 <TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(T, java.lang.String, java.lang.Iterable)">join</A></B>(T&nbsp;appendable,
 212      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 213      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html" title="class or interface in java.lang">Iterable</A>&lt;?&gt;&nbsp;tokens)</CODE>
 214
 215 <BR>
 216 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Appends each of the <code>tokens</code> to <code>appendable</code>, separated by
 217  <code>delimiter</code>.</TD>
 218 </TR>
 219 <TR BGCOLOR="white" CLASS="TableRowColor">
 220 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 221 <CODE>static
 222 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
 223 <TR ALIGN="right" VALIGN="">
 224 <TD NOWRAP><FONT SIZE="-1">
 225 <CODE>&lt;T extends <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html" title="class or interface in java.lang">Appendable</A>&gt;
 226 <BR>
 227 T</CODE></FONT></TD>
 228 </TR>
 229 </TABLE>
 230 </CODE></FONT></TD>
 231 <TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(T, java.lang.String, java.util.Iterator)">join</A></B>(T&nbsp;appendable,
 232      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 233      <A HREF="http://java.sun.com/javase/6/docs/api/java/util/Iterator.html" title="class or interface in java.util">Iterator</A>&lt;?&gt;&nbsp;tokens)</CODE>
 234
 235 <BR>
 236 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Appends each of the <code>tokens</code> to <code>appendable</code>, separated by
 237  <code>delimiter</code>.</TD>
 238 </TR>
 239 <TR BGCOLOR="white" CLASS="TableRowColor">
 240 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 241 <CODE>static
 242 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
 243 <TR ALIGN="right" VALIGN="">
 244 <TD NOWRAP><FONT SIZE="-1">
 245 <CODE>&lt;T extends <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html" title="class or interface in java.lang">Appendable</A>&gt;
 246 <BR>
 247 T</CODE></FONT></TD>
 248 </TR>
 249 </TABLE>
 250 </CODE></FONT></TD>
 251 <TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(T, java.lang.String, java.lang.Object[])">join</A></B>(T&nbsp;appendable,
 252      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 253      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>[]&nbsp;tokens)</CODE>
 254
 255 <BR>
 256 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Appends each of the <code>tokens</code> to <code>appendable</code>, separated by
 257  <code>delimiter</code>.</TD>
 258 </TR>
 259 <TR BGCOLOR="white" CLASS="TableRowColor">
 260 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 261 <CODE>static
 262 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
 263 <TR ALIGN="right" VALIGN="">
 264 <TD NOWRAP><FONT SIZE="-1">
 265 <CODE>&lt;T extends <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html" title="class or interface in java.lang">Appendable</A>&gt;
 266 <BR>
 267 T</CODE></FONT></TD>
 268 </TR>
 269 </TABLE>
 270 </CODE></FONT></TD>
 271 <TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(T, java.lang.String, java.lang.Object, java.lang.Object...)">join</A></B>(T&nbsp;appendable,
 272      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 273      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>&nbsp;firstToken,
 274      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>...&nbsp;otherTokens)</CODE>
 275
 276 <BR>
 277 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Appends each of the <code>tokens</code> to <code>appendable</code>, separated by
 278  <code>delimiter</code>.</TD>
 279 </TR>
 280 <TR BGCOLOR="white" CLASS="TableRowColor">
 281 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 282 <CODE>static
 283 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
 284 <TR ALIGN="right" VALIGN="">
 285 <TD NOWRAP><FONT SIZE="-1">
 286 <CODE>&lt;T extends <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html" title="class or interface in java.lang">Appendable</A>&gt;
 287 <BR>
 288 T</CODE></FONT></TD>
 289 </TR>
 290 </TABLE>
 291 </CODE></FONT></TD>
 292 <TD><CODE><B><A HREF="../../../../com/google/common/base/Join.html#join(T, java.lang.String, java.lang.String, java.util.Map)">join</A></B>(T&nbsp;appendable,
 293      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;keyValueSeparator,
 294      <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;entryDelimiter,
 295      <A HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html" title="class or interface in java.util">Map</A>&lt;?,?&gt;&nbsp;map)</CODE>
 296
 297 <BR>
 298 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Appends the contents of <code>map</code> to <code>appendable</code>, with entries
 299  separated by <code>entryDelimiter</code>, and keys and values separated with
 300  <code>keyValueSeparator</code>.</TD>
 301 </TR>
 302 </TABLE>
 303 &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
 304 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 305 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
 306 <TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TH>
 307 </TR>
 308 <TR BGCOLOR="white" CLASS="TableRowColor">
 309 <TD><CODE><A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
 310 </TR>
 311 </TABLE>
 312 &nbsp;
 313 <P>
 314
 315 <!-- ============ METHOD DETAIL ========== -->
 316
 317 <A NAME="method_detail"><!-- --></A>
 318 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 319 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 320 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
 321 <B>Method Detail</B></FONT></TH>
 322 </TR>
 323 </TABLE>
 324
 325 <A NAME="join(java.lang.String, java.lang.Iterable)"><!-- --></A><H3>
 326 join</H3>
 327 <PRE>
 328 public static <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>join</B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 329                           <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html" title="class or interface in java.lang">Iterable</A>&lt;?&gt;&nbsp;tokens)</PRE>
 330 <DL>
 331 <DD>Returns a string containing the <code>tokens</code>, converted to strings if
 332  necessary, separated by <code>delimiter</code>. If <code>tokens</code> is empty, it
 333  returns an empty string.
 334
 335  <p>Each token will be converted to a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
 336  <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#valueOf(java.lang.Object)" title="class or interface in java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> already.
 337  Note that this implies that null tokens will be appended as the
 338  four-character string <code>"null"</code>.
 339 <P>
 340 <DD><DL>
 341 <DT><B>Parameters:</B><DD><CODE>delimiter</CODE> - a string to append between every element, but not at the
 342      beginning or end<DD><CODE>tokens</CODE> - objects to append
 343 <DT><B>Returns:</B><DD>a string consisting of the joined elements</DL>
 344 </DD>
 345 </DL>
 346 <HR>
 347
 348 <A NAME="join(java.lang.String, java.lang.Object[])"><!-- --></A><H3>
 349 join</H3>
 350 <PRE>
 351 public static <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>join</B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 352                           <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>[]&nbsp;tokens)</PRE>
 353 <DL>
 354 <DD>Returns a string containing the <code>tokens</code>, converted to strings if
 355  necessary, separated by <code>delimiter</code>. If <code>tokens</code> is empty, it
 356  returns an empty string.
 357
 358  <p>Each token will be converted to a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
 359  <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#valueOf(java.lang.Object)" title="class or interface in java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> already.
 360  Note that this implies that null tokens will be appended as the
 361  four-character string <code>"null"</code>.
 362 <P>
 363 <DD><DL>
 364 <DT><B>Parameters:</B><DD><CODE>delimiter</CODE> - a string to append between every element, but not at the
 365      beginning or end<DD><CODE>tokens</CODE> - objects to append
 366 <DT><B>Returns:</B><DD>a string consisting of the joined elements</DL>
 367 </DD>
 368 </DL>
 369 <HR>
 370
 371 <A NAME="join(java.lang.String, java.lang.Object, java.lang.Object...)"><!-- --></A><H3>
 372 join</H3>
 373 <PRE>
 374 public static <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>join</B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 375                           <FONT SIZE="-1"><A HREF="../../../../com/google/common/base/Nullable.html" title="annotation in com.google.common.base">@Nullable</A></FONT>
 376                           <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>&nbsp;firstToken,
 377                           <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>...&nbsp;otherTokens)</PRE>
 378 <DL>
 379 <DD>Returns a string containing the <code>tokens</code>, converted to strings if
 380  necessary, separated by <code>delimiter</code>.
 381
 382  <p>Each token will be converted to a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
 383  <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#valueOf(java.lang.Object)" title="class or interface in java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> already.
 384  Note that this implies that null tokens will be appended as the
 385  four-character string <code>"null"</code>.
 386 <P>
 387 <DD><DL>
 388 <DT><B>Parameters:</B><DD><CODE>delimiter</CODE> - a string to append between every element, but not at the
 389      beginning or end<DD><CODE>firstToken</CODE> - the first object to append<DD><CODE>otherTokens</CODE> - subsequent objects to append
 390 <DT><B>Returns:</B><DD>a string consisting of the joined elements</DL>
 391 </DD>
 392 </DL>
 393 <HR>
 394
 395 <A NAME="join(java.lang.String, java.util.Iterator)"><!-- --></A><H3>
 396 join</H3>
 397 <PRE>
 398 public static <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>join</B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 399                           <A HREF="http://java.sun.com/javase/6/docs/api/java/util/Iterator.html" title="class or interface in java.util">Iterator</A>&lt;?&gt;&nbsp;tokens)</PRE>
 400 <DL>
 401 <DD>Returns a string containing the <code>tokens</code>, converted to strings if
 402  necessary, separated by <code>delimiter</code>. If <code>tokens</code> is empty, it
 403  returns an empty string.
 404
 405  <p>Each token will be converted to a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
 406  <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#valueOf(java.lang.Object)" title="class or interface in java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> already.
 407  Note that this implies that null tokens will be appended as the
 408  four-character string <code>"null"</code>.
 409 <P>
 410 <DD><DL>
 411 <DT><B>Parameters:</B><DD><CODE>delimiter</CODE> - a string to append between every element, but not at the
 412      beginning or end<DD><CODE>tokens</CODE> - objects to append
 413 <DT><B>Returns:</B><DD>a string consisting of the joined elements</DL>
 414 </DD>
 415 </DL>
 416 <HR>
 417
 418 <A NAME="join(java.lang.String, java.lang.String, java.util.Map)"><!-- --></A><H3>
 419 join</H3>
 420 <PRE>
 421 public static <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>join</B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;keyValueSeparator,
 422                           <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;entryDelimiter,
 423                           <A HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html" title="class or interface in java.util">Map</A>&lt;?,?&gt;&nbsp;map)</PRE>
 424 <DL>
 425 <DD>Returns a string containing the contents of <code>map</code>, with entries
 426  separated by <code>entryDelimiter</code>, and keys and values separated with
 427  <code>keyValueSeparator</code>.
 428
 429  <p>Each key and value will be converted to a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
 430  <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#valueOf(java.lang.Object)" title="class or interface in java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> already.
 431  Note that this implies that null tokens will be appended as the
 432  four-character string <code>"null"</code>.
 433 <P>
 434 <DD><DL>
 435 <DT><B>Parameters:</B><DD><CODE>keyValueSeparator</CODE> - a string to append between every key and its
 436      associated value<DD><CODE>entryDelimiter</CODE> - a string to append between every entry, but not at
 437      the beginning or end<DD><CODE>map</CODE> - the map containing the data to join
 438 <DT><B>Returns:</B><DD>a string consisting of the joined entries of the map; empty if the
 439      map is empty</DL>
 440 </DD>
 441 </DL>
 442 <HR>
 443
 444 <A NAME="join(java.lang.Appendable,java.lang.String,java.lang.Iterable)"><!-- --></A><A NAME="join(T, java.lang.String, java.lang.Iterable)"><!-- --></A><H3>
 445 join</H3>
 446 <PRE>
 447 public static &lt;T extends <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html" title="class or interface in java.lang">Appendable</A>&gt; T <B>join</B>(T&nbsp;appendable,
 448                                             <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 449                                             <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html" title="class or interface in java.lang">Iterable</A>&lt;?&gt;&nbsp;tokens)</PRE>
 450 <DL>
 451 <DD>Appends each of the <code>tokens</code> to <code>appendable</code>, separated by
 452  <code>delimiter</code>.
 453
 454  <p>Each token will be converted to a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
 455  <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#valueOf(java.lang.Object)" title="class or interface in java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> already.
 456  Note that this implies that null tokens will be appended as the
 457  four-character string <code>"null"</code>.
 458 <P>
 459 <DD><DL>
 460 <DT><B>Parameters:</B><DD><CODE>appendable</CODE> - the object to append the results to<DD><CODE>delimiter</CODE> - a string to append between every element, but not at the
 461      beginning or end<DD><CODE>tokens</CODE> - objects to append
 462 <DT><B>Returns:</B><DD>the same <code>Appendable</code> instance that was passed in
 463 <DT><B>Throws:</B>
 464 <DD><CODE><A HREF="../../../../com/google/common/base/Join.JoinException.html" title="class in com.google.common.base">Join.JoinException</A></CODE> - if an <A HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html" title="class or interface in java.io"><CODE>IOException</CODE></A> occurs</DL>
 465 </DD>
 466 </DL>
 467 <HR>
 468
 469 <A NAME="join(java.lang.Appendable,java.lang.String,java.lang.Object)"><!-- --></A><A NAME="join(T, java.lang.String, java.lang.Object[])"><!-- --></A><H3>
 470 join</H3>
 471 <PRE>
 472 public static &lt;T extends <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html" title="class or interface in java.lang">Appendable</A>&gt; T <B>join</B>(T&nbsp;appendable,
 473                                             <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 474                                             <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>[]&nbsp;tokens)</PRE>
 475 <DL>
 476 <DD>Appends each of the <code>tokens</code> to <code>appendable</code>, separated by
 477  <code>delimiter</code>.
 478
 479  <p>Each token will be converted to a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
 480  <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#valueOf(java.lang.Object)" title="class or interface in java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> already.
 481  Note that this implies that null tokens will be appended as the
 482  four-character string <code>"null"</code>.
 483 <P>
 484 <DD><DL>
 485 <DT><B>Parameters:</B><DD><CODE>appendable</CODE> - the object to append the results to<DD><CODE>delimiter</CODE> - a string to append between every element, but not at the
 486      beginning or end<DD><CODE>tokens</CODE> - objects to append
 487 <DT><B>Returns:</B><DD>the same <code>Appendable</code> instance that was passed in
 488 <DT><B>Throws:</B>
 489 <DD><CODE><A HREF="../../../../com/google/common/base/Join.JoinException.html" title="class in com.google.common.base">Join.JoinException</A></CODE> - if an <A HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html" title="class or interface in java.io"><CODE>IOException</CODE></A> occurs</DL>
 490 </DD>
 491 </DL>
 492 <HR>
 493
 494 <A NAME="join(java.lang.Appendable,java.lang.String,java.lang.Object,java.lang.Object)"><!-- --></A><A NAME="join(T, java.lang.String, java.lang.Object, java.lang.Object...)"><!-- --></A><H3>
 495 join</H3>
 496 <PRE>
 497 public static &lt;T extends <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html" title="class or interface in java.lang">Appendable</A>&gt; T <B>join</B>(T&nbsp;appendable,
 498                                             <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 499                                             <FONT SIZE="-1"><A HREF="../../../../com/google/common/base/Nullable.html" title="annotation in com.google.common.base">@Nullable</A></FONT>
 500                                             <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>&nbsp;firstToken,
 501                                             <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>...&nbsp;otherTokens)</PRE>
 502 <DL>
 503 <DD>Appends each of the <code>tokens</code> to <code>appendable</code>, separated by
 504  <code>delimiter</code>.
 505
 506  <p>Each token will be converted to a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
 507  <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#valueOf(java.lang.Object)" title="class or interface in java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> already.
 508  Note that this implies that null tokens will be appended as the
 509  four-character string <code>"null"</code>.
 510 <P>
 511 <DD><DL>
 512 <DT><B>Parameters:</B><DD><CODE>appendable</CODE> - the object to append the results to<DD><CODE>delimiter</CODE> - a string to append between every element, but not at the
 513      beginning or end<DD><CODE>firstToken</CODE> - the first object to append<DD><CODE>otherTokens</CODE> - subsequent objects to append
 514 <DT><B>Returns:</B><DD>the same <code>Appendable</code> instance that was passed in
 515 <DT><B>Throws:</B>
 516 <DD><CODE><A HREF="../../../../com/google/common/base/Join.JoinException.html" title="class in com.google.common.base">Join.JoinException</A></CODE> - if an <A HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html" title="class or interface in java.io"><CODE>IOException</CODE></A> occurs</DL>
 517 </DD>
 518 </DL>
 519 <HR>
 520
 521 <A NAME="join(java.lang.Appendable,java.lang.String,java.util.Iterator)"><!-- --></A><A NAME="join(T, java.lang.String, java.util.Iterator)"><!-- --></A><H3>
 522 join</H3>
 523 <PRE>
 524 public static &lt;T extends <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html" title="class or interface in java.lang">Appendable</A>&gt; T <B>join</B>(T&nbsp;appendable,
 525                                             <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;delimiter,
 526                                             <A HREF="http://java.sun.com/javase/6/docs/api/java/util/Iterator.html" title="class or interface in java.util">Iterator</A>&lt;?&gt;&nbsp;tokens)</PRE>
 527 <DL>
 528 <DD>Appends each of the <code>tokens</code> to <code>appendable</code>, separated by
 529  <code>delimiter</code>.
 530
 531  <p>Each token will be converted to a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
 532  <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#valueOf(java.lang.Object)" title="class or interface in java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> already.
 533  Note that this implies that null tokens will be appended as the
 534  four-character string <code>"null"</code>.
 535 <P>
 536 <DD><DL>
 537 <DT><B>Parameters:</B><DD><CODE>appendable</CODE> - the object to append the results to<DD><CODE>delimiter</CODE> - a string to append between every element, but not at the
 538      beginning or end<DD><CODE>tokens</CODE> - objects to append
 539 <DT><B>Returns:</B><DD>the same <code>Appendable</code> instance that was passed in
 540 <DT><B>Throws:</B>
 541 <DD><CODE><A HREF="../../../../com/google/common/base/Join.JoinException.html" title="class in com.google.common.base">Join.JoinException</A></CODE> - if an <A HREF="http://java.sun.com/javase/6/docs/api/java/io/IOException.html" title="class or interface in java.io"><CODE>IOException</CODE></A> occurs</DL>
 542 </DD>
 543 </DL>
 544 <HR>
 545
 546 <A NAME="join(java.lang.Appendable,java.lang.String,java.lang.String,java.util.Map)"><!-- --></A><A NAME="join(T, java.lang.String, java.lang.String, java.util.Map)"><!-- --></A><H3>
 547 join</H3>
 548 <PRE>
 549 public static &lt;T extends <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Appendable.html" title="class or interface in java.lang">Appendable</A>&gt; T <B>join</B>(T&nbsp;appendable,
 550                                             <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;keyValueSeparator,
 551                                             <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;entryDelimiter,
 552                                             <A HREF="http://java.sun.com/javase/6/docs/api/java/util/Map.html" title="class or interface in java.util">Map</A>&lt;?,?&gt;&nbsp;map)</PRE>
 553 <DL>
 554 <DD>Appends the contents of <code>map</code> to <code>appendable</code>, with entries
 555  separated by <code>entryDelimiter</code>, and keys and values separated with
 556  <code>keyValueSeparator</code>.
 557
 558  <p>Each key and value will be converted to a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> using
 559  <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/String.html#valueOf(java.lang.Object)" title="class or interface in java.lang"><CODE>String.valueOf(Object)</CODE></A>, if it isn't a <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/CharSequence.html" title="class or interface in java.lang"><CODE>CharSequence</CODE></A> already.
 560  Note that this implies that null tokens will be appended as the
 561  four-character string <code>"null"</code>.
 562 <P>
 563 <DD><DL>
 564 <DT><B>Parameters:</B><DD><CODE>appendable</CODE> - the object to append the results to<DD><CODE>keyValueSeparator</CODE> - a string to append between every key and its
 565      associated value<DD><CODE>entryDelimiter</CODE> - a string to append between every entry, but not at
 566      the beginning or end<DD><CODE>map</CODE> - the map containing the data to join
 567 <DT><B>Returns:</B><DD>the same <code>Appendable</code> instance that was passed in</DL>
 568 </DD>
 569 </DL>
 570 <!-- ========= END OF CLASS DATA ========= -->
 571 <HR>
 572
 573
 574 <!-- ======= START OF BOTTOM NAVBAR ====== -->
 575 <A NAME="navbar_bottom"><!-- --></A>
 576 <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
 577 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
 578 <TR>
 579 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
 580 <A NAME="navbar_bottom_firstrow"><!-- --></A>
 581 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
 582   <TR ALIGN="center" VALIGN="top">
 583   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
 584   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
 585   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
 586   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
 587   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
 588   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
 589   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
 590   </TR>
 591 </TABLE>
 592 </TD>
 593 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
 594 </EM>
 595 </TD>
 596 </TR>
 597
 598 <TR>
 599 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 600 &nbsp;<A HREF="../../../../com/google/common/base/Functions.html" title="class in com.google.common.base"><B>PREV CLASS</B></A>&nbsp;
 601 &nbsp;<A HREF="../../../../com/google/common/base/Join.JoinException.html" title="class in com.google.common.base"><B>NEXT CLASS</B></A></FONT></TD>
 602 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 603   <A HREF="../../../../index.html?com/google/common/base/Join.html" target="_top"><B>FRAMES</B></A>  &nbsp;
 604 &nbsp;<A HREF="Join.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
 605 &nbsp;<SCRIPT type="text/javascript">
 606   <!--
 607   if(window==top) {
 608     document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
 609   }
 610   //-->
 611 </SCRIPT>
 612 <NOSCRIPT>
 613   <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
 614 </NOSCRIPT>
 615
 616
 617 </FONT></TD>
 618 </TR>
 619 <TR>
 620 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 621   SUMMARY:&nbsp;<A HREF="#nested_class_summary">NESTED</A>&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
 622 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 623 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
 624 </TR>
 625 </TABLE>
 626 <A NAME="skip-navbar_bottom"></A>
 627 <!-- ======== END OF BOTTOM NAVBAR ======= -->
 628
 629 <HR>
 630
 631 </BODY>
 632 </HTML>