public class Long2ReferenceRBTreeMap<V> extends AbstractLong2ReferenceSortedMap<V> implements java.io.Serializable, java.lang.Cloneable
The iterators provided by the views of this class are type-specific bidirectional iterators.
Moreover, the iterator returned by iterator()
can be safely cast
to a type-specific list iterator.
AbstractLong2ReferenceMap.BasicEntry<V>
Long2ReferenceSortedMap.FastSortedEntrySet<V>
Long2ReferenceMap.FastEntrySet<V>
Constructor and Description |
---|
Long2ReferenceRBTreeMap()
Creates a new empty tree map.
|
Long2ReferenceRBTreeMap(java.util.Comparator<? super java.lang.Long> c)
Creates a new empty tree map with the given comparator.
|
Long2ReferenceRBTreeMap(long[] k,
V[] v)
Creates a new tree map using the elements of two parallel arrays.
|
Long2ReferenceRBTreeMap(long[] k,
V[] v,
java.util.Comparator<? super java.lang.Long> c)
Creates a new tree map using the elements of two parallel arrays and the given comparator.
|
Long2ReferenceRBTreeMap(Long2ReferenceMap<? extends V> m)
Creates a new tree map copying a given map.
|
Long2ReferenceRBTreeMap(Long2ReferenceSortedMap<V> m)
Creates a new tree map copying a given sorted map (and its
Comparator ). |
Long2ReferenceRBTreeMap(java.util.Map<? extends java.lang.Long,? extends V> m)
Creates a new tree map copying a given map.
|
Long2ReferenceRBTreeMap(java.util.SortedMap<java.lang.Long,V> m)
Creates a new tree map copying a given sorted map (and its
Comparator ). |
Modifier and Type | Method and Description |
---|---|
void |
clear()
Removes all associations from this function (optional operation).
|
Long2ReferenceRBTreeMap<V> |
clone()
Returns a deep copy of this tree map.
|
LongComparator |
comparator()
Returns the comparator associated with this sorted set, or null if it uses its keys' natural ordering.
|
boolean |
containsKey(long k)
Checks whether the given value is contained in
AbstractLong2ReferenceMap.keySet() . |
boolean |
containsValue(java.lang.Object v)
Checks whether the given value is contained in
AbstractLong2ReferenceMap.values() . |
long |
firstLongKey() |
V |
get(long k)
Returns the value to which the given key is mapped.
|
Long2ReferenceSortedMap<V> |
headMap(long to)
Returns a view of the portion of this sorted map whose keys are strictly less than
toKey . |
boolean |
isEmpty() |
LongSortedSet |
keySet()
Returns a type-specific sorted set view of the keys contained in this map.
|
long |
lastLongKey() |
ObjectSortedSet<Long2ReferenceMap.Entry<V>> |
long2ReferenceEntrySet()
Returns a type-specific sorted-set view of the mappings contained in this map.
|
V |
put(long k,
V v)
Adds a pair to the map.
|
V |
put(java.lang.Long ok,
V ov)
Delegates to the corresponding type-specific method, taking care of returning
null on a missing key. |
V |
remove(long k)
Removes the mapping with the given key.
|
V |
remove(java.lang.Object ok)
Delegates to the corresponding type-specific method, taking care of returning
null on a missing key. |
int |
size()
Returns the intended number of keys in this function, or -1 if no such number exists.
|
Long2ReferenceSortedMap<V> |
subMap(long from,
long to)
Returns a view of the portion of this sorted map whose keys range from
fromKey , inclusive, to toKey , exclusive. |
Long2ReferenceSortedMap<V> |
tailMap(long from)
Returns a view of the portion of this sorted map whose keys are greater than or equal to
fromKey . |
ReferenceCollection<V> |
values()
Returns a type-specific collection view of the values contained in this map.
|
entrySet, firstKey, headMap, lastKey, subMap, tailMap
equals, hashCode, putAll, toString
containsKey, defaultReturnValue, defaultReturnValue, get
defaultReturnValue, defaultReturnValue
containsKey, get
public Long2ReferenceRBTreeMap()
public Long2ReferenceRBTreeMap(java.util.Comparator<? super java.lang.Long> c)
c
- a (possibly type-specific) comparator.public Long2ReferenceRBTreeMap(java.util.Map<? extends java.lang.Long,? extends V> m)
m
- a Map
to be copied into the new tree map.public Long2ReferenceRBTreeMap(java.util.SortedMap<java.lang.Long,V> m)
Comparator
).m
- a SortedMap
to be copied into the new tree map.public Long2ReferenceRBTreeMap(Long2ReferenceMap<? extends V> m)
m
- a type-specific map to be copied into the new tree map.public Long2ReferenceRBTreeMap(Long2ReferenceSortedMap<V> m)
Comparator
).m
- a type-specific sorted map to be copied into the new tree map.public Long2ReferenceRBTreeMap(long[] k, V[] v, java.util.Comparator<? super java.lang.Long> c)
k
- the array of keys of the new tree map.v
- the array of corresponding values in the new tree map.c
- a (possibly type-specific) comparator.java.lang.IllegalArgumentException
- if k
and v
have different lengths.public Long2ReferenceRBTreeMap(long[] k, V[] v)
k
- the array of keys of the new tree map.v
- the array of corresponding values in the new tree map.java.lang.IllegalArgumentException
- if k
and v
have different lengths.public V put(long k, V v)
Long2ReferenceFunction
put
in interface Long2ReferenceFunction<V>
put
in class AbstractLong2ReferenceFunction<V>
k
- the key.v
- the value.Function.put(Object,Object)
public V remove(long k)
Long2ReferenceFunction
remove
in interface Long2ReferenceFunction<V>
remove
in class AbstractLong2ReferenceFunction<V>
k
- the key.Function.remove(Object)
public V put(java.lang.Long ok, V ov)
AbstractLong2ReferenceFunction
null
on a missing key.
This method must check whether the provided key is in the map using containsKey()
. Thus,
it probes the map twice. Implementors of subclasses should override it with a more efficient method.
put
in interface Function<java.lang.Long,V>
put
in interface java.util.Map<java.lang.Long,V>
put
in class AbstractLong2ReferenceFunction<V>
ok
- the key.ov
- the value.null
if no value was present for the given key.Map.put(Object,Object)
public V remove(java.lang.Object ok)
AbstractLong2ReferenceFunction
null
on a missing key.
This method must check whether the provided key is in the map using containsKey()
. Thus,
it probes the map twice. Implementors of subclasses should override it with a more efficient method.
remove
in interface Function<java.lang.Long,V>
remove
in interface java.util.Map<java.lang.Long,V>
remove
in class AbstractLong2ReferenceFunction<V>
ok
- the key.null
if no value was present for the given key.Map.remove(Object)
public boolean containsValue(java.lang.Object v)
AbstractLong2ReferenceMap
AbstractLong2ReferenceMap.values()
.containsValue
in interface java.util.Map<java.lang.Long,V>
containsValue
in class AbstractLong2ReferenceMap<V>
public void clear()
Function
public boolean containsKey(long k)
AbstractLong2ReferenceMap
AbstractLong2ReferenceMap.keySet()
.containsKey
in interface Long2ReferenceFunction<V>
containsKey
in class AbstractLong2ReferenceMap<V>
Function.containsKey(Object)
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 boolean isEmpty()
isEmpty
in interface java.util.Map<java.lang.Long,V>
isEmpty
in class AbstractLong2ReferenceMap<V>
public V get(long k)
Long2ReferenceFunction
get
in interface Long2ReferenceFunction<V>
k
- the key.Function.get(Object)
public long firstLongKey()
firstLongKey
in interface Long2ReferenceSortedMap<V>
SortedMap.firstKey()
public long lastLongKey()
lastLongKey
in interface Long2ReferenceSortedMap<V>
SortedMap.lastKey()
public ObjectSortedSet<Long2ReferenceMap.Entry<V>> long2ReferenceEntrySet()
Long2ReferenceSortedMap
long2ReferenceEntrySet
in interface Long2ReferenceMap<V>
long2ReferenceEntrySet
in interface Long2ReferenceSortedMap<V>
Long2ReferenceSortedMap.entrySet()
public LongSortedSet keySet()
In addition to the semantics of Map.keySet()
, you can
safely cast the set returned by this call to a type-specific sorted
set interface.
keySet
in interface Long2ReferenceMap<V>
keySet
in interface Long2ReferenceSortedMap<V>
keySet
in interface java.util.Map<java.lang.Long,V>
keySet
in interface java.util.SortedMap<java.lang.Long,V>
keySet
in class AbstractLong2ReferenceSortedMap<V>
Map.keySet()
public ReferenceCollection<V> values()
In addition to the semantics of Map.values()
, you can
safely cast the collection returned by this call to a type-specific collection
interface.
values
in interface Long2ReferenceMap<V>
values
in interface Long2ReferenceSortedMap<V>
values
in interface java.util.Map<java.lang.Long,V>
values
in interface java.util.SortedMap<java.lang.Long,V>
values
in class AbstractLong2ReferenceSortedMap<V>
Map.values()
public LongComparator comparator()
Long2ReferenceSortedMap
Note that this specification strengthens the one given in SortedMap.comparator()
.
comparator
in interface Long2ReferenceSortedMap<V>
comparator
in interface java.util.SortedMap<java.lang.Long,V>
SortedMap.comparator()
public Long2ReferenceSortedMap<V> headMap(long to)
Long2ReferenceSortedMap
toKey
.headMap
in interface Long2ReferenceSortedMap<V>
SortedMap.headMap(Object)
public Long2ReferenceSortedMap<V> tailMap(long from)
Long2ReferenceSortedMap
fromKey
.tailMap
in interface Long2ReferenceSortedMap<V>
SortedMap.tailMap(Object)
public Long2ReferenceSortedMap<V> subMap(long from, long to)
Long2ReferenceSortedMap
fromKey
, inclusive, to toKey
, exclusive.subMap
in interface Long2ReferenceSortedMap<V>
SortedMap.subMap(Object,Object)
public Long2ReferenceRBTreeMap<V> clone()
This method performs a deep copy of this tree map; the data stored in the set, however, is not cloned. Note that this makes a difference only for object keys.
clone
in class java.lang.Object