@GwtCompatible public interface SetMultimap<K,V> extends Multimap<K,V>
Multimapthat cannot hold duplicate key-value pairs. Adding a key-value pair that's already in the multimap has no effect. See the
Multimapdocumentation for information common to all multimaps.
replaceValues(K, java.lang.Iterable<? extends V>) methods each return a
Set of values, while
entries() returns a
Set of map entries. Though the method
signature doesn't say so explicitly, the map returned by
Since the value collections are sets, the behavior of a
SetMultimap is not specified
if key or value objects already present in the multimap change in a manner that affects
equals comparisons. Use caution if mutable objects are used as keys or values in a
See the Guava User Guide article on
|Modifier and Type||Method and Description|
Returns a view of this multimap as a
Returns a view collection of all key-value pairs contained in this multimap, as
Compares the specified object to this multimap for equality.
Returns a view collection of the values associated with
Removes all values associated with the key
Stores a collection of values with the same key, replacing any existing values for that key.
Set<V> get(@NullableDecl K key)
keyin this multimap, if any. Note that when
containsKey(key)is false, this returns an empty collection, not
Changes to the returned collection will update the underlying multimap, and vice versa.
@CanIgnoreReturnValue Set<V> replaceValues(K key, Iterable<? extends V> values)
values is empty, this is equivalent to
Any duplicates in
values will be stored in the multimap once.
Changes to the returned collection or the entries it contains will update the underlying multimap, and vice versa. However, adding to the returned collection is not possible.
Mapfrom each distinct key to the nonempty collection of that key's associated values. Note that
this.asMap().get(k)is equivalent to
kis a key contained in the multimap; otherwise it returns
nullas opposed to an empty collection.
Changes to the returned map or the collections that serve as its values will update the
underlying multimap, and vice versa. The map does not support
nor do its entries support
boolean equals(@NullableDecl Object obj)
SetMultimap instances are equal if, for each key, they contain the same values.
Equality does not depend on the ordering of keys or values.
SetMultimap is equal to any other empty
Multimap, including an
Copyright © 2010–2018. All rights reserved.