MutableMultimap (Eclipse Collections

All Superinterfaces:

Multimap<K,V>

All Known Subinterfaces:

MutableBagIterableMultimap<K,V>, MutableBagMultimap<K,V>, MutableListMultimap<K,V>, MutableSetIterableMultimap<K,V>, MutableSetMultimap<K,V>, MutableSortedBagMultimap<K,V>, MutableSortedSetMultimap<K,V>

All Known Implementing Classes:

AbstractMutableBagMultimap, AbstractMutableListMultimap, AbstractMutableMultimap, AbstractMutableSetMultimap, AbstractSynchronizedPutMultimap, FastListMultimap, HashBagMultimap, HashBagMultimapWithHashingStrategy, MultiReaderFastListMultimap, MultiReaderHashBagMultimap, MultiReaderUnifiedSetMultimap, SynchronizedPutFastListMultimap, SynchronizedPutHashBagMultimap, SynchronizedPutTreeSortedSetMultimap, SynchronizedPutUnifiedSetMultimap, TreeBagMultimap, TreeBagMultimap, TreeBagMultimap, TreeSortedSetMultimap, UnifiedSetMultimap, UnifiedSetWithHashingStrategyMultimap
```
public interface MutableMultimap<K,V>
extends Multimap<K,V>
```
Since:

1.0

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`boolean`	`add(Pair<K,V> keyValuePair)` Modification operation similar to put, however, takes the key-value pair as the input.
`void`	`clear()`
`<K2,V2> MutableMultimap<K2,V2>`	`collectKeysValues(Function2<? super K,? super V,Pair<K2,V2>> function)` Returns a new multimap with the results of applying the specified function on each key and value of the source multimap.
`<V2> MutableMultimap<K,V2>`	`collectValues(Function<? super V,? extends V2> function)` Returns a new multimap with the results of applying the specified function on each value of the source multimap.
`MutableMultimap<V,K>`	`flip()` Given a Multimap from Domain -> Range return a multimap from Range -> Domain.
`MutableCollection<V>`	`get(K key)` Returns a view of all values associated with the given key.
`MutableMultimap<K,V>`	`newEmpty()` Creates a new instance of the same implementation type, using the default capacity and growth parameters.
`boolean`	`put(K key, V value)`
`boolean`	`putAll(K key, Iterable<? extends V> values)`
`<KK extends K,VV extends V> boolean`	`putAll(Multimap<KK,VV> multimap)`
`boolean`	`putAllPairs(Pair<K,V>... pairs)`
`MutableMultimap<K,V>`	`rejectKeysMultiValues(Predicate2<? super K,? super Iterable<V>> predicate)` Returns all elements of the source multimap that don't satisfy the predicate.
`MutableMultimap<K,V>`	`rejectKeysValues(Predicate2<? super K,? super V> predicate)` Returns all elements of the source multimap that don't satisfy the predicate.
`boolean`	`remove(Object key, Object value)`
`RichIterable<V>`	`removeAll(Object key)`
`RichIterable<V>`	`replaceValues(K key, Iterable<? extends V> values)`
`MutableMultimap<K,V>`	`selectKeysMultiValues(Predicate2<? super K,? super Iterable<V>> predicate)` Returns all elements of the source multimap that satisfies the predicate.
`MutableMultimap<K,V>`	`selectKeysValues(Predicate2<? super K,? super V> predicate)` Returns all elements of the source multimap that satisfies the predicate.

Methods inherited from interface org.eclipse.collections.api.multimap.Multimap
collectKeysValues, collectValues, containsKey, containsKeyAndValue, containsValue, equals, forEachKey, forEachKeyMultiValues, forEachKeyValue, forEachValue, hashCode, isEmpty, keyBag, keyMultiValuePairsView, keysView, keyValuePairsView, multiValuesView, notEmpty, rejectKeysMultiValues, rejectKeysValues, selectKeysMultiValues, selectKeysValues, size, sizeDistinct, toImmutable, toMap, toMap, toMutable, valuesView

- Method Detail
  - newEmpty
```
MutableMultimap<K,V> newEmpty()
```
    Description copied from interface: Multimap
    
    Creates a new instance of the same implementation type, using the default capacity and growth parameters.
    
    Specified by:
    
    newEmpty in interface Multimap<K,V>
  - get
```
MutableCollection<V> get(K key)
```
    Description copied from interface: Multimap
    
    Returns a view of all values associated with the given key.
    If the given key does not exist, an empty RichIterable is returned.
    
    Specified by:
    
    get in interface Multimap<K,V>
    
    Parameters:
    
    key - the key to search for
  - put
```
boolean put(K key,
            V value)
```
  - add
```
boolean add(Pair<K,V> keyValuePair)
```
    Modification operation similar to put, however, takes the key-value pair as the input.
    
    Parameters:
    
    keyValuePair - key value pair to add in the multimap
    
    Since:
    
    6.0
    
    See Also:
    
    put(Object, Object)
  - remove
```
boolean remove(Object key,
               Object value)
```
  - putAllPairs
```
boolean putAllPairs(Pair<K,V>... pairs)
```
  - putAll
```
boolean putAll(K key,
               Iterable<? extends V> values)
```
  - putAll
```
<KK extends K,VV extends V> boolean putAll(Multimap<KK,VV> multimap)
```
  - replaceValues
```
RichIterable<V> replaceValues(K key,
                              Iterable<? extends V> values)
```
  - removeAll
```
RichIterable<V> removeAll(Object key)
```
  - clear
```
void clear()
```
  - flip
```
MutableMultimap<V,K> flip()
```
    Description copied from interface: Multimap
    
    Given a Multimap from Domain -> Range return a multimap from Range -> Domain.
    
    Specified by:
    
    flip in interface Multimap<K,V>
  - selectKeysValues
```
MutableMultimap<K,V> selectKeysValues(Predicate2<? super K,? super V> predicate)
```
    Description copied from interface: Multimap
    Returns all elements of the source multimap that satisfies the predicate. This method is also commonly called filter.
```
e.g.
 return multimap.selectKeysValues(new Predicate2<Integer, Person>()
 {
     public boolean accept(Integer age, Person person)
     {
         return (age >= 18)
                  && (person.getAddress().getCity().equals("Metuchen"));
     }
 });
 
```
    Specified by:
    
    selectKeysValues in interface Multimap<K,V>
    
    Parameters:
    
    predicate - a Predicate2 to use as the select criteria
    
    Returns:
    
    Multimap, which contains elements as a result of the select criteria
  - rejectKeysValues
```
MutableMultimap<K,V> rejectKeysValues(Predicate2<? super K,? super V> predicate)
```
    Description copied from interface: Multimap
    Returns all elements of the source multimap that don't satisfy the predicate.
```
e.g.
 return multimap.rejectKeysValues(new Predicate2<Integer, Person>()
 {
     public boolean accept(Integer age, Person person)
     {
         return (age >= 18)
                  && (person.getAddress().getCity().equals("Metuchen"));
     }
 });
 
```
    Specified by:
    
    rejectKeysValues in interface Multimap<K,V>
    
    Parameters:
    
    predicate - a Predicate2 to use as the reject criteria
    
    Returns:
    
    Multimap, which contains elements that don't satisfy the predicate
  - selectKeysMultiValues
```
MutableMultimap<K,V> selectKeysMultiValues(Predicate2<? super K,? super Iterable<V>> predicate)
```
    Description copied from interface: Multimap
    Returns all elements of the source multimap that satisfies the predicate. This method is also commonly called filter.
```
e.g.
 return multimap.selectKeysMultiValues(new Predicate2<Integer, Iterable<Person>>()
 {
     public boolean accept(Integer age, Iterable<Person> values)
     {
         return (age >= 18)
                  && ((RichIterable<Person>)values.size() >= 2);
     }
 });
 
```
    Specified by:
    
    selectKeysMultiValues in interface Multimap<K,V>
    
    Parameters:
    
    predicate - a Predicate2 to use as the select criteria
    
    Returns:
    
    Multimap, which contains elements as a result of the select criteria
  - rejectKeysMultiValues
```
MutableMultimap<K,V> rejectKeysMultiValues(Predicate2<? super K,? super Iterable<V>> predicate)
```
    Description copied from interface: Multimap
    Returns all elements of the source multimap that don't satisfy the predicate.
```
e.g.
 return multimap.rejectKeysMultiValues(new Predicate2<Integer, Iterable<Person>>()
 {
     public boolean accept(Integer age, Iterable<Person> values)
     {
         return (age >= 18)
                  && ((RichIterable<Person>)values.size() >= 2);
     }
 });
 
```
    Specified by:
    
    rejectKeysMultiValues in interface Multimap<K,V>
    
    Parameters:
    
    predicate - a Predicate2 to use as the reject criteria
    
    Returns:
    
    Multimap, which contains elements that don't satisfy the predicate
  - collectKeysValues
```
<K2,V2> MutableMultimap<K2,V2> collectKeysValues(Function2<? super K,? super V,Pair<K2,V2>> function)
```
    Description copied from interface: Multimap
    Returns a new multimap with the results of applying the specified function on each key and value of the source multimap. This method is also commonly called transform or map.
```
e.g.
 return multimap.collectKeysValues(new Function2<Integer, Person, Pair<String, String>>()
 {
     public Pair<String, String> valueOf(Integer age, Person person)
     {
         return Tuples.pair(age.toString(), person.getLastName());
     }
 });
 
```
    Specified by:
    
    collectKeysValues in interface Multimap<K,V>
    
    Parameters:
    
    function - a Function2 to use for transformation
    
    Returns:
    
    Multimap, which contains elements as a result of the transformation
  - collectValues
```
<V2> MutableMultimap<K,V2> collectValues(Function<? super V,? extends V2> function)
```
    Description copied from interface: Multimap
    Returns a new multimap with the results of applying the specified function on each value of the source multimap. This method is also commonly called transform or map.
```
e.g.
 return multimap.collectValues(new Function<Person, String>()
 {
     public String valueOf(Person person)
     {
         return person.getLastName();
     }
 });
 
```
    Specified by:
    
    collectValues in interface Multimap<K,V>
    
    Parameters:
    
    function - a Function to use for transformation
    
    Returns:
    
    Multimap, which contains elements as a result of the transformation

Interface MutableMultimap<K,V>

Method Summary

Methods inherited from interface org.eclipse.collections.api.multimap.Multimap

Method Detail

newEmpty

get

put

add

remove

putAllPairs

putAll

putAll

replaceValues

removeAll

clear

flip

selectKeysValues

rejectKeysValues

selectKeysMultiValues

rejectKeysMultiValues

collectKeysValues

collectValues