@FunctionalInterface public interface Long2IntFunction extends Function<java.lang.Long,java.lang.Integer>, java.util.function.LongToIntFunction
Function
; provides some additional methods that use polymorphism to avoid (un)boxing.
Type-specific versions of get()
, put()
and
remove()
cannot rely on null
to denote absence of
a key. Rather, they return a default
return value, which is set to 0/false at creation, but can be changed using
the defaultReturnValue()
method.
For uniformity reasons, even functions returning objects implement the default
return value (of course, in this case the default return value is
initialized to null
).
The default implementation of optional operations just throw an UnsupportedOperationException
, except for the type-specific containsKey()
, which return true. Generic versions of accessors delegate to
the corresponding type-specific counterparts following the interface rules.
Warning: to fall in line as much as possible with the
standard map interface, it is required that
standard versions of get()
, put()
and
remove()
for maps with primitive-type keys or values return
null
to denote missing keys rather than wrap the default
return value in an object. In case both keys and values are reference
types, the default return value must be returned instead, thus violating
the standard map interface when the default
return value is not null
.
Function
Modifier and Type | Method and Description |
---|---|
default <T> java.util.function.Function<java.lang.Long,T> |
andThen(java.util.function.Function<? super java.lang.Integer,? extends T> after)
Deprecated.
Please use the corresponding type-specific method instead.
|
default Long2ByteFunction |
andThenByte(Int2ByteFunction after) |
default Long2CharFunction |
andThenChar(Int2CharFunction after) |
default Long2DoubleFunction |
andThenDouble(Int2DoubleFunction after) |
default Long2FloatFunction |
andThenFloat(Int2FloatFunction after) |
default Long2IntFunction |
andThenInt(Int2IntFunction after) |
default Long2LongFunction |
andThenLong(Int2LongFunction after) |
default <T> Long2ObjectFunction<T> |
andThenObject(Int2ObjectFunction<? extends T> after) |
default <T> Long2ReferenceFunction<T> |
andThenReference(Int2ReferenceFunction<? extends T> after) |
default Long2ShortFunction |
andThenShort(Int2ShortFunction after) |
default int |
applyAsInt(long operand) |
default <T> java.util.function.Function<T,java.lang.Integer> |
compose(java.util.function.Function<? super T,? extends java.lang.Long> before)
Deprecated.
Please use the corresponding type-specific method instead.
|
default Byte2IntFunction |
composeByte(Byte2LongFunction before) |
default Char2IntFunction |
composeChar(Char2LongFunction before) |
default Double2IntFunction |
composeDouble(Double2LongFunction before) |
default Float2IntFunction |
composeFloat(Float2LongFunction before) |
default Int2IntFunction |
composeInt(Int2LongFunction before) |
default Long2IntFunction |
composeLong(Long2LongFunction before) |
default <T> Object2IntFunction<T> |
composeObject(Object2LongFunction<? super T> before) |
default <T> Reference2IntFunction<T> |
composeReference(Reference2LongFunction<? super T> before) |
default Short2IntFunction |
composeShort(Short2LongFunction before) |
default boolean |
containsKey(long 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 int |
defaultReturnValue()
Gets the default return value.
|
default void |
defaultReturnValue(int rv)
Sets the default return value (optional operation).
|
int |
get(long key)
Returns the value to which the given key is mapped.
|
default java.lang.Integer |
get(java.lang.Object key)
Deprecated.
Please use the corresponding type-specific method instead.
|
default int |
getOrDefault(long key,
int defaultValue)
Returns the value associated by this function to the specified key, or give the specified
value if not present.
|
default java.lang.Integer |
getOrDefault(java.lang.Object key,
java.lang.Integer defaultValue)
Deprecated.
Please use the corresponding type-specific method instead.
|
default int |
put(long key,
int value)
Adds a pair to the map (optional operation).
|
default java.lang.Integer |
put(java.lang.Long key,
java.lang.Integer value)
Deprecated.
Please use the corresponding type-specific method instead.
|
default int |
remove(long key)
Removes the mapping with the given key (optional operation).
|
default java.lang.Integer |
remove(java.lang.Object key)
Deprecated.
Please use the corresponding type-specific method instead.
|
default int applyAsInt(long operand)
applyAsInt
in interface java.util.function.LongToIntFunction
default int put(long key, int value)
key
- the key.value
- the value.Function.put(Object,Object)
int get(long key)
key
- the key.Function.get(Object)
default int getOrDefault(long key, int defaultValue)
key
- the key.defaultValue
- the value to return if not present.defaultValue
if no value was present for the given key.Function.getOrDefault(Object, Object)
default int remove(long key)
key
- the key.Function.remove(Object)
@Deprecated default java.lang.Integer put(java.lang.Long key, java.lang.Integer value)
key
- the key.value
- the value.null
if no value was present for the given key.Map.put(Object,Object)
@Deprecated default java.lang.Integer get(java.lang.Object key)
key
- the key.null
if no value was present for the given key.Map.get(Object)
@Deprecated default java.lang.Integer getOrDefault(java.lang.Object key, java.lang.Integer defaultValue)
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)
@Deprecated default java.lang.Integer remove(java.lang.Object key)
key
- the key.null
if no value was present for the given key.Map.remove(Object)
default boolean containsKey(long key)
Note that for some kind of functions (e.g., hashes) this method will always return true. In particular, this default implementation always returns true.
key
- the key.key
.Function.containsKey(Object)
@Deprecated default boolean containsKey(java.lang.Object key)
Note that for some kind of functions (e.g., hashes) this method will always return true. This default implementation, in particular, always return true.
key
- the key.key
.Map.containsKey(Object)
default void defaultReturnValue(int rv)
get()
, put()
and remove()
to
denote that the map does not contain the specified key. It must be
0/false
/null
by default.rv
- the new default return value.defaultReturnValue()
default int defaultReturnValue()
This default implementation just return the default null value
of the type (null
for objects, 0 for scalars, false for Booleans).
@Deprecated default <T> java.util.function.Function<T,java.lang.Integer> compose(java.util.function.Function<? super T,? extends java.lang.Long> before)
compose
in interface java.util.function.Function<java.lang.Long,java.lang.Integer>
@Deprecated default <T> java.util.function.Function<java.lang.Long,T> andThen(java.util.function.Function<? super java.lang.Integer,? extends T> after)
andThen
in interface java.util.function.Function<java.lang.Long,java.lang.Integer>
default Long2ByteFunction andThenByte(Int2ByteFunction after)
default Byte2IntFunction composeByte(Byte2LongFunction before)
default Long2ShortFunction andThenShort(Int2ShortFunction after)
default Short2IntFunction composeShort(Short2LongFunction before)
default Long2IntFunction andThenInt(Int2IntFunction after)
default Int2IntFunction composeInt(Int2LongFunction before)
default Long2LongFunction andThenLong(Int2LongFunction after)
default Long2IntFunction composeLong(Long2LongFunction before)
default Long2CharFunction andThenChar(Int2CharFunction after)
default Char2IntFunction composeChar(Char2LongFunction before)
default Long2FloatFunction andThenFloat(Int2FloatFunction after)
default Float2IntFunction composeFloat(Float2LongFunction before)
default Long2DoubleFunction andThenDouble(Int2DoubleFunction after)
default Double2IntFunction composeDouble(Double2LongFunction before)
default <T> Long2ObjectFunction<T> andThenObject(Int2ObjectFunction<? extends T> after)
default <T> Object2IntFunction<T> composeObject(Object2LongFunction<? super T> before)
default <T> Long2ReferenceFunction<T> andThenReference(Int2ReferenceFunction<? extends T> after)
default <T> Reference2IntFunction<T> composeReference(Reference2LongFunction<? super T> before)