Long2LongHashMap (Agrona)

java.lang.Object
- org.agrona.collections.Long2LongHashMap

All Implemented Interfaces:

Map<Long,Long>
```
public class Long2LongHashMap
extends Object
implements Map<Long,Long>
```
An open-addressing with linear probing hash map specialised for primitive key and value pairs.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`class`	`Long2LongHashMap.EntryIterator` Iterator over entries which supports access to unboxed keys and values.
`class`	`Long2LongHashMap.EntrySet` Set of entries which supports optionally cached iterators to avoid allocation.
`class`	`Long2LongHashMap.KeyIterator` Iterator over keys which supports access to unboxed keys via `Long2LongHashMap.KeyIterator.nextValue()`.
`class`	`Long2LongHashMap.KeySet` Set of keys which supports optional cached iterators to avoid allocation.
`class`	`Long2LongHashMap.ValueCollection` Collection of values which supports optionally cached iterators to avoid allocation.
`class`	`Long2LongHashMap.ValueIterator` Iterator over values which supports access to unboxed values.

Nested classes/interfaces inherited from interface java.util.Map
Map.Entry<K,V>

Constructor Summary

Constructors
Constructor and Description
`Long2LongHashMap(int initialCapacity, float loadFactor, long missingValue)`
`Long2LongHashMap(int initialCapacity, float loadFactor, long missingValue, boolean shouldAvoidAllocation)`
`Long2LongHashMap(long missingValue)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`capacity()` Get the total capacity for the map to which the load factor will be a fraction of.
`void`	`clear()`
`void`	`compact()` Compact the backing arrays by rehashing with a capacity just larger than current size and giving consideration to the load factor.
`long`	`compute(long key, LongBinaryOperator remappingFunction)` Primitive specialised version of `Map.compute(K, java.util.function.BiFunction<? super K, ? super V, ? extends V>)`.
`long`	`computeIfAbsent(long key, LongUnaryOperator mappingFunction)` Primitive specialised version of `Map.computeIfAbsent(Object, Function)`.
`long`	`computeIfPresent(long key, LongBinaryOperator remappingFunction)` Primitive specialised version of `Map.computeIfPresent(K, java.util.function.BiFunction<? super K, ? super V, ? extends V>)`.
`boolean`	`containsKey(long key)` Long primitive specialised containsKey.
`boolean`	`containsKey(Object key)`
`boolean`	`containsValue(long value)` Does the map contain the value.
`boolean`	`containsValue(Object value)`
`Long2LongHashMap.EntrySet`	`entrySet()`
`boolean`	`equals(Object o)`
`void`	`forEach(BiConsumer<? super Long,? super Long> action)`
`long`	`get(long key)` Get a value using provided key avoiding boxing.
`Long`	`get(Object key)`
`int`	`hashCode()`
`boolean`	`isEmpty()`
`Long2LongHashMap.KeySet`	`keySet()`
`float`	`loadFactor()` Get the load factor applied for resize operations.
`void`	`longForEach(LongLongConsumer consumer)` Primitive specialised forEach implementation.
`long`	`maxValue()` Get the maximum value stored in the map.
`long`	`minValue()` Get the minimum value stored in the map.
`long`	`missingValue()` The value to be used as a null marker in the map.
`long`	`put(long key, long value)` Put a key value pair in the map.
`Long`	`put(Long key, Long value)`
`void`	`putAll(Map<? extends Long,? extends Long> map)`
`long`	`remove(long key)` Remove value from the map using given key avoiding boxing.
`Long`	`remove(Object key)`
`long`	`replace(long key, long value)` Primitive specialised version of `Map.replace(Object, Object)`.
`boolean`	`replace(long key, long oldValue, long newValue)` Primitive specialised version of `Map.replace(Object, Object, Object)`.
`int`	`resizeThreshold()` Get the actual threshold which when reached the map will resize.
`int`	`size()`
`String`	`toString()`
`Long2LongHashMap.ValueCollection`	`values()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

- Constructor Detail
  - Long2LongHashMap
```
public Long2LongHashMap(long missingValue)
```
    Parameters:
    
    missingValue - for the map that represents null.
  - Long2LongHashMap
```
public Long2LongHashMap(int initialCapacity,
                        float loadFactor,
                        long missingValue)
```
    Parameters:
    
    initialCapacity - for the map to override MIN_CAPACITY
    
    loadFactor - for the map to override Hashing.DEFAULT_LOAD_FACTOR.
    
    missingValue - for the map that represents null.
  - Long2LongHashMap
```
public Long2LongHashMap(int initialCapacity,
                        float loadFactor,
                        long missingValue,
                        boolean shouldAvoidAllocation)
```
    Parameters:
    
    initialCapacity - for the map to override MIN_CAPACITY
    
    loadFactor - for the map to override Hashing.DEFAULT_LOAD_FACTOR.
    
    missingValue - for the map that represents null.
    
    shouldAvoidAllocation - should allocation be avoided by caching iterators and map entries.
- Method Detail
  - missingValue
```
public long missingValue()
```
    The value to be used as a null marker in the map.
    
    Returns:
    
    value to be used as a null marker in the map.
  - loadFactor
```
public float loadFactor()
```
    Get the load factor applied for resize operations.
    
    Returns:
    
    the load factor applied for resize operations.
  - capacity
```
public int capacity()
```
    Get the total capacity for the map to which the load factor will be a fraction of.
    
    Returns:
    
    the total capacity for the map.
  - resizeThreshold
```
public int resizeThreshold()
```
    Get the actual threshold which when reached the map will resize. This is a function of the current capacity and load factor.
    
    Returns:
    
    the threshold when the map will resize.
  - size
```
public int size()
```
    Specified by:
    
    size in interface Map<Long,Long>
  - isEmpty
```
public boolean isEmpty()
```
    Specified by:
    
    isEmpty in interface Map<Long,Long>
  - get
```
public long get(long key)
```
    Get a value using provided key avoiding boxing.
    
    Parameters:
    
    key - lookup key.
    
    Returns:
    
    value associated with the key or missingValue() if key is not found in the map.
  - put
```
public long put(long key,
                long value)
```
    Put a key value pair in the map.
    
    Parameters:
    
    key - lookup key
    
    value - new value, must not be missingValue()
    
    Returns:
    
    previous value associated with the key, or missingValue() if none found
    
    Throws:
    
    IllegalArgumentException - if value is missingValue()
  - longForEach
```
public void longForEach(LongLongConsumer consumer)
```
    Primitive specialised forEach implementation.
    NB: Renamed from forEach to avoid overloading on parameter types of lambda expression, which doesn't play well with type inference in lambda expressions.
    
    Parameters:
    
    consumer - a callback called for each key/value pair in the map.
  - containsKey
```
public boolean containsKey(long key)
```
    Long primitive specialised containsKey.
    
    Parameters:
    
    key - the key to check.
    
    Returns:
    
    true if the map contains key as a key, false otherwise.
  - containsValue
```
public boolean containsValue(long value)
```
    Does the map contain the value.
    
    Parameters:
    
    value - to be tested against contained values.
    
    Returns:
    
    true if contained otherwise value.
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface Map<Long,Long>
  - compact
```
public void compact()
```
    Compact the backing arrays by rehashing with a capacity just larger than current size and giving consideration to the load factor.
  - computeIfAbsent
```
public long computeIfAbsent(long key,
                            LongUnaryOperator mappingFunction)
```
    Primitive specialised version of Map.computeIfAbsent(Object, Function).
    
    Parameters:
    
    key - to search on.
    
    mappingFunction - to provide a value if the get returns null.
    
    Returns:
    
    the value if found otherwise the missing value.
  - computeIfPresent
```
public long computeIfPresent(long key,
                             LongBinaryOperator remappingFunction)
```
    Primitive specialised version of Map.computeIfPresent(K, java.util.function.BiFunction<? super K, ? super V, ? extends V>).
    
    Parameters:
    
    key - to search on.
    
    remappingFunction - to compute a value if a mapping is found.
    
    Returns:
    
    the updated value if a mapping was found, otherwise the missing value.
  - compute
```
public long compute(long key,
                    LongBinaryOperator remappingFunction)
```
    Primitive specialised version of Map.compute(K, java.util.function.BiFunction<? super K, ? super V, ? extends V>).
    
    Parameters:
    
    key - to search on.
    
    remappingFunction - to compute a value.
    
    Returns:
    
    the updated value.
  - get
```
public Long get(Object key)
```
    Specified by:
    
    get in interface Map<Long,Long>
  - put
```
public Long put(Long key,
                Long value)
```
    Specified by:
    
    put in interface Map<Long,Long>
  - forEach
```
public void forEach(BiConsumer<? super Long,? super Long> action)
```
    Specified by:
    
    forEach in interface Map<Long,Long>
  - containsKey
```
public boolean containsKey(Object key)
```
    Specified by:
    
    containsKey in interface Map<Long,Long>
  - containsValue
```
public boolean containsValue(Object value)
```
    Specified by:
    
    containsValue in interface Map<Long,Long>
  - putAll
```
public void putAll(Map<? extends Long,? extends Long> map)
```
    Specified by:
    
    putAll in interface Map<Long,Long>
  - keySet
```
public Long2LongHashMap.KeySet keySet()
```
    Specified by:
    
    keySet in interface Map<Long,Long>
  - values
```
public Long2LongHashMap.ValueCollection values()
```
    Specified by:
    
    values in interface Map<Long,Long>
  - entrySet
```
public Long2LongHashMap.EntrySet entrySet()
```
    Specified by:
    
    entrySet in interface Map<Long,Long>
  - remove
```
public Long remove(Object key)
```
    Specified by:
    
    remove in interface Map<Long,Long>
  - remove
```
public long remove(long key)
```
    Remove value from the map using given key avoiding boxing.
    
    Parameters:
    
    key - whose mapping is to be removed from the map.
    
    Returns:
    
    removed value or missingValue() if key was not found in the map.
  - minValue
```
public long minValue()
```
    Get the minimum value stored in the map. If the map is empty then it will return missingValue().
    
    Returns:
    
    the minimum value stored in the map.
  - maxValue
```
public long maxValue()
```
    Get the maximum value stored in the map. If the map is empty then it will return missingValue().
    
    Returns:
    
    the maximum value stored in the map.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - replace
```
public long replace(long key,
                    long value)
```
    Primitive specialised version of Map.replace(Object, Object).
    
    Parameters:
    
    key - key with which the specified value is associated.
    
    value - value to be associated with the specified key.
    
    Returns:
    
    the previous value associated with the specified key, or missingValue() if there was no mapping for the key.
  - replace
```
public boolean replace(long key,
                       long oldValue,
                       long newValue)
```
    Primitive specialised version of Map.replace(Object, Object, Object).
    
    Parameters:
    
    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.
    
    Returns:
    
    true if the value was replaced.
  - equals
```
public boolean equals(Object o)
```
    Specified by:
    
    equals in interface Map<Long,Long>
    
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Specified by:
    
    hashCode in interface Map<Long,Long>
    
    Overrides:
    
    hashCode in class Object

Class Long2LongHashMap

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

Constructor Detail

Long2LongHashMap

Long2LongHashMap

Long2LongHashMap

Method Detail

missingValue

loadFactor

capacity

resizeThreshold

size

isEmpty

get

put

longForEach

containsKey

containsValue

clear

compact

computeIfAbsent

computeIfPresent

compute

get

put

forEach

containsKey

containsValue

putAll

keySet

values

entrySet

remove

remove

minValue

maxValue

toString

replace

replace

equals

hashCode