Home | History | Annotate | Download | only in collect
      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-google-internal) on Mon Jan 04 20:47:58 PST 2010 -->
      6 <TITLE>
      7 ImmutableListMultimap (Guava Libraries 2010.01.04)
      8 </TITLE>
      9 
     10 <META NAME="date" CONTENT="2010-01-04">
     11 
     12 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
     13 
     14 <SCRIPT type="text/javascript">
     15 function windowTitle()
     16 {
     17     if (location.href.indexOf('is-external=true') == -1) {
     18         parent.document.title="ImmutableListMultimap (Guava Libraries 2010.01.04)";
     19     }
     20 }
     21 </SCRIPT>
     22 <NOSCRIPT>
     23 </NOSCRIPT>
     24 
     25 </HEAD>
     26 
     27 <BODY BGCOLOR="white" onload="windowTitle();">
     28 <HR>
     29 
     30 
     31 <!-- ========= START OF TOP NAVBAR ======= -->
     32 <A NAME="navbar_top"><!-- --></A>
     33 <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
     34 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
     35 <TR>
     36 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
     37 <A NAME="navbar_top_firstrow"><!-- --></A>
     38 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
     39   <TR ALIGN="center" VALIGN="top">
     40   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
     41   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
     42   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
     43   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/ImmutableListMultimap.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
     44   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
     45   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
     46   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
     47   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
     48   </TR>
     49 </TABLE>
     50 </TD>
     51 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
     52 </EM>
     53 </TD>
     54 </TR>
     55 
     56 <TR>
     57 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
     58 &nbsp;<A HREF="../../../../com/google/common/collect/ImmutableList.Builder.html" title="class in com.google.common.collect"><B>PREV CLASS</B></A>&nbsp;
     59 &nbsp;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.Builder.html" title="class in com.google.common.collect"><B>NEXT CLASS</B></A></FONT></TD>
     60 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
     61   <A HREF="../../../../index.html?com/google/common/collect/ImmutableListMultimap.html" target="_top"><B>FRAMES</B></A>  &nbsp;
     62 &nbsp;<A HREF="ImmutableListMultimap.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
     63 &nbsp;<SCRIPT type="text/javascript">
     64   <!--
     65   if(window==top) {
     66     document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
     67   }
     68   //-->
     69 </SCRIPT>
     70 <NOSCRIPT>
     71   <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
     72 </NOSCRIPT>
     73 
     74 
     75 </FONT></TD>
     76 </TR>
     77 <TR>
     78 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
     79   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>
     80 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
     81 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
     82 </TR>
     83 </TABLE>
     84 <A NAME="skip-navbar_top"></A>
     85 <!-- ========= END OF TOP NAVBAR ========= -->
     86 
     87 <HR>
     88 <!-- ======== START OF CLASS DATA ======== -->
     89 <H2>
     90 <FONT SIZE="-1">
     91 com.google.common.collect</FONT>
     92 <BR>
     93 Class ImmutableListMultimap&lt;K,V&gt;</H2>
     94 <PRE>
     95 <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</A>
     96   <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../../com/google/common/collect/ImmutableMultimap.html" title="class in com.google.common.collect">com.google.common.collect.ImmutableMultimap</A>&lt;K,V&gt;
     97       <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>com.google.common.collect.ImmutableListMultimap&lt;K,V&gt;</B>
     98 </PRE>
     99 <DL>
    100 <DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../com/google/common/collect/ListMultimap.html" title="interface in com.google.common.collect">ListMultimap</A>&lt;K,V&gt;, <A HREF="../../../../com/google/common/collect/Multimap.html" title="interface in com.google.common.collect">Multimap</A>&lt;K,V&gt;, <A HREF="http://java.sun.com/javase/6/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</A></DD>
    101 </DL>
    102 <HR>
    103 <DL>
    104 <DT><PRE>public class <B>ImmutableListMultimap&lt;K,V&gt;</B><DT>extends <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html" title="class in com.google.common.collect">ImmutableMultimap</A>&lt;K,V&gt;<DT>implements <A HREF="../../../../com/google/common/collect/ListMultimap.html" title="interface in com.google.common.collect">ListMultimap</A>&lt;K,V&gt;</DL>
    105 </PRE>
    106 
    107 <P>
    108 An immutable <A HREF="../../../../com/google/common/collect/ListMultimap.html" title="interface in com.google.common.collect"><CODE>ListMultimap</CODE></A> with reliable user-specified key and value
    109  iteration order. Does not permit null keys or values.
    110 
    111  <p>Unlike <A HREF="../../../../com/google/common/collect/Multimaps.html#unmodifiableListMultimap(com.google.common.collect.ListMultimap)"><CODE>Multimaps.unmodifiableListMultimap(ListMultimap)</CODE></A>, which is
    112  a <i>view</i> of a separate multimap which can still change, an instance of
    113  <code>ImmutableListMultimap</code> contains its own data and will <i>never</i>
    114  change. <code>ImmutableListMultimap</code> is convenient for
    115  <code>public static final</code> multimaps ("constant multimaps") and also lets
    116  you easily make a "defensive copy" of a multimap provided to your class by
    117  a caller.
    118 
    119  <p><b>Note</b>: Although this class is not final, it cannot be subclassed as
    120  it has no public or protected constructors. Thus, instances of this class
    121  are guaranteed to be immutable.
    122 <P>
    123 
    124 <P>
    125 <DL>
    126 <DT><B>Since:</B></DT>
    127   <DD>2010.01.04 <b>stable</b> (imported from Google Collections Library)</DD>
    128 <DT><B>Author:</B></DT>
    129   <DD>Jared Levy</DD>
    130 <DT><B>See Also:</B><DD><A HREF="../../../../serialized-form.html#com.google.common.collect.ImmutableListMultimap">Serialized Form</A></DL>
    131 <HR>
    132 
    133 <P>
    134 <!-- ======== NESTED CLASS SUMMARY ======== -->
    135 
    136 <A NAME="nested_class_summary"><!-- --></A>
    137 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    138 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
    139 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
    140 <B>Nested Class Summary</B></FONT></TH>
    141 </TR>
    142 <TR BGCOLOR="white" CLASS="TableRowColor">
    143 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    144 <CODE>static&nbsp;class</CODE></FONT></TD>
    145 <TD><CODE><B><A HREF="../../../../com/google/common/collect/ImmutableListMultimap.Builder.html" title="class in com.google.common.collect">ImmutableListMultimap.Builder</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.Builder.html" title="type parameter in ImmutableListMultimap.Builder">K</A>,<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.Builder.html" title="type parameter in ImmutableListMultimap.Builder">V</A>&gt;</B></CODE>
    146 
    147 <BR>
    148 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;A builder for creating immutable <code>ListMultimap</code> instances, especially
    149  <code>public static final</code> multimaps ("constant multimaps").</TD>
    150 </TR>
    151 </TABLE>
    152 &nbsp;
    153 <!-- ========== METHOD SUMMARY =========== -->
    154 
    155 <A NAME="method_summary"><!-- --></A>
    156 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    157 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
    158 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
    159 <B>Method Summary</B></FONT></TH>
    160 </TR>
    161 <TR BGCOLOR="white" CLASS="TableRowColor">
    162 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    163 <CODE>static
    164 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
    165 <TR ALIGN="right" VALIGN="">
    166 <TD NOWRAP><FONT SIZE="-1">
    167 <CODE>&lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.Builder.html" title="class in com.google.common.collect">ImmutableListMultimap.Builder</A>&lt;K,V&gt;</CODE></FONT></TD>
    168 </TR>
    169 </TABLE>
    170 </CODE></FONT></TD>
    171 <TD><CODE><B><A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html#builder()">builder</A></B>()</CODE>
    172 
    173 <BR>
    174 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a new builder.</TD>
    175 </TR>
    176 <TR BGCOLOR="white" CLASS="TableRowColor">
    177 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    178 <CODE>static
    179 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
    180 <TR ALIGN="right" VALIGN="">
    181 <TD NOWRAP><FONT SIZE="-1">
    182 <CODE>&lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt;</CODE></FONT></TD>
    183 </TR>
    184 </TABLE>
    185 </CODE></FONT></TD>
    186 <TD><CODE><B><A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html#copyOf(com.google.common.collect.Multimap)">copyOf</A></B>(<A HREF="../../../../com/google/common/collect/Multimap.html" title="interface in com.google.common.collect">Multimap</A>&lt;? extends K,? extends V&gt;&nbsp;multimap)</CODE>
    187 
    188 <BR>
    189 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an immutable multimap containing the same mappings as
    190  <code>multimap</code>.</TD>
    191 </TR>
    192 <TR BGCOLOR="white" CLASS="TableRowColor">
    193 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    194 <CODE>&nbsp;<A HREF="../../../../com/google/common/collect/ImmutableList.html" title="class in com.google.common.collect">ImmutableList</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;</CODE></FONT></TD>
    195 <TD><CODE><B><A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html#get(K)">get</A></B>(<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>&nbsp;key)</CODE>
    196 
    197 <BR>
    198 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an immutable list of the values for the given key.</TD>
    199 </TR>
    200 <TR BGCOLOR="white" CLASS="TableRowColor">
    201 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    202 <CODE>static
    203 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
    204 <TR ALIGN="right" VALIGN="">
    205 <TD NOWRAP><FONT SIZE="-1">
    206 <CODE>&lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt;</CODE></FONT></TD>
    207 </TR>
    208 </TABLE>
    209 </CODE></FONT></TD>
    210 <TD><CODE><B><A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html#of()">of</A></B>()</CODE>
    211 
    212 <BR>
    213 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the empty multimap.</TD>
    214 </TR>
    215 <TR BGCOLOR="white" CLASS="TableRowColor">
    216 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    217 <CODE>static
    218 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
    219 <TR ALIGN="right" VALIGN="">
    220 <TD NOWRAP><FONT SIZE="-1">
    221 <CODE>&lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt;</CODE></FONT></TD>
    222 </TR>
    223 </TABLE>
    224 </CODE></FONT></TD>
    225 <TD><CODE><B><A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html#of(K, V)">of</A></B>(K&nbsp;k1,
    226    V&nbsp;v1)</CODE>
    227 
    228 <BR>
    229 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an immutable multimap containing a single entry.</TD>
    230 </TR>
    231 <TR BGCOLOR="white" CLASS="TableRowColor">
    232 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    233 <CODE>static
    234 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
    235 <TR ALIGN="right" VALIGN="">
    236 <TD NOWRAP><FONT SIZE="-1">
    237 <CODE>&lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt;</CODE></FONT></TD>
    238 </TR>
    239 </TABLE>
    240 </CODE></FONT></TD>
    241 <TD><CODE><B><A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html#of(K, V, K, V)">of</A></B>(K&nbsp;k1,
    242    V&nbsp;v1,
    243    K&nbsp;k2,
    244    V&nbsp;v2)</CODE>
    245 
    246 <BR>
    247 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an immutable multimap containing the given entries, in order.</TD>
    248 </TR>
    249 <TR BGCOLOR="white" CLASS="TableRowColor">
    250 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    251 <CODE>static
    252 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
    253 <TR ALIGN="right" VALIGN="">
    254 <TD NOWRAP><FONT SIZE="-1">
    255 <CODE>&lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt;</CODE></FONT></TD>
    256 </TR>
    257 </TABLE>
    258 </CODE></FONT></TD>
    259 <TD><CODE><B><A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html#of(K, V, K, V, K, V)">of</A></B>(K&nbsp;k1,
    260    V&nbsp;v1,
    261    K&nbsp;k2,
    262    V&nbsp;v2,
    263    K&nbsp;k3,
    264    V&nbsp;v3)</CODE>
    265 
    266 <BR>
    267 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an immutable multimap containing the given entries, in order.</TD>
    268 </TR>
    269 <TR BGCOLOR="white" CLASS="TableRowColor">
    270 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    271 <CODE>static
    272 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
    273 <TR ALIGN="right" VALIGN="">
    274 <TD NOWRAP><FONT SIZE="-1">
    275 <CODE>&lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt;</CODE></FONT></TD>
    276 </TR>
    277 </TABLE>
    278 </CODE></FONT></TD>
    279 <TD><CODE><B><A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html#of(K, V, K, V, K, V, K, V)">of</A></B>(K&nbsp;k1,
    280    V&nbsp;v1,
    281    K&nbsp;k2,
    282    V&nbsp;v2,
    283    K&nbsp;k3,
    284    V&nbsp;v3,
    285    K&nbsp;k4,
    286    V&nbsp;v4)</CODE>
    287 
    288 <BR>
    289 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an immutable multimap containing the given entries, in order.</TD>
    290 </TR>
    291 <TR BGCOLOR="white" CLASS="TableRowColor">
    292 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    293 <CODE>static
    294 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" SUMMARY="">
    295 <TR ALIGN="right" VALIGN="">
    296 <TD NOWRAP><FONT SIZE="-1">
    297 <CODE>&lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt;</CODE></FONT></TD>
    298 </TR>
    299 </TABLE>
    300 </CODE></FONT></TD>
    301 <TD><CODE><B><A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html#of(K, V, K, V, K, V, K, V, K, V)">of</A></B>(K&nbsp;k1,
    302    V&nbsp;v1,
    303    K&nbsp;k2,
    304    V&nbsp;v2,
    305    K&nbsp;k3,
    306    V&nbsp;v3,
    307    K&nbsp;k4,
    308    V&nbsp;v4,
    309    K&nbsp;k5,
    310    V&nbsp;v5)</CODE>
    311 
    312 <BR>
    313 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an immutable multimap containing the given entries, in order.</TD>
    314 </TR>
    315 <TR BGCOLOR="white" CLASS="TableRowColor">
    316 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    317 <CODE>&nbsp;<A HREF="../../../../com/google/common/collect/ImmutableList.html" title="class in com.google.common.collect">ImmutableList</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;</CODE></FONT></TD>
    318 <TD><CODE><B><A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html#removeAll(java.lang.Object)">removeAll</A></B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;key)</CODE>
    319 
    320 <BR>
    321 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Guaranteed to throw an exception and leave the multimap unmodified.</TD>
    322 </TR>
    323 <TR BGCOLOR="white" CLASS="TableRowColor">
    324 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
    325 <CODE>&nbsp;<A HREF="../../../../com/google/common/collect/ImmutableList.html" title="class in com.google.common.collect">ImmutableList</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;</CODE></FONT></TD>
    326 <TD><CODE><B><A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html#replaceValues(K, java.lang.Iterable)">replaceValues</A></B>(<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>&nbsp;key,
    327               <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</A>&lt;? extends <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;&nbsp;values)</CODE>
    328 
    329 <BR>
    330 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Guaranteed to throw an exception and leave the multimap unmodified.</TD>
    331 </TR>
    332 </TABLE>
    333 &nbsp;<A NAME="methods_inherited_from_class_com.google.common.collect.ImmutableMultimap"><!-- --></A>
    334 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    335 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
    336 <TH ALIGN="left"><B>Methods inherited from class com.google.common.collect.<A HREF="../../../../com/google/common/collect/ImmutableMultimap.html" title="class in com.google.common.collect">ImmutableMultimap</A></B></TH>
    337 </TR>
    338 <TR BGCOLOR="white" CLASS="TableRowColor">
    339 <TD><CODE><A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#asMap()">asMap</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#clear()">clear</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#containsEntry(java.lang.Object, java.lang.Object)">containsEntry</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#containsKey(java.lang.Object)">containsKey</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#containsValue(java.lang.Object)">containsValue</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#entries()">entries</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#equals(java.lang.Object)">equals</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#hashCode()">hashCode</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#isEmpty()">isEmpty</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#keys()">keys</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#keySet()">keySet</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#put(K, V)">put</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#putAll(K, java.lang.Iterable)">putAll</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#putAll(com.google.common.collect.Multimap)">putAll</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#remove(java.lang.Object, java.lang.Object)">remove</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#size()">size</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#toString()">toString</A>, <A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#values()">values</A></CODE></TD>
    340 </TR>
    341 </TABLE>
    342 &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
    343 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    344 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
    345 <TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></B></TH>
    346 </TR>
    347 <TR BGCOLOR="white" CLASS="TableRowColor">
    348 <TD><CODE><A HREF="http://java.sun.com/javase/6/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/javase/6/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/javase/6/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/javase/6/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/javase/6/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/javase/6/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/javase/6/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/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
    349 </TR>
    350 </TABLE>
    351 &nbsp;<A NAME="methods_inherited_from_class_com.google.common.collect.ListMultimap"><!-- --></A>
    352 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    353 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
    354 <TH ALIGN="left"><B>Methods inherited from interface com.google.common.collect.<A HREF="../../../../com/google/common/collect/ListMultimap.html" title="interface in com.google.common.collect">ListMultimap</A></B></TH>
    355 </TR>
    356 <TR BGCOLOR="white" CLASS="TableRowColor">
    357 <TD><CODE><A HREF="../../../../com/google/common/collect/ListMultimap.html#asMap()">asMap</A>, <A HREF="../../../../com/google/common/collect/ListMultimap.html#equals(java.lang.Object)">equals</A></CODE></TD>
    358 </TR>
    359 </TABLE>
    360 &nbsp;<A NAME="methods_inherited_from_class_com.google.common.collect.Multimap"><!-- --></A>
    361 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    362 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
    363 <TH ALIGN="left"><B>Methods inherited from interface com.google.common.collect.<A HREF="../../../../com/google/common/collect/Multimap.html" title="interface in com.google.common.collect">Multimap</A></B></TH>
    364 </TR>
    365 <TR BGCOLOR="white" CLASS="TableRowColor">
    366 <TD><CODE><A HREF="../../../../com/google/common/collect/Multimap.html#clear()">clear</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#containsEntry(java.lang.Object, java.lang.Object)">containsEntry</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#containsKey(java.lang.Object)">containsKey</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#containsValue(java.lang.Object)">containsValue</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#entries()">entries</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#hashCode()">hashCode</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#isEmpty()">isEmpty</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#keys()">keys</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#keySet()">keySet</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#put(K, V)">put</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#putAll(K, java.lang.Iterable)">putAll</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#putAll(com.google.common.collect.Multimap)">putAll</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#remove(java.lang.Object, java.lang.Object)">remove</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#size()">size</A>, <A HREF="../../../../com/google/common/collect/Multimap.html#values()">values</A></CODE></TD>
    367 </TR>
    368 </TABLE>
    369 &nbsp;
    370 <P>
    371 
    372 <!-- ============ METHOD DETAIL ========== -->
    373 
    374 <A NAME="method_detail"><!-- --></A>
    375 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
    376 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
    377 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
    378 <B>Method Detail</B></FONT></TH>
    379 </TR>
    380 </TABLE>
    381 
    382 <A NAME="of()"><!-- --></A><H3>
    383 of</H3>
    384 <PRE>
    385 public static &lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt; <B>of</B>()</PRE>
    386 <DL>
    387 <DD>Returns the empty multimap.
    388 <P>
    389 <DD><DL>
    390 </DL>
    391 </DD>
    392 <DD><DL>
    393 </DL>
    394 </DD>
    395 </DL>
    396 <HR>
    397 
    398 <A NAME="of(java.lang.Object,java.lang.Object)"><!-- --></A><A NAME="of(K, V)"><!-- --></A><H3>
    399 of</H3>
    400 <PRE>
    401 public static &lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt; <B>of</B>(K&nbsp;k1,
    402                                                   V&nbsp;v1)</PRE>
    403 <DL>
    404 <DD>Returns an immutable multimap containing a single entry.
    405 <P>
    406 <DD><DL>
    407 </DL>
    408 </DD>
    409 <DD><DL>
    410 </DL>
    411 </DD>
    412 </DL>
    413 <HR>
    414 
    415 <A NAME="of(java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object)"><!-- --></A><A NAME="of(K, V, K, V)"><!-- --></A><H3>
    416 of</H3>
    417 <PRE>
    418 public static &lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt; <B>of</B>(K&nbsp;k1,
    419                                                   V&nbsp;v1,
    420                                                   K&nbsp;k2,
    421                                                   V&nbsp;v2)</PRE>
    422 <DL>
    423 <DD>Returns an immutable multimap containing the given entries, in order.
    424 <P>
    425 <DD><DL>
    426 </DL>
    427 </DD>
    428 <DD><DL>
    429 </DL>
    430 </DD>
    431 </DL>
    432 <HR>
    433 
    434 <A NAME="of(java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object)"><!-- --></A><A NAME="of(K, V, K, V, K, V)"><!-- --></A><H3>
    435 of</H3>
    436 <PRE>
    437 public static &lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt; <B>of</B>(K&nbsp;k1,
    438                                                   V&nbsp;v1,
    439                                                   K&nbsp;k2,
    440                                                   V&nbsp;v2,
    441                                                   K&nbsp;k3,
    442                                                   V&nbsp;v3)</PRE>
    443 <DL>
    444 <DD>Returns an immutable multimap containing the given entries, in order.
    445 <P>
    446 <DD><DL>
    447 </DL>
    448 </DD>
    449 <DD><DL>
    450 </DL>
    451 </DD>
    452 </DL>
    453 <HR>
    454 
    455 <A NAME="of(java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object)"><!-- --></A><A NAME="of(K, V, K, V, K, V, K, V)"><!-- --></A><H3>
    456 of</H3>
    457 <PRE>
    458 public static &lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt; <B>of</B>(K&nbsp;k1,
    459                                                   V&nbsp;v1,
    460                                                   K&nbsp;k2,
    461                                                   V&nbsp;v2,
    462                                                   K&nbsp;k3,
    463                                                   V&nbsp;v3,
    464                                                   K&nbsp;k4,
    465                                                   V&nbsp;v4)</PRE>
    466 <DL>
    467 <DD>Returns an immutable multimap containing the given entries, in order.
    468 <P>
    469 <DD><DL>
    470 </DL>
    471 </DD>
    472 <DD><DL>
    473 </DL>
    474 </DD>
    475 </DL>
    476 <HR>
    477 
    478 <A NAME="of(java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object,java.lang.Object)"><!-- --></A><A NAME="of(K, V, K, V, K, V, K, V, K, V)"><!-- --></A><H3>
    479 of</H3>
    480 <PRE>
    481 public static &lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt; <B>of</B>(K&nbsp;k1,
    482                                                   V&nbsp;v1,
    483                                                   K&nbsp;k2,
    484                                                   V&nbsp;v2,
    485                                                   K&nbsp;k3,
    486                                                   V&nbsp;v3,
    487                                                   K&nbsp;k4,
    488                                                   V&nbsp;v4,
    489                                                   K&nbsp;k5,
    490                                                   V&nbsp;v5)</PRE>
    491 <DL>
    492 <DD>Returns an immutable multimap containing the given entries, in order.
    493 <P>
    494 <DD><DL>
    495 </DL>
    496 </DD>
    497 <DD><DL>
    498 </DL>
    499 </DD>
    500 </DL>
    501 <HR>
    502 
    503 <A NAME="builder()"><!-- --></A><H3>
    504 builder</H3>
    505 <PRE>
    506 public static &lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.Builder.html" title="class in com.google.common.collect">ImmutableListMultimap.Builder</A>&lt;K,V&gt; <B>builder</B>()</PRE>
    507 <DL>
    508 <DD>Returns a new builder. The generated builder is equivalent to the builder
    509  created by the <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.Builder.html" title="class in com.google.common.collect"><CODE>ImmutableListMultimap.Builder</CODE></A> constructor.
    510 <P>
    511 <DD><DL>
    512 </DL>
    513 </DD>
    514 <DD><DL>
    515 </DL>
    516 </DD>
    517 </DL>
    518 <HR>
    519 
    520 <A NAME="copyOf(com.google.common.collect.Multimap)"><!-- --></A><H3>
    521 copyOf</H3>
    522 <PRE>
    523 public static &lt;K,V&gt; <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="class in com.google.common.collect">ImmutableListMultimap</A>&lt;K,V&gt; <B>copyOf</B>(<A HREF="../../../../com/google/common/collect/Multimap.html" title="interface in com.google.common.collect">Multimap</A>&lt;? extends K,? extends V&gt;&nbsp;multimap)</PRE>
    524 <DL>
    525 <DD>Returns an immutable multimap containing the same mappings as
    526  <code>multimap</code>. The generated multimap's key and value orderings
    527  correspond to the iteration ordering of the <code>multimap.asMap()</code> view.
    528 
    529  <p><b>Note:</b> Despite what the method name suggests, if
    530  <code>multimap</code> is an <code>ImmutableListMultimap</code>, no copy will actually
    531  be performed, and the given multimap itself will be returned.
    532 <P>
    533 <DD><DL>
    534 </DL>
    535 </DD>
    536 <DD><DL>
    537 
    538 <DT><B>Throws:</B>
    539 <DD><CODE><A HREF="http://java.sun.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</A></CODE> - if any key or value in <code>multimap</code> is
    540      null</DL>
    541 </DD>
    542 </DL>
    543 <HR>
    544 
    545 <A NAME="get(java.lang.Object)"><!-- --></A><A NAME="get(K)"><!-- --></A><H3>
    546 get</H3>
    547 <PRE>
    548 public <A HREF="../../../../com/google/common/collect/ImmutableList.html" title="class in com.google.common.collect">ImmutableList</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt; <B>get</B>(<FONT SIZE="-1"><A HREF="http://jsr-305.googlecode.com/svn/trunk/javadoc/javax/annotation/Nullable.html?is-external=true" title="class or interface in javax.annotation">@Nullable</A></FONT>
    549                             <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>&nbsp;key)</PRE>
    550 <DL>
    551 <DD>Returns an immutable list of the values for the given key.  If no mappings
    552  in the multimap have the provided key, an empty immutable list is
    553  returned. The values are in the same order as the parameters used to build
    554  this multimap.
    555 <P>
    556 <DD><DL>
    557 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../com/google/common/collect/ListMultimap.html#get(K)">get</A></CODE> in interface <CODE><A HREF="../../../../com/google/common/collect/ListMultimap.html" title="interface in com.google.common.collect">ListMultimap</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>,<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;</CODE><DT><B>Specified by:</B><DD><CODE><A HREF="../../../../com/google/common/collect/Multimap.html#get(K)">get</A></CODE> in interface <CODE><A HREF="../../../../com/google/common/collect/Multimap.html" title="interface in com.google.common.collect">Multimap</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>,<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;</CODE><DT><B>Specified by:</B><DD><CODE><A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#get(K)">get</A></CODE> in class <CODE><A HREF="../../../../com/google/common/collect/ImmutableMultimap.html" title="class in com.google.common.collect">ImmutableMultimap</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>,<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;</CODE></DL>
    558 </DD>
    559 <DD><DL>
    560 <DT><B>Parameters:</B><DD><CODE>key</CODE> - key to search for in multimap
    561 <DT><B>Returns:</B><DD>the collection of values that the key maps to</DL>
    562 </DD>
    563 </DL>
    564 <HR>
    565 
    566 <A NAME="removeAll(java.lang.Object)"><!-- --></A><H3>
    567 removeAll</H3>
    568 <PRE>
    569 public <A HREF="../../../../com/google/common/collect/ImmutableList.html" title="class in com.google.common.collect">ImmutableList</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt; <B>removeAll</B>(<A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;key)</PRE>
    570 <DL>
    571 <DD>Guaranteed to throw an exception and leave the multimap unmodified.
    572 <P>
    573 <DD><DL>
    574 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../com/google/common/collect/ListMultimap.html#removeAll(java.lang.Object)">removeAll</A></CODE> in interface <CODE><A HREF="../../../../com/google/common/collect/ListMultimap.html" title="interface in com.google.common.collect">ListMultimap</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>,<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;</CODE><DT><B>Specified by:</B><DD><CODE><A HREF="../../../../com/google/common/collect/Multimap.html#removeAll(java.lang.Object)">removeAll</A></CODE> in interface <CODE><A HREF="../../../../com/google/common/collect/Multimap.html" title="interface in com.google.common.collect">Multimap</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>,<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;</CODE><DT><B>Overrides:</B><DD><CODE><A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#removeAll(java.lang.Object)">removeAll</A></CODE> in class <CODE><A HREF="../../../../com/google/common/collect/ImmutableMultimap.html" title="class in com.google.common.collect">ImmutableMultimap</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>,<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;</CODE></DL>
    575 </DD>
    576 <DD><DL>
    577 <DT><B>Parameters:</B><DD><CODE>key</CODE> - key of entries to remove from the multimap
    578 <DT><B>Returns:</B><DD>the collection of removed values, or an empty collection if no
    579      values were associated with the provided key. The collection
    580      <i>may</i> be modifiable, but updating it will have no effect on the
    581      multimap.
    582 <DT><B>Throws:</B>
    583 <DD><CODE><A HREF="http://java.sun.com/javase/6/docs/api/java/lang/UnsupportedOperationException.html?is-external=true" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - always</DL>
    584 </DD>
    585 </DL>
    586 <HR>
    587 
    588 <A NAME="replaceValues(java.lang.Object,java.lang.Iterable)"><!-- --></A><A NAME="replaceValues(K, java.lang.Iterable)"><!-- --></A><H3>
    589 replaceValues</H3>
    590 <PRE>
    591 public <A HREF="../../../../com/google/common/collect/ImmutableList.html" title="class in com.google.common.collect">ImmutableList</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt; <B>replaceValues</B>(<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>&nbsp;key,
    592                                       <A HREF="http://java.sun.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</A>&lt;? extends <A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;&nbsp;values)</PRE>
    593 <DL>
    594 <DD>Guaranteed to throw an exception and leave the multimap unmodified.
    595 <P>
    596 <DD><DL>
    597 <DT><B>Specified by:</B><DD><CODE><A HREF="../../../../com/google/common/collect/ListMultimap.html#replaceValues(K, java.lang.Iterable)">replaceValues</A></CODE> in interface <CODE><A HREF="../../../../com/google/common/collect/ListMultimap.html" title="interface in com.google.common.collect">ListMultimap</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>,<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;</CODE><DT><B>Specified by:</B><DD><CODE><A HREF="../../../../com/google/common/collect/Multimap.html#replaceValues(K, java.lang.Iterable)">replaceValues</A></CODE> in interface <CODE><A HREF="../../../../com/google/common/collect/Multimap.html" title="interface in com.google.common.collect">Multimap</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>,<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;</CODE><DT><B>Overrides:</B><DD><CODE><A HREF="../../../../com/google/common/collect/ImmutableMultimap.html#replaceValues(K, java.lang.Iterable)">replaceValues</A></CODE> in class <CODE><A HREF="../../../../com/google/common/collect/ImmutableMultimap.html" title="class in com.google.common.collect">ImmutableMultimap</A>&lt;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">K</A>,<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.html" title="type parameter in ImmutableListMultimap">V</A>&gt;</CODE></DL>
    598 </DD>
    599 <DD><DL>
    600 <DT><B>Parameters:</B><DD><CODE>key</CODE> - key to store in the multimap<DD><CODE>values</CODE> - values to store in the multimap
    601 <DT><B>Returns:</B><DD>the collection of replaced values, or an empty collection if no
    602      values were previously associated with the key. The collection
    603      <i>may</i> be modifiable, but updating it will have no effect on the
    604      multimap.
    605 <DT><B>Throws:</B>
    606 <DD><CODE><A HREF="http://java.sun.com/javase/6/docs/api/java/lang/UnsupportedOperationException.html?is-external=true" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - always</DL>
    607 </DD>
    608 </DL>
    609 <!-- ========= END OF CLASS DATA ========= -->
    610 <HR>
    611 
    612 
    613 <!-- ======= START OF BOTTOM NAVBAR ====== -->
    614 <A NAME="navbar_bottom"><!-- --></A>
    615 <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
    616 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
    617 <TR>
    618 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
    619 <A NAME="navbar_bottom_firstrow"><!-- --></A>
    620 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
    621   <TR ALIGN="center" VALIGN="top">
    622   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
    623   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
    624   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
    625   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/ImmutableListMultimap.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
    626   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
    627   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
    628   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
    629   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
    630   </TR>
    631 </TABLE>
    632 </TD>
    633 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
    634 </EM>
    635 </TD>
    636 </TR>
    637 
    638 <TR>
    639 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    640 &nbsp;<A HREF="../../../../com/google/common/collect/ImmutableList.Builder.html" title="class in com.google.common.collect"><B>PREV CLASS</B></A>&nbsp;
    641 &nbsp;<A HREF="../../../../com/google/common/collect/ImmutableListMultimap.Builder.html" title="class in com.google.common.collect"><B>NEXT CLASS</B></A></FONT></TD>
    642 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
    643   <A HREF="../../../../index.html?com/google/common/collect/ImmutableListMultimap.html" target="_top"><B>FRAMES</B></A>  &nbsp;
    644 &nbsp;<A HREF="ImmutableListMultimap.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
    645 &nbsp;<SCRIPT type="text/javascript">
    646   <!--
    647   if(window==top) {
    648     document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
    649   }
    650   //-->
    651 </SCRIPT>
    652 <NOSCRIPT>
    653   <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
    654 </NOSCRIPT>
    655 
    656 
    657 </FONT></TD>
    658 </TR>
    659 <TR>
    660 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    661   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>
    662 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
    663 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
    664 </TR>
    665 </TABLE>
    666 <A NAME="skip-navbar_bottom"></A>
    667 <!-- ======== END OF BOTTOM NAVBAR ======= -->
    668 
    669 <HR>
    670 
    671 </BODY>
    672 </HTML>
    673