Class Byte2CharRBTreeMap
- java.lang.Object
-
- it.unimi.dsi.fastutil.bytes.AbstractByte2CharFunction
-
- it.unimi.dsi.fastutil.bytes.AbstractByte2CharMap
-
- it.unimi.dsi.fastutil.bytes.AbstractByte2CharSortedMap
-
- it.unimi.dsi.fastutil.bytes.Byte2CharRBTreeMap
-
- All Implemented Interfaces:
Byte2CharFunction
,Byte2CharMap
,Byte2CharSortedMap
,Function<java.lang.Byte,java.lang.Character>
,java.io.Serializable
,java.lang.Cloneable
,java.util.function.Function<java.lang.Byte,java.lang.Character>
,java.util.function.IntUnaryOperator
,java.util.Map<java.lang.Byte,java.lang.Character>
,java.util.SortedMap<java.lang.Byte,java.lang.Character>
public class Byte2CharRBTreeMap extends AbstractByte2CharSortedMap implements java.io.Serializable, java.lang.Cloneable
A type-specific red-black tree map with a fast, small-footprint implementation.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.- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class it.unimi.dsi.fastutil.bytes.AbstractByte2CharMap
AbstractByte2CharMap.BasicEntry, AbstractByte2CharMap.BasicEntrySet
-
Nested classes/interfaces inherited from interface it.unimi.dsi.fastutil.bytes.Byte2CharMap
Byte2CharMap.FastEntrySet
-
Nested classes/interfaces inherited from interface it.unimi.dsi.fastutil.bytes.Byte2CharSortedMap
Byte2CharSortedMap.FastSortedEntrySet
-
-
Constructor Summary
Constructors Constructor Description Byte2CharRBTreeMap()
Creates a new empty tree map.Byte2CharRBTreeMap(byte[] k, char[] v)
Creates a new tree map using the elements of two parallel arrays.Byte2CharRBTreeMap(byte[] k, char[] v, java.util.Comparator<? super java.lang.Byte> c)
Creates a new tree map using the elements of two parallel arrays and the given comparator.Byte2CharRBTreeMap(Byte2CharMap m)
Creates a new tree map copying a given map.Byte2CharRBTreeMap(Byte2CharSortedMap m)
Creates a new tree map copying a given sorted map (and itsComparator
).Byte2CharRBTreeMap(java.util.Comparator<? super java.lang.Byte> c)
Creates a new empty tree map with the given comparator.Byte2CharRBTreeMap(java.util.Map<? extends java.lang.Byte,? extends java.lang.Character> m)
Creates a new tree map copying a given map.Byte2CharRBTreeMap(java.util.SortedMap<java.lang.Byte,java.lang.Character> m)
Creates a new tree map copying a given sorted map (and itsComparator
).
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description char
addTo(byte k, char incr)
Adds an increment to value currently associated with a key.ObjectSortedSet<Byte2CharMap.Entry>
byte2CharEntrySet()
Returns a type-specific sorted-set view of the mappings contained in this map.void
clear()
Removes all of the mappings from this map (optional operation).Byte2CharRBTreeMap
clone()
Returns a deep copy of this tree map.ByteComparator
comparator()
Returns the comparator associated with this sorted set, or null if it uses its keys' natural ordering.boolean
containsKey(byte k)
Returns true if this function contains a mapping for the specified key.boolean
containsValue(char v)
Returnstrue
if this map maps one or more keys to the specified value.byte
firstByteKey()
Returns the first (lowest) key currently in this map.char
get(byte k)
Returns the value to which the given key is mapped.Byte2CharSortedMap
headMap(byte to)
Returns a view of the portion of this sorted map whose keys are strictly less thantoKey
.boolean
isEmpty()
ByteSortedSet
keySet()
Returns a type-specific sorted set view of the keys contained in this map.byte
lastByteKey()
Returns the last (highest) key currently in this map.char
put(byte k, char v)
Adds a pair to the map (optional operation).char
remove(byte k)
Removes the mapping with the given key (optional operation).int
size()
Returns the number of key/value mappings in this map.Byte2CharSortedMap
subMap(byte from, byte to)
Returns a view of the portion of this sorted map whose keys range fromfromKey
, inclusive, totoKey
, exclusive.Byte2CharSortedMap
tailMap(byte from)
Returns a view of the portion of this sorted map whose keys are greater than or equal tofromKey
.CharCollection
values()
Returns a type-specific collection view of the values contained in this map.-
Methods inherited from class it.unimi.dsi.fastutil.bytes.AbstractByte2CharMap
equals, hashCode, putAll, toString
-
Methods inherited from class it.unimi.dsi.fastutil.bytes.AbstractByte2CharFunction
defaultReturnValue, defaultReturnValue
-
Methods inherited from interface it.unimi.dsi.fastutil.bytes.Byte2CharFunction
andThen, andThenByte, andThenChar, andThenDouble, andThenFloat, andThenInt, andThenLong, andThenObject, andThenReference, andThenShort, applyAsInt, compose, composeByte, composeChar, composeDouble, composeFloat, composeInt, composeLong, composeObject, composeReference, composeShort
-
Methods inherited from interface it.unimi.dsi.fastutil.bytes.Byte2CharMap
compute, compute, computeIfAbsent, computeIfAbsent, computeIfAbsent, computeIfAbsentNullable, computeIfAbsentPartial, computeIfPresent, computeIfPresent, containsKey, containsValue, defaultReturnValue, defaultReturnValue, forEach, get, getOrDefault, getOrDefault, merge, merge, mergeChar, mergeChar, put, putIfAbsent, putIfAbsent, remove, remove, remove, replace, replace, replace, replace
-
-
-
-
Constructor Detail
-
Byte2CharRBTreeMap
public Byte2CharRBTreeMap()
Creates a new empty tree map.
-
Byte2CharRBTreeMap
public Byte2CharRBTreeMap(java.util.Comparator<? super java.lang.Byte> c)
Creates a new empty tree map with the given comparator.- Parameters:
c
- a (possibly type-specific) comparator.
-
Byte2CharRBTreeMap
public Byte2CharRBTreeMap(java.util.Map<? extends java.lang.Byte,? extends java.lang.Character> m)
Creates a new tree map copying a given map.- Parameters:
m
- aMap
to be copied into the new tree map.
-
Byte2CharRBTreeMap
public Byte2CharRBTreeMap(java.util.SortedMap<java.lang.Byte,java.lang.Character> m)
Creates a new tree map copying a given sorted map (and itsComparator
).- Parameters:
m
- aSortedMap
to be copied into the new tree map.
-
Byte2CharRBTreeMap
public Byte2CharRBTreeMap(Byte2CharMap m)
Creates a new tree map copying a given map.- Parameters:
m
- a type-specific map to be copied into the new tree map.
-
Byte2CharRBTreeMap
public Byte2CharRBTreeMap(Byte2CharSortedMap m)
Creates a new tree map copying a given sorted map (and itsComparator
).- Parameters:
m
- a type-specific sorted map to be copied into the new tree map.
-
Byte2CharRBTreeMap
public Byte2CharRBTreeMap(byte[] k, char[] v, java.util.Comparator<? super java.lang.Byte> c)
Creates a new tree map using the elements of two parallel arrays and the given comparator.- Parameters:
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.- Throws:
java.lang.IllegalArgumentException
- ifk
andv
have different lengths.
-
Byte2CharRBTreeMap
public Byte2CharRBTreeMap(byte[] k, char[] v)
Creates a new tree map using the elements of two parallel arrays.- Parameters:
k
- the array of keys of the new tree map.v
- the array of corresponding values in the new tree map.- Throws:
java.lang.IllegalArgumentException
- ifk
andv
have different lengths.
-
-
Method Detail
-
addTo
public char addTo(byte k, char incr)
Adds an increment to value currently associated with a key.Note that this method respects the default return value semantics: when called with a key that does not currently appears in the map, the key will be associated with the default return value plus the given increment.
- Parameters:
k
- the key.incr
- the increment.- Returns:
- the old value, or the default return value if no value was present for the given key.
-
put
public char put(byte k, char v)
Description copied from interface:Byte2CharFunction
Adds a pair to the map (optional operation).- Specified by:
put
in interfaceByte2CharFunction
- Parameters:
k
- the key.v
- the value.- Returns:
- the old value, or the default return value if no value was present for the given key.
- See Also:
Function.put(Object,Object)
-
remove
public char remove(byte k)
Description copied from interface:Byte2CharFunction
Removes the mapping with the given key (optional operation).- Specified by:
remove
in interfaceByte2CharFunction
- Parameters:
k
- the key.- Returns:
- the old value, or the default return value if no value was present for the given key.
- See Also:
Function.remove(Object)
-
containsValue
public boolean containsValue(char v)
Description copied from class:AbstractByte2CharMap
Returnstrue
if this map maps one or more keys to the specified value.- Specified by:
containsValue
in interfaceByte2CharMap
- Overrides:
containsValue
in classAbstractByte2CharMap
- See Also:
Map.containsValue(Object)
-
clear
public void clear()
Description copied from interface:Byte2CharMap
Removes all of the mappings from this map (optional operation). The map will be empty after this call returns.- Specified by:
clear
in interfaceByte2CharMap
- Specified by:
clear
in interfaceFunction<java.lang.Byte,java.lang.Character>
- Specified by:
clear
in interfacejava.util.Map<java.lang.Byte,java.lang.Character>
- See Also:
Map.clear()
-
containsKey
public boolean containsKey(byte k)
Description copied from class:AbstractByte2CharMap
Returns true if this function contains a mapping for the specified key.- Specified by:
containsKey
in interfaceByte2CharFunction
- Specified by:
containsKey
in interfaceByte2CharMap
- Overrides:
containsKey
in classAbstractByte2CharMap
- Parameters:
k
- the key.- Returns:
- true if this function associates a value to
key
. - See Also:
Map.containsKey(Object)
-
size
public int size()
Description copied from interface:Byte2CharMap
Returns the number of key/value mappings in this map. If the map contains more thanInteger.MAX_VALUE
elements, returnsInteger.MAX_VALUE
.- Specified by:
size
in interfaceByte2CharMap
- Specified by:
size
in interfaceFunction<java.lang.Byte,java.lang.Character>
- Specified by:
size
in interfacejava.util.Map<java.lang.Byte,java.lang.Character>
- Returns:
- the number of key-value mappings in this map.
- See Also:
Size64
-
isEmpty
public boolean isEmpty()
- Specified by:
isEmpty
in interfacejava.util.Map<java.lang.Byte,java.lang.Character>
- Overrides:
isEmpty
in classAbstractByte2CharMap
-
get
public char get(byte k)
Description copied from interface:Byte2CharFunction
Returns the value to which the given key is mapped.- Specified by:
get
in interfaceByte2CharFunction
- Parameters:
k
- the key.- Returns:
- the corresponding value, or the default return value if no value was present for the given key.
- See Also:
Function.get(Object)
-
firstByteKey
public byte firstByteKey()
Description copied from interface:Byte2CharSortedMap
Returns the first (lowest) key currently in this map.- Specified by:
firstByteKey
in interfaceByte2CharSortedMap
- See Also:
SortedMap.firstKey()
-
lastByteKey
public byte lastByteKey()
Description copied from interface:Byte2CharSortedMap
Returns the last (highest) key currently in this map.- Specified by:
lastByteKey
in interfaceByte2CharSortedMap
- See Also:
SortedMap.lastKey()
-
byte2CharEntrySet
public ObjectSortedSet<Byte2CharMap.Entry> byte2CharEntrySet()
Description copied from interface:Byte2CharSortedMap
Returns a type-specific sorted-set view of the mappings contained in this map.- Specified by:
byte2CharEntrySet
in interfaceByte2CharMap
- Specified by:
byte2CharEntrySet
in interfaceByte2CharSortedMap
- Returns:
- a type-specific sorted-set view of the mappings contained in this map.
- See Also:
Byte2CharSortedMap.entrySet()
-
keySet
public ByteSortedSet keySet()
Returns a type-specific sorted set view of the keys contained in this map.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.- Specified by:
keySet
in interfaceByte2CharMap
- Specified by:
keySet
in interfaceByte2CharSortedMap
- Specified by:
keySet
in interfacejava.util.Map<java.lang.Byte,java.lang.Character>
- Specified by:
keySet
in interfacejava.util.SortedMap<java.lang.Byte,java.lang.Character>
- Overrides:
keySet
in classAbstractByte2CharSortedMap
- Returns:
- a type-specific sorted set view of the keys contained in this map.
- See Also:
Map.keySet()
-
values
public CharCollection values()
Returns a type-specific collection view of the values contained in this map.In addition to the semantics of
Map.values()
, you can safely cast the collection returned by this call to a type-specific collection interface.- Specified by:
values
in interfaceByte2CharMap
- Specified by:
values
in interfaceByte2CharSortedMap
- Specified by:
values
in interfacejava.util.Map<java.lang.Byte,java.lang.Character>
- Specified by:
values
in interfacejava.util.SortedMap<java.lang.Byte,java.lang.Character>
- Overrides:
values
in classAbstractByte2CharSortedMap
- Returns:
- a type-specific collection view of the values contained in this map.
- See Also:
Map.values()
-
comparator
public ByteComparator comparator()
Description copied from interface:Byte2CharSortedMap
Returns the comparator associated with this sorted set, or null if it uses its keys' natural ordering.- Specified by:
comparator
in interfaceByte2CharSortedMap
- Specified by:
comparator
in interfacejava.util.SortedMap<java.lang.Byte,java.lang.Character>
- See Also:
SortedMap.comparator()
-
headMap
public Byte2CharSortedMap headMap(byte to)
Description copied from interface:Byte2CharSortedMap
Returns a view of the portion of this sorted map whose keys are strictly less thantoKey
.- Specified by:
headMap
in interfaceByte2CharSortedMap
- See Also:
SortedMap.headMap(Object)
-
tailMap
public Byte2CharSortedMap tailMap(byte from)
Description copied from interface:Byte2CharSortedMap
Returns a view of the portion of this sorted map whose keys are greater than or equal tofromKey
.- Specified by:
tailMap
in interfaceByte2CharSortedMap
- See Also:
SortedMap.tailMap(Object)
-
subMap
public Byte2CharSortedMap subMap(byte from, byte to)
Description copied from interface:Byte2CharSortedMap
Returns a view of the portion of this sorted map whose keys range fromfromKey
, inclusive, totoKey
, exclusive.- Specified by:
subMap
in interfaceByte2CharSortedMap
- See Also:
SortedMap.subMap(Object,Object)
-
clone
public Byte2CharRBTreeMap clone()
Returns a deep copy of this tree map.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.
- Returns:
- a deep copy of this tree map.
-
-