public interface Double2ShortMap extends Double2ShortFunction, java.util.Map<java.lang.Double,java.lang.Short>
Map
; provides some additional methods that use polymorphism to avoid (un)boxing, and handling of a default return value.
Besides extending the corresponding type-specific function, this interface strengthens Map.entrySet()
,
keySet()
and values()
. Moreover, a number of methods, such as size()
, defaultReturnValue()
, etc., are un-defaulted
as their function default do not make sense for a map.
Maps returning entry sets of type Double2ShortMap.FastEntrySet
support also fast iteration.
A submap or subset may or may not have an independent default return value (which however must be initialized to the default return value of the originator).
Map
Modifier and Type | Interface and Description |
---|---|
static interface |
Double2ShortMap.Entry
A type-specific
Map.Entry ; provides some additional methods
that use polymorphism to avoid (un)boxing. |
static interface |
Double2ShortMap.FastEntrySet
An entry set providing fast iteration.
|
Modifier and Type | Method and Description |
---|---|
default void |
clear()
Removes all of the mappings from this map (optional operation).
|
default short |
compute(double key,
java.util.function.BiFunction<? super java.lang.Double,? super java.lang.Short,? extends java.lang.Short> remappingFunction)
Attempts to compute a mapping for the specified key and its current mapped value (or
null if there is no current mapping). |
default java.lang.Short |
compute(java.lang.Double key,
java.util.function.BiFunction<? super java.lang.Double,? super java.lang.Short,? extends java.lang.Short> remappingFunction)
Deprecated.
Please use the corresponding type-specific method instead.
|
default short |
computeIfAbsent(double key,
Double2ShortFunction mappingFunction)
If the specified key is not already associated with a value, attempts to compute its value
using the given mapping function and enters it into this map, unless the key is not present
in the given mapping function.
|
default short |
computeIfAbsent(double key,
java.util.function.DoubleToIntFunction mappingFunction)
If the specified key is not already associated with a value, attempts to compute its value
using the given mapping function and enters it into this map.
|
default java.lang.Short |
computeIfAbsent(java.lang.Double key,
java.util.function.Function<? super java.lang.Double,? extends java.lang.Short> mappingFunction)
Deprecated.
Please use the corresponding type-specific method instead.
|
default short |
computeIfAbsentNullable(double key,
java.util.function.DoubleFunction<? extends java.lang.Short> mappingFunction)
If the specified key is not already associated with a value, attempts to compute its value
using the given mapping function and enters it into this map unless it is
null . |
default short |
computeIfAbsentPartial(double key,
Double2ShortFunction mappingFunction)
Deprecated.
Please use
computeIfAbsent() instead. |
default short |
computeIfPresent(double key,
java.util.function.BiFunction<? super java.lang.Double,? super java.lang.Short,? extends java.lang.Short> remappingFunction)
If the value for the specified key is present, attempts to compute a new mapping given the key and its current mapped value.
|
default java.lang.Short |
computeIfPresent(java.lang.Double key,
java.util.function.BiFunction<? super java.lang.Double,? super java.lang.Short,? extends java.lang.Short> remappingFunction)
Deprecated.
Please use the corresponding type-specific method instead.
|
boolean |
containsKey(double key)
Returns true if this function contains a mapping for the specified key.
|
default boolean |
containsKey(java.lang.Object key)
Deprecated.
Please use the corresponding type-specific method instead.
|
default boolean |
containsValue(java.lang.Object value)
Deprecated.
Please use the corresponding type-specific method instead.
|
boolean |
containsValue(short value)
Returns
true if this map maps one or more keys to the specified value. |
short |
defaultReturnValue()
Gets the default return value.
|
void |
defaultReturnValue(short rv)
Sets the default return value (optional operation).
|
ObjectSet<Double2ShortMap.Entry> |
double2ShortEntrySet()
Returns a type-specific set view of the mappings contained in this map.
|
default ObjectSet<java.util.Map.Entry<java.lang.Double,java.lang.Short>> |
entrySet()
Deprecated.
Please use the corresponding type-specific method instead.
|
default void |
forEach(java.util.function.BiConsumer<? super java.lang.Double,? super java.lang.Short> consumer) |
default java.lang.Short |
get(java.lang.Object key)
Deprecated.
Please use the corresponding type-specific method instead.
|
default short |
getOrDefault(double key,
short defaultValue)
Returns the value to which the specified key is mapped, or the
defaultValue if this
map contains no mapping for the key. |
default java.lang.Short |
getOrDefault(java.lang.Object key,
java.lang.Short defaultValue)
Deprecated.
Please use the corresponding type-specific method instead.
|
DoubleSet |
keySet() |
default short |
merge(double key,
short value,
java.util.function.BiFunction<? super java.lang.Short,? super java.lang.Short,? extends java.lang.Short> remappingFunction)
If the specified key is not already associated with a value, associates it with the given
value . |
default java.lang.Short |
merge(java.lang.Double key,
java.lang.Short value,
java.util.function.BiFunction<? super java.lang.Short,? super java.lang.Short,? extends java.lang.Short> remappingFunction)
Deprecated.
Please use the corresponding type-specific method instead.
|
default short |
mergeShort(double key,
short value,
java.util.function.IntBinaryOperator remappingFunction)
If the specified key is not already associated with a value, associates it with the given
value . |
default short |
mergeShort(double key,
short value,
ShortBinaryOperator remappingFunction)
If the specified key is not already associated with a value, associates it with the given
value . |
default java.lang.Short |
put(java.lang.Double key,
java.lang.Short value)
Deprecated.
Please use the corresponding type-specific method instead.
|
default short |
putIfAbsent(double key,
short value)
If the specified key is not already associated with a value, associates it with the given
value and returns the default return value, else returns
the current value.
|
default java.lang.Short |
putIfAbsent(java.lang.Double key,
java.lang.Short value)
Deprecated.
Please use the corresponding type-specific method instead.
|
default boolean |
remove(double key,
short value)
Removes the entry for the specified key only if it is currently mapped to the specified value.
|
default java.lang.Short |
remove(java.lang.Object key)
Deprecated.
Please use the corresponding type-specific method instead.
|
default boolean |
remove(java.lang.Object key,
java.lang.Object value)
Deprecated.
Please use the corresponding type-specific method instead.
|
default short |
replace(double key,
short value)
Replaces the entry for the specified key only if it is currently mapped to some value.
|
default java.lang.Short |
replace(java.lang.Double key,
java.lang.Short value)
Deprecated.
Please use the corresponding type-specific method instead.
|
default boolean |
replace(double key,
short oldValue,
short newValue)
Replaces the entry for the specified key only if currently mapped to the specified value.
|
default boolean |
replace(java.lang.Double key,
java.lang.Short oldValue,
java.lang.Short newValue)
Deprecated.
Please use the corresponding type-specific method instead.
|
int |
size()
Returns the number of key/value mappings in this map.
|
ShortCollection |
values() |
andThen, andThenByte, andThenChar, andThenDouble, andThenFloat, andThenInt, andThenLong, andThenObject, andThenReference, andThenShort, applyAsInt, compose, composeByte, composeChar, composeDouble, composeFloat, composeInt, composeLong, composeObject, composeReference, composeShort, get, put, remove
int size()
Integer.MAX_VALUE
elements, returns Integer.MAX_VALUE
.size
in interface java.util.Map<java.lang.Double,java.lang.Short>
Size64
default void clear()
clear
in interface java.util.Map<java.lang.Double,java.lang.Short>
java.lang.UnsupportedOperationException
- if the clear()
operation is not supported by this mapMap.clear()
void defaultReturnValue(short rv)
get()
,
put()
and remove()
to denote that the map does not contain
the specified key. It must be 0/false
by default.defaultReturnValue
in interface Double2ShortFunction
rv
- the new default return value.defaultReturnValue()
short defaultReturnValue()
defaultReturnValue
in interface Double2ShortFunction
ObjectSet<Double2ShortMap.Entry> double2ShortEntrySet()
This method is necessary because there is no inheritance along
type parameters: it is thus impossible to strengthen Map.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).
Map.entrySet()
@Deprecated default ObjectSet<java.util.Map.Entry<java.lang.Double,java.lang.Short>> entrySet()
entrySet
in interface java.util.Map<java.lang.Double,java.lang.Short>
Map.entrySet()
Map.entrySet()
.@Deprecated default java.lang.Short put(java.lang.Double key, java.lang.Short value)
This default implementation just delegates to the corresponding type-specific–function method.
put
in interface Double2ShortFunction
put
in interface java.util.Map<java.lang.Double,java.lang.Short>
key
- the key.value
- the value.null
if no value was present for the given key.Map.put(Object,Object)
@Deprecated default java.lang.Short get(java.lang.Object key)
This default implementation just delegates to the corresponding type-specific–function method.
get
in interface Double2ShortFunction
get
in interface java.util.Map<java.lang.Double,java.lang.Short>
key
- the key.null
if no value was present for the given key.Map.get(Object)
@Deprecated default java.lang.Short remove(java.lang.Object key)
This default implementation just delegates to the corresponding type-specific–function method.
remove
in interface Double2ShortFunction
remove
in interface java.util.Map<java.lang.Double,java.lang.Short>
key
- the key.null
if no value was present for the given key.Map.remove(Object)
DoubleSet keySet()
keySet
in interface java.util.Map<java.lang.Double,java.lang.Short>
Map.keySet()
Map.keySet()
.ShortCollection values()
values
in interface java.util.Map<java.lang.Double,java.lang.Short>
Map.values()
Map.values()
.boolean containsKey(double key)
containsKey
in interface Double2ShortFunction
key
- the key.key
.Map.containsKey(Object)
@Deprecated default boolean containsKey(java.lang.Object key)
This default implementation just delegates to the corresponding type-specific–function method.
containsKey
in interface Double2ShortFunction
containsKey
in interface java.util.Map<java.lang.Double,java.lang.Short>
key
- the key.key
.Map.containsKey(Object)
boolean containsValue(short value)
true
if this map maps one or more keys to the specified value.Map.containsValue(Object)
@Deprecated default boolean containsValue(java.lang.Object value)
containsValue
in interface java.util.Map<java.lang.Double,java.lang.Short>
default void forEach(java.util.function.BiConsumer<? super java.lang.Double,? super java.lang.Short> consumer)
forEach
in interface java.util.Map<java.lang.Double,java.lang.Short>
default short getOrDefault(double key, short defaultValue)
defaultValue
if this
map contains no mapping for the key.getOrDefault
in interface Double2ShortFunction
key
- the key.defaultValue
- the default mapping of the key.defaultValue
if this map contains no mapping for the key.Map.getOrDefault(Object, Object)
@Deprecated default java.lang.Short getOrDefault(java.lang.Object key, java.lang.Short defaultValue)
This default implementation just delegates to the corresponding Map
method.
getOrDefault
in interface Double2ShortFunction
getOrDefault
in interface java.util.Map<java.lang.Double,java.lang.Short>
key
- the key.defaultValue
- the default value to return if not present.defaultValue
if no value was present for the
given key.Map.getOrDefault(Object, Object)
default short putIfAbsent(double key, short value)
key
- key with which the specified value is to be associated.value
- value to be associated with the specified key.Map.putIfAbsent(Object, Object)
default boolean remove(double key, short value)
key
- key with which the specified value is associated.value
- value expected to be associated with the specified key.true
if the value was removed.Map.remove(Object, Object)
default boolean replace(double key, short oldValue, short newValue)
key
- key with which the specified value is associated.oldValue
- value expected to be associated with the specified key.newValue
- value to be associated with the specified key.true
if the value was replaced.Map.replace(Object, Object, Object)
default short replace(double key, short value)
key
- key with which the specified value is associated.value
- value to be associated with the specified key.Map.replace(Object, Object)
default short computeIfAbsent(double key, java.util.function.DoubleToIntFunction mappingFunction)
Note that contrarily to the default computeIfAbsent(),
it is not possible to not add a value for a given key, since the mappingFunction
cannot
return null
. If such a behavior is needed, please use the corresponding nullable version.
key
- key with which the specified value is to be associated.mappingFunction
- the function to compute a value.Map.computeIfAbsent(Object, java.util.function.Function)
computeIfAbsent()
methods have a different logic based on the argument;
no delegation is performed, contrarily to other superficially similar
methods such as Iterator.forEachRemaining(java.util.function.Consumer<? super E>)
or List.replaceAll(java.util.function.UnaryOperator<E>)
.default short computeIfAbsentNullable(double key, java.util.function.DoubleFunction<? extends java.lang.Short> mappingFunction)
null
.
Note that this version of computeIfAbsent()
should be used only if you plan to return null
in the mapping function.
key
- key with which the specified value is to be associated.mappingFunction
- the function to compute a value.null
.Map.computeIfAbsent(Object, java.util.function.Function)
default short computeIfAbsent(double key, Double2ShortFunction mappingFunction)
This version of computeIfAbsent()
uses a type-specific version of fastutil
's Function
.
Since Function
has a containsKey()
method, it is possible to avoid adding a key by having containsKey()
return false
for that key.
key
- key with which the specified value is to be associated.mappingFunction
- the function to compute a value.Map.computeIfAbsent(Object, java.util.function.Function)
computeIfAbsent()
methods have a different logic based on the argument;
no delegation is performed, contrarily to other superficially similar
methods such as Iterator.forEachRemaining(java.util.function.Consumer<? super E>)
or List.replaceAll(java.util.function.UnaryOperator<E>)
.@Deprecated default short computeIfAbsentPartial(double key, Double2ShortFunction mappingFunction)
computeIfAbsent()
instead.default short computeIfPresent(double key, java.util.function.BiFunction<? super java.lang.Double,? super java.lang.Short,? extends java.lang.Short> remappingFunction)
key
- key with which the specified value is to be associated.remappingFunction
- the function to compute a value.Map.computeIfPresent(Object, java.util.function.BiFunction)
default short compute(double key, java.util.function.BiFunction<? super java.lang.Double,? super java.lang.Short,? extends java.lang.Short> remappingFunction)
null
if there is no current mapping).
If the function returns null
, the mapping is removed (or remains absent if initially absent).
If the function itself throws an (unchecked) exception, the exception is rethrown, and the current mapping is left unchanged.
key
- key with which the specified value is to be associated.remappingFunction
- the function to compute a value.Map.compute(Object, java.util.function.BiFunction)
default short merge(double key, short value, java.util.function.BiFunction<? super java.lang.Short,? super java.lang.Short,? extends java.lang.Short> remappingFunction)
value
.
Otherwise, replaces the associated value with the results of the given remapping function, or removes if the result is null
.key
- key with which the resulting value is to be associated.value
- the value to be merged with the existing value associated with the key or, if no existing value is associated with the key, to be associated with the key.remappingFunction
- the function to recompute a value if present.Map.merge(Object, Object, java.util.function.BiFunction)
default short mergeShort(double key, short value, ShortBinaryOperator remappingFunction)
value
.
Otherwise, replaces the associated value with the results of the given remapping function.key
- key with which the resulting value is to be associated.value
- the value to be merged with the existing value associated with the key or, if no existing value is associated with the key, to be associated with the key.remappingFunction
- the function to recompute a value if present.Map.merge(Object, Object, java.util.function.BiFunction)
null
.default short mergeShort(double key, short value, java.util.function.IntBinaryOperator remappingFunction)
value
.
Otherwise, replaces the associated value with the results of the given remapping function.key
- key with which the resulting value is to be associated.value
- the value to be merged with the existing value associated with the key or, if no existing value is associated with the key, to be associated with the key.remappingFunction
- the function to recompute a value if present.Map.merge(Object, Object, java.util.function.BiFunction)
null
.@Deprecated default java.lang.Short putIfAbsent(java.lang.Double key, java.lang.Short value)
This default implementation just delegates to the corresponding Map
method.
putIfAbsent
in interface java.util.Map<java.lang.Double,java.lang.Short>
@Deprecated default boolean remove(java.lang.Object key, java.lang.Object value)
This default implementation just delegates to the corresponding Map
method.
remove
in interface java.util.Map<java.lang.Double,java.lang.Short>
@Deprecated default boolean replace(java.lang.Double key, java.lang.Short oldValue, java.lang.Short newValue)
This default implementation just delegates to the corresponding Map
method.
replace
in interface java.util.Map<java.lang.Double,java.lang.Short>
@Deprecated default java.lang.Short replace(java.lang.Double key, java.lang.Short value)
This default implementation just delegates to the corresponding Map
method.
replace
in interface java.util.Map<java.lang.Double,java.lang.Short>
@Deprecated default java.lang.Short computeIfAbsent(java.lang.Double key, java.util.function.Function<? super java.lang.Double,? extends java.lang.Short> mappingFunction)
This default implementation just delegates to the corresponding Map
method.
computeIfAbsent
in interface java.util.Map<java.lang.Double,java.lang.Short>
@Deprecated default java.lang.Short computeIfPresent(java.lang.Double key, java.util.function.BiFunction<? super java.lang.Double,? super java.lang.Short,? extends java.lang.Short> remappingFunction)
This default implementation just delegates to the corresponding Map
method.
computeIfPresent
in interface java.util.Map<java.lang.Double,java.lang.Short>
@Deprecated default java.lang.Short compute(java.lang.Double key, java.util.function.BiFunction<? super java.lang.Double,? super java.lang.Short,? extends java.lang.Short> remappingFunction)
This default implementation just delegates to the corresponding Map
method.
compute
in interface java.util.Map<java.lang.Double,java.lang.Short>
@Deprecated default java.lang.Short merge(java.lang.Double key, java.lang.Short value, java.util.function.BiFunction<? super java.lang.Short,? super java.lang.Short,? extends java.lang.Short> remappingFunction)
This default implementation just delegates to the corresponding Map
method.
merge
in interface java.util.Map<java.lang.Double,java.lang.Short>