
javadoc.com.google.common.collect.EnumBiMap.html Maven / Gradle / Ivy
The newest version!
EnumBiMap (Guava: Google Core Libraries for Java 11.0.1 API)
Overview
Package
Class
Use
Tree
Deprecated
Index
Help
PREV CLASS
NEXT CLASS
FRAMES
NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD
DETAIL: FIELD | CONSTR | METHOD
com.google.common.collect
Class EnumBiMap<K extends Enum<K>,V extends Enum<V>>
java.lang.Object
com.google.common.collect.ForwardingObject
com.google.common.collect.ForwardingMap<K,V>
com.google.common.collect.EnumBiMap<K,V>
- All Implemented Interfaces:
- BiMap<K,V>, Serializable, Map<K,V>
@GwtCompatible(emulated=true)
public final class EnumBiMap<K extends Enum<K>,V extends Enum<V>>
- extends ForwardingMap<K,V>
A BiMap
backed by two EnumMap
instances. Null keys and values
are not permitted. An EnumBiMap
and its inverse are both
serializable.
- Since:
- 2.0 (imported from Google Collections Library)
- Author:
- Mike Bostock
- See Also:
- Serialized Form
Nested Class Summary |
---|
Nested classes/interfaces inherited from class com.google.common.collect.ForwardingMap |
---|
ForwardingMap.StandardEntrySet, ForwardingMap.StandardKeySet, ForwardingMap.StandardValues |
Nested classes/interfaces inherited from interface java.util.Map |
---|
Map.Entry<K,V> |
Method Summary | ||
---|---|---|
void |
clear()
|
|
boolean |
containsValue(Object value)
|
|
static
|
create(Class<K> keyType,
Class<V> valueType)
Returns a new, empty EnumBiMap using the specified key and value
types. |
|
static
|
create(Map<K,V> map)
Returns a new bimap with the same mappings as the specified map. |
|
protected Map<K,V> |
delegate()
Returns the backing delegate instance that methods are forwarded to. |
|
Set<Map.Entry<K,V>> |
entrySet()
|
|
V |
forcePut(K key,
V value)
An alternate form of put that silently removes any existing entry
with the value value before proceeding with the BiMap.put(K, V)
operation. |
|
BiMap<V,K> |
inverse()
Returns the inverse view of this bimap, which maps each of this bimap's values to its associated key. |
|
Set<K> |
keySet()
|
|
Class<K> |
keyType()
Returns the associated key type. |
|
V |
put(K key,
V value)
|
|
void |
putAll(Map<? extends K,? extends V> map)
|
|
V |
remove(Object key)
|
|
Set<V> |
values()
|
|
Class<V> |
valueType()
Returns the associated value type. |
Methods inherited from class com.google.common.collect.ForwardingMap |
---|
containsKey, equals, get, hashCode, isEmpty, size, standardClear, standardContainsKey, standardContainsValue, standardEquals, standardHashCode, standardIsEmpty, standardPutAll, standardRemove, standardToString |
Methods inherited from class com.google.common.collect.ForwardingObject |
---|
toString |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface java.util.Map |
---|
containsKey, equals, get, hashCode, isEmpty, size |
Method Detail |
---|
create
public static <K extends Enum<K>,V extends Enum<V>> EnumBiMap<K,V> create(Class<K> keyType, Class<V> valueType)
- Returns a new, empty
EnumBiMap
using the specified key and value types.- Parameters:
keyType
- the key typevalueType
- the value type
create
public static <K extends Enum<K>,V extends Enum<V>> EnumBiMap<K,V> create(Map<K,V> map)
- Returns a new bimap with the same mappings as the specified map. If the
specified map is an
EnumBiMap
, the new bimap has the same types as the provided map. Otherwise, the specified map must contain at least one mapping, in order to determine the key and value types.- Parameters:
map
- the map whose mappings are to be placed in this map- Throws:
IllegalArgumentException
- if map is not anEnumBiMap
instance and contains no mappings
keyType
public Class<K> keyType()
- Returns the associated key type.
valueType
public Class<V> valueType()
- Returns the associated value type.
delegate
protected Map<K,V> delegate()
- Description copied from class:
ForwardingObject
- Returns the backing delegate instance that methods are forwarded to.
Abstract subclasses generally override this method with an abstract method
that has a more specific return type, such as
ForwardingSet.delegate()
. Concrete subclasses override this method to supply the instance being decorated.- Specified by:
delegate
in classForwardingMap<K,V>
containsValue
public boolean containsValue(Object value)
- Specified by:
containsValue
in interfaceMap<K,V>
- Overrides:
containsValue
in classForwardingMap<K,V>
put
public V put(K key, V value)
- Description copied from interface:
BiMap
-
forcePut
public V forcePut(K key, V value)
- Description copied from interface:
BiMap
- An alternate form of
put
that silently removes any existing entry with the valuevalue
before proceeding with theBiMap.put(K, V)
operation. If the bimap previously contained the provided key-value mapping, this method has no effect.Note that a successful call to this method could cause the size of the bimap to increase by one, stay the same, or even decrease by one.
Warning: If an existing entry with this value is removed, the key for that entry is discarded and not returned.
- Parameters:
key
- the key with which the specified value is to be associatedvalue
- the value to be associated with the specified key- Returns:
- the value which was previously associated with the key, which may
be
null
, ornull
if there was no previous entry
remove
public V remove(Object key)
- Specified by:
remove
in interfaceMap<K,V>
- Overrides:
remove
in classForwardingMap<K,V>
putAll
public void putAll(Map<? extends K,? extends V> map)
- Description copied from interface:
BiMap
-
Warning: the results of calling this method may vary depending on the iteration order of
map
.
clear
public void clear()
- Specified by:
clear
in interfaceMap<K,V>
- Overrides:
clear
in classForwardingMap<K,V>
inverse
public BiMap<V,K> inverse()
- Description copied from interface:
BiMap
- Returns the inverse view of this bimap, which maps each of this bimap's
values to its associated key. The two bimaps are backed by the same data;
any changes to one will appear in the other.
Note:There is no guaranteed correspondence between the iteration order of a bimap and that of its inverse.
- Returns:
- the inverse view of this bimap
keySet
public Set<K> keySet()
- Specified by:
keySet
in interfaceMap<K,V>
- Overrides:
keySet
in classForwardingMap<K,V>
values
public Set<V> values()
- Description copied from interface:
BiMap
-
Because a bimap has unique values, this method returns a
Set
, instead of theCollection
specified in theMap
interface.
entrySet
public Set<Map.Entry<K,V>> entrySet()
- Specified by:
entrySet
in interfaceMap<K,V>
- Overrides:
entrySet
in classForwardingMap<K,V>
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 2010-2012. All Rights Reserved.
© 2015 - 2025 Weber Informatics LLC | Privacy Policy