public class Reference2ObjectArrayMap<K,V> extends AbstractReference2ObjectMap<K,V> implements java.io.Serializable, java.lang.Cloneable
The main purpose of this implementation is that of wrapping cleanly the brute-force approach to the storage of a very small number of pairs: just put them into two parallel arrays and scan linearly to find an item.
AbstractReference2ObjectMap.BasicEntry<K,V>
Reference2ObjectMap.Entry<K,V>, Reference2ObjectMap.FastEntrySet<K,V>
Constructor and Description |
---|
Reference2ObjectArrayMap()
Creates a new empty array map.
|
Reference2ObjectArrayMap(int capacity)
Creates a new empty array map of given capacity.
|
Reference2ObjectArrayMap(java.util.Map<? extends K,? extends V> m)
Creates a new empty array map copying the entries of a given map.
|
Reference2ObjectArrayMap(java.lang.Object[] key,
java.lang.Object[] value)
Creates a new empty array map with given key and value backing arrays.
|
Reference2ObjectArrayMap(java.lang.Object[] key,
java.lang.Object[] value,
int size)
Creates a new array map with given key and value backing arrays, using the given number of elements.
|
Reference2ObjectArrayMap(Reference2ObjectMap<K,V> m)
Creates a new empty array map copying the entries of a given map.
|
Modifier and Type | Method and Description |
---|---|
void |
clear()
Removes all associations from this function (optional operation).
|
Reference2ObjectArrayMap<K,V> |
clone()
Returns a deep copy of this map.
|
boolean |
containsKey(java.lang.Object k)
Checks whether the given value is contained in
AbstractReference2ObjectMap.keySet() . |
boolean |
containsValue(java.lang.Object v)
Checks whether the given value is contained in
AbstractReference2ObjectMap.values() . |
V |
get(java.lang.Object k)
Returns the value associated by this function to the specified key.
|
boolean |
isEmpty() |
ReferenceSet<K> |
keySet()
Returns a type-specific-set view of the keys of this map.
|
V |
put(K k,
V v)
Associates the specified value with the specified key in this function (optional operation).
|
Reference2ObjectMap.FastEntrySet<K,V> |
reference2ObjectEntrySet()
Returns a type-specific set view of the mappings contained in this map.
|
V |
remove(java.lang.Object k)
Removes this key and the associated value from this function if it is present (optional operation).
|
int |
size()
Returns the intended number of keys in this function, or -1 if no such number exists.
|
ObjectCollection<V> |
values()
Returns a type-specific-set view of the values of this map.
|
entrySet, equals, hashCode, putAll, toString
defaultReturnValue, defaultReturnValue
defaultReturnValue, defaultReturnValue
public Reference2ObjectArrayMap(java.lang.Object[] key, java.lang.Object[] value)
It is responsibility of the caller that the elements of key
are distinct.
key
- the key array.value
- the value array (it must have the same length as key
).public Reference2ObjectArrayMap()
public Reference2ObjectArrayMap(int capacity)
capacity
- the initial capacity.public Reference2ObjectArrayMap(Reference2ObjectMap<K,V> m)
m
- a map.public Reference2ObjectArrayMap(java.util.Map<? extends K,? extends V> m)
m
- a map.public Reference2ObjectArrayMap(java.lang.Object[] key, java.lang.Object[] value, int size)
It is responsibility of the caller that the first size
elements of key
are distinct.
key
- the key array.value
- the value array (it must have the same length as key
).size
- the number of valid elements in key
and value
.public Reference2ObjectMap.FastEntrySet<K,V> reference2ObjectEntrySet()
Reference2ObjectMap
This method is necessary because there is no inheritance along
type parameters: it is thus impossible to strengthen Reference2ObjectMap.entrySet()
so that it returns an ObjectSet
of type-specific entries (the latter makes it possible to
access keys and values with type-specific methods).
reference2ObjectEntrySet
in interface Reference2ObjectMap<K,V>
Reference2ObjectMap.entrySet()
public V get(java.lang.Object k)
Function
public int size()
Function
Most function implementations will have some knowledge of the intended number of keys in their domain. In some cases, however, this might not be possible.
public void clear()
Function
public boolean containsKey(java.lang.Object k)
AbstractReference2ObjectMap
AbstractReference2ObjectMap.keySet()
.containsKey
in interface Function<K,V>
containsKey
in interface java.util.Map<K,V>
containsKey
in class AbstractReference2ObjectMap<K,V>
k
- the key.key
.Map.containsKey(Object)
public boolean containsValue(java.lang.Object v)
AbstractReference2ObjectMap
AbstractReference2ObjectMap.values()
.containsValue
in interface java.util.Map<K,V>
containsValue
in class AbstractReference2ObjectMap<K,V>
public boolean isEmpty()
public V put(K k, V v)
Function
put
in interface Function<K,V>
put
in interface java.util.Map<K,V>
put
in class AbstractReference2ObjectFunction<K,V>
k
- the key.v
- the value.null
if no value was present for the given key.Map.put(Object,Object)
public V remove(java.lang.Object k)
Function
public ReferenceSet<K> keySet()
AbstractReference2ObjectMap
The view is backed by the set returned by AbstractReference2ObjectMap.entrySet()
. Note that
no attempt is made at caching the result of this method, as this would
require adding some attributes that lightweight implementations would
not need. Subclasses may easily override this policy by calling
this method and caching the result, but implementors are encouraged to
write more efficient ad-hoc implementations.
keySet
in interface Reference2ObjectMap<K,V>
keySet
in interface java.util.Map<K,V>
keySet
in class AbstractReference2ObjectMap<K,V>
Map.keySet()
public ObjectCollection<V> values()
AbstractReference2ObjectMap
The view is backed by the set returned by AbstractReference2ObjectMap.entrySet()
. Note that
no attempt is made at caching the result of this method, as this would
require adding some attributes that lightweight implementations would
not need. Subclasses may easily override this policy by calling
this method and caching the result, but implementors are encouraged to
write more efficient ad-hoc implementations.
values
in interface Reference2ObjectMap<K,V>
values
in interface java.util.Map<K,V>
values
in class AbstractReference2ObjectMap<K,V>
Map.values()
public Reference2ObjectArrayMap<K,V> clone()
This method performs a deep copy of this hash map; the data stored in the map, however, is not cloned. Note that this makes a difference only for object keys.
clone
in class java.lang.Object