Object2FloatMap (Primitive-Collections 0.7.0 API)

Type Parameters:

T - the type of elements maintained by this Collection

All Superinterfaces:

java.util.Map<T,java.lang.Float>, Object2FloatFunction<T>

All Known Subinterfaces:

Object2FloatConcurrentMap<T>, Object2FloatNavigableMap<T>, Object2FloatOrderedMap<T>, Object2FloatSortedMap<T>

All Known Implementing Classes:

AbstractObject2FloatMap, Enum2FloatMap, ImmutableObject2FloatOpenHashMap, LinkedEnum2FloatMap, Object2FloatArrayMap, Object2FloatAVLTreeMap, Object2FloatConcurrentOpenHashMap, Object2FloatLinkedOpenCustomHashMap, Object2FloatLinkedOpenHashMap, Object2FloatMaps.EmptyMap, Object2FloatMaps.SingletonMap, Object2FloatMaps.SynchronizedMap, Object2FloatMaps.SynchronizedNavigableMap, Object2FloatMaps.SynchronizedOrderedMap, Object2FloatMaps.SynchronizedSortedMap, Object2FloatMaps.UnmodifyableMap, Object2FloatMaps.UnmodifyableNavigableMap, Object2FloatMaps.UnmodifyableOrderedMap, Object2FloatMaps.UnmodifyableSortedMap, Object2FloatOpenCustomHashMap, Object2FloatOpenHashMap, Object2FloatRBTreeMap
```
public interface Object2FloatMap<T>
extends java.util.Map<T,java.lang.Float>, Object2FloatFunction<T>
```
A Type Specific Map that reduces memory overhead due to boxing/unboxing of Primitives and some extra helper functions.

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static class`	`Object2FloatMap.BuilderCache<T>` Builder Cache for allowing to buildMaps
`static interface`	`Object2FloatMap.Entry<T>` Type Specific Map Entry that reduces boxing/unboxing
`static interface`	`Object2FloatMap.FastEntrySet<T>` Fast Entry set that allows for a faster Entry Iterator by recycling the Entry Object and just exchanging 1 internal value
`static class`	`Object2FloatMap.MapBuilder` Helper class that reduces the method spam of the Map Class.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`float`	`addTo(T key, float value)` A Helper method to add a primitives together.
`void`	`addToAll(Object2FloatMap<T> m)` A Helper method to bulk add primitives together.
`static Object2FloatMap.MapBuilder`	`builder()` Helper Class that allows to create Maps without requiring a to type out the entire implementation or know it.
`default java.lang.Float`	`compute(T key, java.util.function.BiFunction<? super T,? super java.lang.Float,? extends java.lang.Float> mappingFunction)`
`float`	`computeFloat(T key, ObjectFloatUnaryOperator<T> mappingFunction)` A Type Specific compute method to reduce boxing/unboxing
`float`	`computeFloatIfAbsent(T key, Object2FloatFunction<T> mappingFunction)` A Type Specific compute method to reduce boxing/unboxing
`float`	`computeFloatIfPresent(T key, ObjectFloatUnaryOperator<T> mappingFunction)` A Type Specific compute method to reduce boxing/unboxing
`default java.lang.Float`	`computeIfAbsent(T key, java.util.function.Function<? super T,? extends java.lang.Float> mappingFunction)`
`default java.lang.Float`	`computeIfPresent(T key, java.util.function.BiFunction<? super T,? super java.lang.Float,? extends java.lang.Float> mappingFunction)`
`boolean`	`containsValue(float value)` Type Specific method to reduce boxing/unboxing of values
`default boolean`	`containsValue(java.lang.Object value)`
`Object2FloatMap<T>`	`copy()` A Function that does a shallow clone of the Map itself.
`ObjectSet<java.util.Map.Entry<T,java.lang.Float>>`	`entrySet()`
`default void`	`forEach(java.util.function.BiConsumer<? super T,? super java.lang.Float> action)`
`void`	`forEach(ObjectFloatConsumer<T> action)` Type Specific forEach method to reduce boxing/unboxing
`default java.lang.Float`	`get(java.lang.Object key)`
`float`	`getDefaultReturnValue()` Method to see what the default return value is.
`float`	`getFloat(T key)` A Type Specific get method to reduce boxing/unboxing
`default java.lang.Float`	`getOrDefault(java.lang.Object key, java.lang.Float defaultValue)`
`float`	`getOrDefault(T key, float defaultValue)` A Type Specific getOrDefault method to reduce boxing/unboxing
`ObjectSet<T>`	`keySet()`
`default java.lang.Float`	`merge(T key, java.lang.Float value, java.util.function.BiFunction<? super java.lang.Float,? super java.lang.Float,? extends java.lang.Float> mappingFunction)`
`void`	`mergeAllFloat(Object2FloatMap<T> m, FloatFloatUnaryOperator mappingFunction)` A Bulk method for merging Maps.
`float`	`mergeFloat(T key, float value, FloatFloatUnaryOperator mappingFunction)` A Type Specific merge method to reduce boxing/unboxing
`ObjectSet<Object2FloatMap.Entry<T>>`	`object2FloatEntrySet()` Type Sensitive EntrySet to reduce boxing/unboxing and optionally Temp Object Allocation.
`float`	`put(T key, float value)` Type Specific method to reduce boxing/unboxing of values
`default java.lang.Float`	`put(T key, java.lang.Float value)`
`void`	`putAll(Object2FloatMap<T> m)` Type Specific function for the bull putting of values
`default void`	`putAll(T[] keys, float[] values)` Type Specific array method to bulk add elements into a map without creating a wrapper and increasing performances
`default void`	`putAll(T[] keys, java.lang.Float[] values)` Type Specific Object array method to bulk add elements into a map without creating a wrapper and increasing performances
`void`	`putAll(T[] keys, float[] values, int offset, int size)` Type Specific array method to bulk add elements into a map without creating a wrapper and increasing performances
`void`	`putAll(T[] keys, java.lang.Float[] values, int offset, int size)` Type Specific Object array method to bulk add elements into a map without creating a wrapper and increasing performances
`void`	`putAllIfAbsent(Object2FloatMap<T> m)` Type-Specific bulk put method put elements into the map if not present.
`float`	`putIfAbsent(T key, float value)` Type Specific method to reduce boxing/unboxing of values
`default java.lang.Float`	`putIfAbsent(T key, java.lang.Float value)`
`float`	`rem(T key)` Type Specific remove function to reduce boxing/unboxing
`float`	`remOrDefault(T key, float defaultValue)` Type-Specific Remove function with a default return value if wanted.
`default java.lang.Float`	`remove(java.lang.Object key)`
`default boolean`	`remove(java.lang.Object key, java.lang.Object value)`
`boolean`	`remove(T key, float value)` Type Specific remove function to reduce boxing/unboxing
`float`	`replace(T key, float value)` A Type Specific replace method to reduce boxing/unboxing replace an existing value
`default java.lang.Float`	`replace(T key, java.lang.Float value)`
`boolean`	`replace(T key, float oldValue, float newValue)` A Type Specific replace method to replace an existing value
`default boolean`	`replace(T key, java.lang.Float oldValue, java.lang.Float newValue)`
`default void`	`replaceAll(java.util.function.BiFunction<? super T,? super java.lang.Float,? extends java.lang.Float> mappingFunction)`
`void`	`replaceFloats(Object2FloatMap<T> m)` Type-Specific bulk replace method.
`void`	`replaceFloats(ObjectFloatUnaryOperator<T> mappingFunction)` A Type Specific mass replace method to reduce boxing/unboxing
`Object2FloatMap<T>`	`setDefaultReturnValue(float v)` Method to define the default return value if a requested key isn't present
`float`	`subFrom(T key, float value)` A Helper method to subtract from primitive from each other.
`float`	`supplyFloatIfAbsent(T key, FloatSupplier valueProvider)` A Supplier based computeIfAbsent function to fill the most used usecase of this function
`default Object2FloatMap<T>`	`synchronize()` Creates a Wrapped Map that is Synchronized
`default Object2FloatMap<T>`	`synchronize(java.lang.Object mutex)` Creates a Wrapped Map that is Synchronized
`default Object2FloatMap<T>`	`unmodifiable()` Creates a Wrapped Map that is unmodifiable
`FloatCollection`	`values()`

Methods inherited from interface java.util.Map
clear, containsKey, equals, hashCode, isEmpty, putAll, size

- Method Detail
  - builder
```
static Object2FloatMap.MapBuilder builder()
```
    Helper Class that allows to create Maps without requiring a to type out the entire implementation or know it.
    
    Returns:
    
    a MapBuilder
  - getDefaultReturnValue
```
float getDefaultReturnValue()
```
    Method to see what the default return value is.
    
    Returns:
    
    default return value
  - setDefaultReturnValue
```
Object2FloatMap<T> setDefaultReturnValue(float v)
```
    Method to define the default return value if a requested key isn't present
    
    Parameters:
    
    v - value that should be the default return value
    
    Returns:
    
    itself
  - copy
```
Object2FloatMap<T> copy()
```
    A Function that does a shallow clone of the Map itself. This function is more optimized then a copy constructor since the Map does not have to be unsorted/resorted. It can be compared to Cloneable but with less exception risk
    
    Returns:
    
    a Shallow Copy of the Map
    
    Note:
    
    Wrappers and view Maps will not support this feature
  - put
```
float put(T key,
          float value)
```
    Type Specific method to reduce boxing/unboxing of values
    
    Parameters:
    
    key - the key that should be inserted,
    
    value - the value that should be inserted
    
    Returns:
    
    the last present value or default return value.
    
    See Also:
    
    Map.put(Object, Object)
  - putAll
```
default void putAll(T[] keys,
                    float[] values)
```
    Type Specific array method to bulk add elements into a map without creating a wrapper and increasing performances
    
    Parameters:
    
    keys - the keys that should be added
    
    values - the values that should be added
    
    Throws:
    
    java.lang.IllegalStateException - if the arrays are not the same size
    
    See Also:
    
    Map.putAll(Map)
  - putAll
```
void putAll(T[] keys,
            float[] values,
            int offset,
            int size)
```
    Type Specific array method to bulk add elements into a map without creating a wrapper and increasing performances
    
    Parameters:
    
    keys - the keys that should be added
    
    values - the values that should be added
    
    offset - where the to start in the array
    
    size - how many elements should be added
    
    Throws:
    
    java.lang.IllegalStateException - if the arrays are not within the range
    
    See Also:
    
    Map.putAll(Map)
  - putAll
```
default void putAll(T[] keys,
                    java.lang.Float[] values)
```
    Type Specific Object array method to bulk add elements into a map without creating a wrapper and increasing performances
    
    Parameters:
    
    keys - the keys that should be added
    
    values - the values that should be added
    
    Throws:
    
    java.lang.IllegalStateException - if the arrays are not the same size
    
    See Also:
    
    Map.putAll(Map)
  - putAll
```
void putAll(T[] keys,
            java.lang.Float[] values,
            int offset,
            int size)
```
    Type Specific Object array method to bulk add elements into a map without creating a wrapper and increasing performances
    
    Parameters:
    
    keys - the keys that should be added
    
    values - the values that should be added
    
    offset - where the to start in the array
    
    size - how many elements should be added
    
    Throws:
    
    java.lang.IllegalStateException - if the arrays are not within the range
    
    See Also:
    
    Map.putAll(Map)
  - putIfAbsent
```
float putIfAbsent(T key,
                  float value)
```
    Type Specific method to reduce boxing/unboxing of values
    
    Parameters:
    
    key - the key that should be inserted,
    
    value - the value that should be inserted
    
    Returns:
    
    the last present value or default return value.
    
    See Also:
    
    Map.putIfAbsent(Object, Object)
  - putAllIfAbsent
```
void putAllIfAbsent(Object2FloatMap<T> m)
```
    Type-Specific bulk put method put elements into the map if not present.
    
    Parameters:
    
    m - elements that should be added if not present.
  - addTo
```
float addTo(T key,
            float value)
```
    A Helper method to add a primitives together. If key is not present then this functions as a put.
    
    Parameters:
    
    key - the key that should be inserted,
    
    value - the value that should be inserted / added
    
    Returns:
    
    the last present value or default return value.
  - addToAll
```
void addToAll(Object2FloatMap<T> m)
```
    A Helper method to bulk add primitives together.
    
    Parameters:
    
    m - the values that should be added/inserted
  - subFrom
```
float subFrom(T key,
              float value)
```
    A Helper method to subtract from primitive from each other. If the key is not present it will just return the defaultValue How the implementation works is that it will subtract from the current value (if not present it will do nothing) and fence it to the getDefaultReturnValue() If the fence is reached the element will be automaticall removed
    
    Parameters:
    
    key - that should be subtract from
    
    value - that should be subtract
    
    Returns:
    
    the last present or default return value
  - putAll
```
void putAll(Object2FloatMap<T> m)
```
    Type Specific function for the bull putting of values
    
    Parameters:
    
    m - the elements that should be inserted
  - containsValue
```
boolean containsValue(float value)
```
    Type Specific method to reduce boxing/unboxing of values
    
    Parameters:
    
    value - element that is searched for
    
    Returns:
    
    if the value is present
  - containsValue
```
default boolean containsValue(java.lang.Object value)
```
    Specified by:
    
    containsValue in interface java.util.Map<T,java.lang.Float>
    
    Parameters:
    
    value - that is searched for.
    
    Returns:
    
    true if found
    
    See Also:
    
    Map.containsValue(Object)
    
    Note:
    
    in some implementations key does not have to be CLASS_VALUE but just have to support equals with CLASS_VALUE.
  - rem
```
float rem(T key)
```
    Type Specific remove function to reduce boxing/unboxing
    
    Parameters:
    
    key - the element that should be removed
    
    Returns:
    
    the value that was removed or default return value
  - remove
```
default java.lang.Float remove(java.lang.Object key)
```
    Specified by:
    
    remove in interface java.util.Map<T,java.lang.Float>
    
    Parameters:
    
    key - the element that should be removed
    
    Returns:
    
    the value that was removed or default return value
    
    See Also:
    
    Map.remove(Object)
    
    Note:
    
    in some implementations key does not have to be T but just have to support equals with T.
  - remove
```
boolean remove(T key,
               float value)
```
    Type Specific remove function to reduce boxing/unboxing
    
    Parameters:
    
    key - the element that should be removed
    
    value - the expected value that should be found
    
    Returns:
    
    true if the key and value was found and removed
    
    See Also:
    
    Map.remove(Object, Object)
  - remove
```
default boolean remove(java.lang.Object key,
                       java.lang.Object value)
```
    Specified by:
    
    remove in interface java.util.Map<T,java.lang.Float>
    
    Parameters:
    
    key - the element that should be removed
    
    value - the expected value that should be found
    
    Returns:
    
    true if the key and value was found and removed
    
    See Also:
    
    Map.remove(Object, Object)
  - remOrDefault
```
float remOrDefault(T key,
                   float defaultValue)
```
    Type-Specific Remove function with a default return value if wanted.
    
    Parameters:
    
    key - the element that should be removed
    
    defaultValue - the value that should be returned if the entry doesn't exist
    
    Returns:
    
    the value that was removed or default value
    
    See Also:
    
    Map.remove(Object, Object)
  - replace
```
boolean replace(T key,
                float oldValue,
                float newValue)
```
    A Type Specific replace method to replace an existing value
    
    Parameters:
    
    key - the element that should be searched for
    
    oldValue - the expected value to be replaced
    
    newValue - the value to replace the oldValue with.
    
    Returns:
    
    true if the value got replaced
    
    Note:
    
    this fails if the value is not present even if it matches the oldValue
  - replace
```
float replace(T key,
              float value)
```
    A Type Specific replace method to reduce boxing/unboxing replace an existing value
    
    Parameters:
    
    key - the element that should be searched for
    
    value - the value to replace with.
    
    Returns:
    
    the present value or default return value
    
    Note:
    
    this fails if the value is not present
  - replaceFloats
```
void replaceFloats(Object2FloatMap<T> m)
```
    Type-Specific bulk replace method. Could be seen as putAllIfPresent
    
    Parameters:
    
    m - elements that should be replaced.
  - replaceFloats
```
void replaceFloats(ObjectFloatUnaryOperator<T> mappingFunction)
```
    A Type Specific mass replace method to reduce boxing/unboxing
    
    Parameters:
    
    mappingFunction - operation to replace all values
  - computeFloat
```
float computeFloat(T key,
                   ObjectFloatUnaryOperator<T> mappingFunction)
```
    A Type Specific compute method to reduce boxing/unboxing
    
    Parameters:
    
    key - the key that should be computed
    
    mappingFunction - the operator that should generate the value
    
    Returns:
    
    the result of the computation
  - computeFloatIfAbsent
```
float computeFloatIfAbsent(T key,
                           Object2FloatFunction<T> mappingFunction)
```
    A Type Specific compute method to reduce boxing/unboxing
    
    Parameters:
    
    key - the key that should be computed
    
    mappingFunction - the operator that should generate the value if not present
    
    Returns:
    
    the result of the computed value or present value
  - supplyFloatIfAbsent
```
float supplyFloatIfAbsent(T key,
                          FloatSupplier valueProvider)
```
    A Supplier based computeIfAbsent function to fill the most used usecase of this function
    
    Parameters:
    
    key - the key that should be computed
    
    valueProvider - the value if not present
    
    Returns:
    
    the result of the computed value or present value
  - computeFloatIfPresent
```
float computeFloatIfPresent(T key,
                            ObjectFloatUnaryOperator<T> mappingFunction)
```
    A Type Specific compute method to reduce boxing/unboxing
    
    Parameters:
    
    key - the key that should be computed
    
    mappingFunction - the operator that should generate the value if present
    
    Returns:
    
    the result of the default return value or present value
    
    Note:
    
    if not present then compute is not executed
  - mergeFloat
```
float mergeFloat(T key,
                 float value,
                 FloatFloatUnaryOperator mappingFunction)
```
    A Type Specific merge method to reduce boxing/unboxing
    
    Parameters:
    
    key - the key that should be be searched for
    
    value - the value that should be merged with
    
    mappingFunction - the operator that should generate the new Value
    
    Returns:
    
    the result of the merge
    
    Note:
    
    if the result matches the default return value then the key is removed from the map
  - mergeAllFloat
```
void mergeAllFloat(Object2FloatMap<T> m,
                   FloatFloatUnaryOperator mappingFunction)
```
    A Bulk method for merging Maps.
    
    Parameters:
    
    m - the entries that should be bulk added
    
    mappingFunction - the operator that should generate the new Value
    
    Note:
    
    if the result matches the default return value then the key is removed from the map
  - replace
```
default boolean replace(T key,
                        java.lang.Float oldValue,
                        java.lang.Float newValue)
```
    Specified by:
    
    replace in interface java.util.Map<T,java.lang.Float>
  - replace
```
default java.lang.Float replace(T key,
                                java.lang.Float value)
```
    Specified by:
    
    replace in interface java.util.Map<T,java.lang.Float>
  - getFloat
```
float getFloat(T key)
```
    A Type Specific get method to reduce boxing/unboxing
    
    Specified by:
    
    getFloat in interface Object2FloatFunction<T>
    
    Parameters:
    
    key - the key that is searched for
    
    Returns:
    
    the searched value or default return value
  - getOrDefault
```
float getOrDefault(T key,
                   float defaultValue)
```
    A Type Specific getOrDefault method to reduce boxing/unboxing
    
    Parameters:
    
    key - the key that is searched for
    
    defaultValue - the value that should be returned if the key is not present
    
    Returns:
    
    the searched value or defaultValue value
  - get
```
default java.lang.Float get(java.lang.Object key)
```
    Specified by:
    
    get in interface java.util.Map<T,java.lang.Float>
  - getOrDefault
```
default java.lang.Float getOrDefault(java.lang.Object key,
                                     java.lang.Float defaultValue)
```
    Specified by:
    
    getOrDefault in interface java.util.Map<T,java.lang.Float>
  - replaceAll
```
default void replaceAll(java.util.function.BiFunction<? super T,? super java.lang.Float,? extends java.lang.Float> mappingFunction)
```
    Specified by:
    
    replaceAll in interface java.util.Map<T,java.lang.Float>
  - compute
```
default java.lang.Float compute(T key,
                                java.util.function.BiFunction<? super T,? super java.lang.Float,? extends java.lang.Float> mappingFunction)
```
    Specified by:
    
    compute in interface java.util.Map<T,java.lang.Float>
  - computeIfAbsent
```
default java.lang.Float computeIfAbsent(T key,
                                        java.util.function.Function<? super T,? extends java.lang.Float> mappingFunction)
```
    Specified by:
    
    computeIfAbsent in interface java.util.Map<T,java.lang.Float>
  - computeIfPresent
```
default java.lang.Float computeIfPresent(T key,
                                         java.util.function.BiFunction<? super T,? super java.lang.Float,? extends java.lang.Float> mappingFunction)
```
    Specified by:
    
    computeIfPresent in interface java.util.Map<T,java.lang.Float>
  - merge
```
default java.lang.Float merge(T key,
                              java.lang.Float value,
                              java.util.function.BiFunction<? super java.lang.Float,? super java.lang.Float,? extends java.lang.Float> mappingFunction)
```
    Specified by:
    
    merge in interface java.util.Map<T,java.lang.Float>
  - forEach
```
void forEach(ObjectFloatConsumer<T> action)
```
    Type Specific forEach method to reduce boxing/unboxing
    
    Parameters:
    
    action - processor of the values that are iterator over
  - forEach
```
default void forEach(java.util.function.BiConsumer<? super T,? super java.lang.Float> action)
```
    Specified by:
    
    forEach in interface java.util.Map<T,java.lang.Float>
  - keySet
```
ObjectSet<T> keySet()
```
    Specified by:
    
    keySet in interface java.util.Map<T,java.lang.Float>
  - values
```
FloatCollection values()
```
    Specified by:
    
    values in interface java.util.Map<T,java.lang.Float>
  - entrySet
```
ObjectSet<java.util.Map.Entry<T,java.lang.Float>> entrySet()
```
    Specified by:
    
    entrySet in interface java.util.Map<T,java.lang.Float>
  - object2FloatEntrySet
```
ObjectSet<Object2FloatMap.Entry<T>> object2FloatEntrySet()
```
    Type Sensitive EntrySet to reduce boxing/unboxing and optionally Temp Object Allocation.
    
    Returns:
    
    a EntrySet of the collection
  - synchronize
```
default Object2FloatMap<T> synchronize()
```
    Creates a Wrapped Map that is Synchronized
    
    Returns:
    
    a new Map that is synchronized
    
    See Also:
    
    Object2FloatMaps.synchronize(speiger.src.collections.objects.maps.interfaces.Object2FloatMap<T>)
  - synchronize
```
default Object2FloatMap<T> synchronize(java.lang.Object mutex)
```
    Creates a Wrapped Map that is Synchronized
    
    Parameters:
    
    mutex - is the controller of the synchronization block
    
    Returns:
    
    a new Map Wrapper that is synchronized
    
    See Also:
    
    Object2FloatMaps.synchronize(speiger.src.collections.objects.maps.interfaces.Object2FloatMap<T>)
  - unmodifiable
```
default Object2FloatMap<T> unmodifiable()
```
    Creates a Wrapped Map that is unmodifiable
    
    Returns:
    
    a new Map Wrapper that is unmodifiable
    
    See Also:
    
    Object2FloatMaps.unmodifiable(speiger.src.collections.objects.maps.interfaces.Object2FloatMap<T>)
  - put
```
default java.lang.Float put(T key,
                            java.lang.Float value)
```
    Specified by:
    
    put in interface java.util.Map<T,java.lang.Float>
  - putIfAbsent
```
default java.lang.Float putIfAbsent(T key,
                                    java.lang.Float value)
```
    Specified by:
    
    putIfAbsent in interface java.util.Map<T,java.lang.Float>

Interface Object2FloatMap<T>

Nested Class Summary

Method Summary

Methods inherited from interface java.util.Map

Method Detail

builder

getDefaultReturnValue

setDefaultReturnValue

copy

put

putAll

putAll

putAll

putAll

putIfAbsent

putAllIfAbsent

addTo

addToAll

subFrom

putAll

containsValue

containsValue

rem

remove

remove

remove

remOrDefault

replace

replace

replaceFloats

replaceFloats

computeFloat

computeFloatIfAbsent

supplyFloatIfAbsent

computeFloatIfPresent

mergeFloat

mergeAllFloat

replace

replace

getFloat

getOrDefault

get

getOrDefault

replaceAll

compute

computeIfAbsent

computeIfPresent

merge

forEach

forEach

keySet

values

entrySet

object2FloatEntrySet

synchronize

synchronize

unmodifiable

put

putIfAbsent