Class Int2FloatLinkedOpenHashMap

All Implemented Interfaces:
it.unimi.dsi.fastutil.Function<Integer,Float>, it.unimi.dsi.fastutil.Hash, it.unimi.dsi.fastutil.ints.Int2FloatFunction, Int2FloatMap, Int2FloatSortedMap, Serializable, Cloneable, Function<Integer,Float>, IntToDoubleFunction, Map<Integer,Float>, SequencedMap<Integer,Float>, SortedMap<Integer,Float>

public class Int2FloatLinkedOpenHashMap extends AbstractInt2FloatSortedMap implements Serializable, Cloneable, it.unimi.dsi.fastutil.Hash
A type-specific linked hash map with with a fast, small-footprint implementation.

Instances of this class use a hash table to represent a map. The table is filled up to a specified load factor, and then doubled in size to accommodate new entries. If the table is emptied below one fourth of the load factor, it is halved in size; however, the table is never reduced to a size smaller than that at creation time: this approach makes it possible to create maps with a large capacity in which insertions and deletions do not cause immediately rehashing. Moreover, halving is not performed when deleting entries from an iterator, as it would interfere with the iteration process.

Note that clear() does not modify the hash table size. Rather, a family of trimming methods lets you control the size of the table; this is particularly useful if you reuse instances of this class.

Entries returned by the type-specific Int2FloatMap.entrySet() method implement the suitable type-specific Pair interface; only values are mutable.

Iterators generated by this map will enumerate pairs in the same order in which they have been added to the map (addition of pairs whose key is already present in the map does not change the iteration order). Note that this order has nothing in common with the natural order of the keys. The order is kept by means of a doubly linked list, represented via an array of longs parallel to the table.

This class implements the interface of a sorted map, so to allow easy access of the iteration order: for instance, you can get the first key in iteration order with firstKey() without having to create an iterator; however, this class partially violates the SortedMap contract because all submap methods throw an exception and comparator() returns always null.

Additional methods, such as getAndMoveToFirst(), make it easy to use instances of this class as a cache (e.g., with LRU policy).

The iterators provided by the views of this class using are type-specific list iterators, and can be started at any element which is a key of the map, or a NoSuchElementException exception will be thrown. If, however, the provided element is not the first or last key in the map, the first access to the list index will require linear time, as in the worst case the entire key set must be scanned in iteration order to retrieve the positional index of the starting key. If you use just the methods of a type-specific BidirectionalIterator, however, all operations will be performed in constant time.

See Also:
  • Nested Class Summary

    Nested classes/interfaces inherited from class it.unimi.dsi.fastutil.ints.AbstractInt2FloatMap

    AbstractInt2FloatMap.BasicEntry, AbstractInt2FloatMap.BasicEntrySet

    Nested classes/interfaces inherited from interface it.unimi.dsi.fastutil.Hash

    it.unimi.dsi.fastutil.Hash.Strategy<K>

    Nested classes/interfaces inherited from interface it.unimi.dsi.fastutil.ints.Int2FloatMap

    Int2FloatMap.Entry, Int2FloatMap.FastEntrySet

    Nested classes/interfaces inherited from interface it.unimi.dsi.fastutil.ints.Int2FloatSortedMap

    Int2FloatSortedMap.FastSortedEntrySet

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

    Map.Entry<K,V>
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    protected boolean
    Whether this map contains the key zero.
    Cached set of entries.
    protected final float
    The acceptable load factor.
    protected int
    The index of the first entry in iteration order.
    protected int[]
    The array of keys.
    protected it.unimi.dsi.fastutil.ints.IntSortedSet
    Cached set of keys.
    protected int
    The index of the last entry in iteration order.
    protected long[]
    For each entry, the next and the previous entry in iteration order, stored as ((prev & 0xFFFFFFFFL) << 32) | (next & 0xFFFFFFFFL).
    protected int
    The mask for wrapping a position counter.
    protected int
    Threshold after which we rehash.
    protected final int
    We never resize below this threshold, which is the construction-time {#n}.
    protected int
    The current table size.
    protected int
    Number of entries in the set (including the key zero, if present).
    protected float[]
    The array of values.
    protected it.unimi.dsi.fastutil.floats.FloatCollection
    Cached collection of values.

    Fields inherited from class it.unimi.dsi.fastutil.ints.AbstractInt2FloatFunction

    defRetValue

    Fields inherited from interface it.unimi.dsi.fastutil.Hash

    DEFAULT_GROWTH_FACTOR, DEFAULT_INITIAL_SIZE, DEFAULT_LOAD_FACTOR, FAST_LOAD_FACTOR, FREE, OCCUPIED, PRIMES, REMOVED, VERY_FAST_LOAD_FACTOR
  • Constructor Summary

    Constructors
    Constructor
    Description
    Creates a new hash map with initial expected Hash.DEFAULT_INITIAL_SIZE entries and Hash.DEFAULT_LOAD_FACTOR as load factor.
    Creates a new hash map with Hash.DEFAULT_LOAD_FACTOR as load factor.
    Int2FloatLinkedOpenHashMap(int[] k, float[] v)
    Creates a new hash map with Hash.DEFAULT_LOAD_FACTOR as load factor using the elements of two parallel arrays.
    Int2FloatLinkedOpenHashMap(int[] k, float[] v, float f)
    Creates a new hash map using the elements of two parallel arrays.
    Int2FloatLinkedOpenHashMap(int expected, float f)
    Creates a new hash map.
    Creates a new hash map with Hash.DEFAULT_LOAD_FACTOR as load factor copying a given type-specific one.
    Creates a new hash map copying a given type-specific one.
    Int2FloatLinkedOpenHashMap(Map<? extends Integer,? extends Float> m)
    Creates a new hash map with Hash.DEFAULT_LOAD_FACTOR as load factor copying a given one.
    Int2FloatLinkedOpenHashMap(Map<? extends Integer,? extends Float> m, float f)
    Creates a new hash map copying a given one.
  • Method Summary

    Modifier and Type
    Method
    Description
    float
    addTo(int k, float incr)
    Adds an increment to value currently associated with a key.
    void
    Removes all of the mappings from this map (optional operation).
    Returns a deep copy of this map.
    it.unimi.dsi.fastutil.ints.IntComparator
    Returns the comparator associated with this sorted set, or null if it uses its keys' natural ordering.
    float
    compute(int k, BiFunction<? super Integer,? super Float,? extends Float> remappingFunction)
    Attempts to compute a mapping for the specified key and its current mapped value (or null if there is no current mapping).
    float
    computeIfAbsent(int key, it.unimi.dsi.fastutil.ints.Int2FloatFunction 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.
    float
    computeIfAbsent(int k, IntToDoubleFunction 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.
    float
    computeIfAbsentNullable(int k, IntFunction<? extends Float> 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.
    float
    computeIfPresent(int k, BiFunction<? super Integer,? super Float,? extends Float> remappingFunction)
    If the value for the specified key is present, attempts to compute a new mapping given the key and its current mapped value.
    boolean
    containsKey(int k)
    Returns true if this function contains a mapping for the specified key.
    boolean
    containsValue(float v)
    Returns true if this map maps one or more keys to the specified value.
    void
    ensureCapacity(int capacity)
    Ensures that this map can hold a certain number of keys without rehashing.
    int
    Returns the first key of this map in iteration order.
    protected void
    fixPointers(int i)
    Modifies the link vector so that the given entry is removed.
    protected void
    fixPointers(int s, int d)
    Modifies the link vector for a shift from s to d.
    float
    get(int k)
     
    float
    Returns the value to which the given key is mapped; if the key is present, it is moved to the first position of the iteration order.
    float
    Returns the value to which the given key is mapped; if the key is present, it is moved to the last position of the iteration order.
    float
    getOrDefault(int k, float defaultValue)
    Returns the value to which the specified key is mapped, or the defaultValue if this map contains no mapping for the key.
    int
    Returns a hash code for this map.
    headMap(int to)
    Returns a view of the portion of this sorted map whose keys are strictly less than toKey.
    Returns a type-specific sorted-set view of the mappings contained in this map.
    boolean
     
    it.unimi.dsi.fastutil.ints.IntSortedSet
    Returns a type-specific-set view of the keys of this map.
    int
    Returns the last key of this map in iteration order.
    float
    merge(int k, float v, BiFunction<? super Float,? super Float,? extends Float> remappingFunction)
    If the specified key is not already associated with a value, associates it with the given value.
    float
    mergeFloat(int k, float v, it.unimi.dsi.fastutil.floats.FloatBinaryOperator remappingFunction)
    If the specified key is not already associated with a value, associates it with the given value.
    float
    put(int k, float v)
     
    void
    putAll(Map<? extends Integer,? extends Float> m)
    float
    putAndMoveToFirst(int k, float v)
    Adds a pair to the map; if the key is already present, it is moved to the first position of the iteration order.
    float
    putAndMoveToLast(int k, float v)
    Adds a pair to the map; if the key is already present, it is moved to the last position of the iteration order.
    float
    putIfAbsent(int k, float v)
    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.
    protected void
    rehash(int newN)
    Rehashes the map.
    float
    remove(int k)
     
    boolean
    remove(int k, float v)
    Removes the entry for the specified key only if it is currently mapped to the specified value.
    float
    Removes the mapping associated with the first key in iteration order.
    float
    Removes the mapping associated with the last key in iteration order.
    float
    replace(int k, float v)
    Replaces the entry for the specified key only if it is currently mapped to some value.
    boolean
    replace(int k, float oldValue, float v)
    Replaces the entry for the specified key only if currently mapped to the specified value.
    protected final void
    shiftKeys(int pos)
    Shifts left entries with the specified hash code, starting at the specified position, and empties the resulting free entry.
    int
    Returns the number of key/value mappings in this map.
    subMap(int from, int to)
    Returns a view of the portion of this sorted map whose keys range from fromKey, inclusive, to toKey, exclusive.
    tailMap(int from)
    Returns a view of the portion of this sorted map whose keys are greater than or equal to fromKey.
    boolean
    Rehashes the map, making the table as small as possible.
    boolean
    trim(int n)
    Rehashes this map if the table is too large.
    it.unimi.dsi.fastutil.floats.FloatCollection
    Returns a type-specific-set view of the values of this map.

    Methods inherited from class it.unimi.dsi.fastutil.ints.AbstractInt2FloatMap

    equals, toString

    Methods inherited from class it.unimi.dsi.fastutil.ints.AbstractInt2FloatFunction

    defaultReturnValue, defaultReturnValue

    Methods inherited from class java.lang.Object

    finalize, getClass, notify, notifyAll, wait, wait, wait

    Methods inherited from interface it.unimi.dsi.fastutil.Function

    apply

    Methods inherited from interface it.unimi.dsi.fastutil.ints.Int2FloatFunction

    andThen, andThenByte, andThenChar, andThenDouble, andThenFloat, andThenInt, andThenLong, andThenObject, andThenReference, andThenShort, applyAsDouble, compose, composeByte, composeChar, composeDouble, composeFloat, composeInt, composeLong, composeObject, composeReference, composeShort

    Methods inherited from interface it.unimi.dsi.fastutil.ints.Int2FloatSortedMap

    entrySet, firstKey, headMap, lastKey, subMap, tailMap

    Methods inherited from interface java.util.Map

    containsKey, equals, get, getOrDefault, put, remove, replaceAll

    Methods inherited from interface java.util.SortedMap

    putFirst, putLast, reversed
  • Field Details

    • key

      protected transient int[] key
      The array of keys.
    • value

      protected transient float[] value
      The array of values.
    • mask

      protected transient int mask
      The mask for wrapping a position counter.
    • containsNullKey

      protected transient boolean containsNullKey
      Whether this map contains the key zero.
    • first

      protected transient int first
      The index of the first entry in iteration order. It is valid iff size is nonzero; otherwise, it contains -1.
    • last

      protected transient int last
      The index of the last entry in iteration order. It is valid iff size is nonzero; otherwise, it contains -1.
    • n

      protected transient int n
      The current table size.
    • maxFill

      protected transient int maxFill
      Threshold after which we rehash. It must be the table size times f.
    • minN

      protected final transient int minN
      We never resize below this threshold, which is the construction-time {#n}.
    • size

      protected int size
      Number of entries in the set (including the key zero, if present).
    • f

      protected final float f
      The acceptable load factor.
    • entries

      protected transient Int2FloatSortedMap.FastSortedEntrySet entries
      Cached set of entries.
    • keys

      protected transient it.unimi.dsi.fastutil.ints.IntSortedSet keys
      Cached set of keys.
    • values

      protected transient it.unimi.dsi.fastutil.floats.FloatCollection values
      Cached collection of values.
  • Constructor Details

    • Int2FloatLinkedOpenHashMap

      public Int2FloatLinkedOpenHashMap(int expected, float f)
      Creates a new hash map.

      The actual table size will be the least power of two greater than expected/f.

      Parameters:
      expected - the expected number of elements in the hash map.
      f - the load factor.
    • Int2FloatLinkedOpenHashMap

      public Int2FloatLinkedOpenHashMap(int expected)
      Creates a new hash map with Hash.DEFAULT_LOAD_FACTOR as load factor.
      Parameters:
      expected - the expected number of elements in the hash map.
    • Int2FloatLinkedOpenHashMap

      public Int2FloatLinkedOpenHashMap()
      Creates a new hash map with initial expected Hash.DEFAULT_INITIAL_SIZE entries and Hash.DEFAULT_LOAD_FACTOR as load factor.
    • Int2FloatLinkedOpenHashMap

      public Int2FloatLinkedOpenHashMap(Map<? extends Integer,? extends Float> m, float f)
      Creates a new hash map copying a given one.
      Parameters:
      m - a Map to be copied into the new hash map.
      f - the load factor.
    • Int2FloatLinkedOpenHashMap

      public Int2FloatLinkedOpenHashMap(Map<? extends Integer,? extends Float> m)
      Creates a new hash map with Hash.DEFAULT_LOAD_FACTOR as load factor copying a given one.
      Parameters:
      m - a Map to be copied into the new hash map.
    • Int2FloatLinkedOpenHashMap

      public Int2FloatLinkedOpenHashMap(Int2FloatMap m, float f)
      Creates a new hash map copying a given type-specific one.
      Parameters:
      m - a type-specific map to be copied into the new hash map.
      f - the load factor.
    • Int2FloatLinkedOpenHashMap

      public Int2FloatLinkedOpenHashMap(Int2FloatMap m)
      Creates a new hash map with Hash.DEFAULT_LOAD_FACTOR as load factor copying a given type-specific one.
      Parameters:
      m - a type-specific map to be copied into the new hash map.
    • Int2FloatLinkedOpenHashMap

      public Int2FloatLinkedOpenHashMap(int[] k, float[] v, float f)
      Creates a new hash map using the elements of two parallel arrays.
      Parameters:
      k - the array of keys of the new hash map.
      v - the array of corresponding values in the new hash map.
      f - the load factor.
      Throws:
      IllegalArgumentException - if k and v have different lengths.
    • Int2FloatLinkedOpenHashMap

      public Int2FloatLinkedOpenHashMap(int[] k, float[] v)
      Creates a new hash map with Hash.DEFAULT_LOAD_FACTOR as load factor using the elements of two parallel arrays.
      Parameters:
      k - the array of keys of the new hash map.
      v - the array of corresponding values in the new hash map.
      Throws:
      IllegalArgumentException - if k and v have different lengths.
  • Method Details

    • ensureCapacity

      public void ensureCapacity(int capacity)
      Ensures that this map can hold a certain number of keys without rehashing.
      Parameters:
      capacity - a number of keys; there will be no rehashing unless the map size exceeds this number.
    • putAll

      public void putAll(Map<? extends Integer,? extends Float> m)
      Description copied from class: AbstractInt2FloatMap
      Specified by:
      putAll in interface Map<Integer,Float>
      Overrides:
      putAll in class AbstractInt2FloatMap
    • put

      public float put(int k, float v)
      Specified by:
      put in interface it.unimi.dsi.fastutil.ints.Int2FloatFunction
    • addTo

      public float addTo(int k, float 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.
    • shiftKeys

      protected final void shiftKeys(int pos)
      Shifts left entries with the specified hash code, starting at the specified position, and empties the resulting free entry.
      Parameters:
      pos - a starting position.
    • remove

      public float remove(int k)
      Specified by:
      remove in interface it.unimi.dsi.fastutil.ints.Int2FloatFunction
    • removeFirstFloat

      public float removeFirstFloat()
      Removes the mapping associated with the first key in iteration order.
      Returns:
      the value previously associated with the first key in iteration order.
      Throws:
      NoSuchElementException - is this map is empty.
    • removeLastFloat

      public float removeLastFloat()
      Removes the mapping associated with the last key in iteration order.
      Returns:
      the value previously associated with the last key in iteration order.
      Throws:
      NoSuchElementException - is this map is empty.
    • getAndMoveToFirst

      public float getAndMoveToFirst(int k)
      Returns the value to which the given key is mapped; if the key is present, it is moved to the first position of the iteration order.
      Parameters:
      k - the key.
      Returns:
      the corresponding value, or the default return value if no value was present for the given key.
    • getAndMoveToLast

      public float getAndMoveToLast(int k)
      Returns the value to which the given key is mapped; if the key is present, it is moved to the last position of the iteration order.
      Parameters:
      k - the key.
      Returns:
      the corresponding value, or the default return value if no value was present for the given key.
    • putAndMoveToFirst

      public float putAndMoveToFirst(int k, float v)
      Adds a pair to the map; if the key is already present, it is moved to the first position of the iteration order.
      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.
    • putAndMoveToLast

      public float putAndMoveToLast(int k, float v)
      Adds a pair to the map; if the key is already present, it is moved to the last position of the iteration order.
      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.
    • get

      public float get(int k)
      Specified by:
      get in interface it.unimi.dsi.fastutil.ints.Int2FloatFunction
    • containsKey

      public boolean containsKey(int k)
      Description copied from class: AbstractInt2FloatMap
      Returns true if this function contains a mapping for the specified key.
      Specified by:
      containsKey in interface it.unimi.dsi.fastutil.ints.Int2FloatFunction
      Specified by:
      containsKey in interface Int2FloatMap
      Overrides:
      containsKey in class AbstractInt2FloatMap
      Parameters:
      k - the key.
      Returns:
      true if this function associates a value to key.
      See Also:
    • containsValue

      public boolean containsValue(float v)
      Description copied from class: AbstractInt2FloatMap
      Returns true if this map maps one or more keys to the specified value.
      Specified by:
      containsValue in interface Int2FloatMap
      Overrides:
      containsValue in class AbstractInt2FloatMap
      See Also:
    • getOrDefault

      public float getOrDefault(int k, float defaultValue)
      Returns the value to which the specified key is mapped, or the defaultValue if this map contains no mapping for the key.
      Specified by:
      getOrDefault in interface it.unimi.dsi.fastutil.ints.Int2FloatFunction
      Specified by:
      getOrDefault in interface Int2FloatMap
      Parameters:
      k - the key.
      defaultValue - the default mapping of the key.
      Returns:
      the value to which the specified key is mapped, or the defaultValue if this map contains no mapping for the key.
      See Also:
    • putIfAbsent

      public float putIfAbsent(int k, float v)
      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.
      Specified by:
      putIfAbsent in interface Int2FloatMap
      Parameters:
      k - key with which the specified value is to be associated.
      v - value to be associated with the specified key.
      Returns:
      the previous value associated with the specified key, or the default return value if there was no mapping for the key.
      See Also:
    • remove

      public boolean remove(int k, float v)
      Removes the entry for the specified key only if it is currently mapped to the specified value.
      Specified by:
      remove in interface Int2FloatMap
      Parameters:
      k - key with which the specified value is associated.
      v - value expected to be associated with the specified key.
      Returns:
      true if the value was removed.
      See Also:
    • replace

      public boolean replace(int k, float oldValue, float v)
      Replaces the entry for the specified key only if currently mapped to the specified value.
      Specified by:
      replace in interface Int2FloatMap
      Parameters:
      k - key with which the specified value is associated.
      oldValue - value expected to be associated with the specified key.
      v - value to be associated with the specified key.
      Returns:
      true if the value was replaced.
      See Also:
    • replace

      public float replace(int k, float v)
      Replaces the entry for the specified key only if it is currently mapped to some value.
      Specified by:
      replace in interface Int2FloatMap
      Parameters:
      k - key with which the specified value is associated.
      v - value to be associated with the specified key.
      Returns:
      the previous value associated with the specified key, or the default return value if there was no mapping for the key.
      See Also:
    • computeIfAbsent

      public float computeIfAbsent(int k, IntToDoubleFunction 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.

      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.

      Specified by:
      computeIfAbsent in interface Int2FloatMap
      Parameters:
      k - key with which the specified value is to be associated.
      mappingFunction - the function to compute a value.
      Returns:
      the current (existing or computed) value associated with the specified key.
      See Also:
    • computeIfAbsent

      public float computeIfAbsent(int key, it.unimi.dsi.fastutil.ints.Int2FloatFunction 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.

      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.

      Specified by:
      computeIfAbsent in interface Int2FloatMap
      Parameters:
      key - key with which the specified value is to be associated.
      mappingFunction - the function to compute a value.
      Returns:
      the current (existing or computed) value associated with the specified key.
      See Also:
    • computeIfAbsentNullable

      public float computeIfAbsentNullable(int k, IntFunction<? extends Float> 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.

      Note that this version of computeIfAbsent() should be used only if you plan to return null in the mapping function.

      Specified by:
      computeIfAbsentNullable in interface Int2FloatMap
      Parameters:
      k - key with which the specified value is to be associated.
      mappingFunction - the function to compute a value.
      Returns:
      the current (existing or computed) value associated with the specified key, or the default return value if the computed value is null.
      See Also:
    • computeIfPresent

      public float computeIfPresent(int k, BiFunction<? super Integer,? super Float,? extends Float> remappingFunction)
      If the value for the specified key is present, attempts to compute a new mapping given the key and its current mapped value.
      Specified by:
      computeIfPresent in interface Int2FloatMap
      Parameters:
      k - key with which the specified value is to be associated.
      remappingFunction - the function to compute a value.
      Returns:
      the new value associated with the specified key, or the default return value if none.
      See Also:
    • compute

      public float compute(int k, BiFunction<? super Integer,? super Float,? extends Float> remappingFunction)
      Attempts to compute a mapping for the specified key and its current mapped value (or 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.

      Specified by:
      compute in interface Int2FloatMap
      Parameters:
      k - key with which the specified value is to be associated.
      remappingFunction - the function to compute a value.
      Returns:
      the new value associated with the specified key, or the default return value if none.
      See Also:
    • mergeFloat

      public float mergeFloat(int k, float v, it.unimi.dsi.fastutil.floats.FloatBinaryOperator remappingFunction)
      If the specified key is not already associated with a value, associates it with the given value. Otherwise, replaces the associated value with the results of the given remapping function.
      Specified by:
      mergeFloat in interface Int2FloatMap
      Parameters:
      k - key with which the resulting value is to be associated.
      v - 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.
      Returns:
      the new value associated with the specified key.
      See Also:
    • merge

      public float merge(int k, float v, BiFunction<? super Float,? super Float,? extends Float> remappingFunction)
      If the specified key is not already associated with a value, associates it with the given value. Otherwise, replaces the associated value with the results of the given remapping function, or removes if the result is null.
      Specified by:
      merge in interface Int2FloatMap
      Parameters:
      k - key with which the resulting value is to be associated.
      v - 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.
      Returns:
      the new value associated with the specified key, or the default return value if no value is associated with the key.
      See Also:
    • clear

      public void clear()
      Description copied from interface: Int2FloatMap
      Removes all of the mappings from this map (optional operation). The map will be empty after this call returns.
      Specified by:
      clear in interface it.unimi.dsi.fastutil.Function<Integer,Float>
      Specified by:
      clear in interface Int2FloatMap
      Specified by:
      clear in interface Map<Integer,Float>
    • size

      public int size()
      Description copied from interface: Int2FloatMap
      Returns the number of key/value mappings in this map. If the map contains more than Integer.MAX_VALUE elements, returns Integer.MAX_VALUE.
      Specified by:
      size in interface it.unimi.dsi.fastutil.Function<Integer,Float>
      Specified by:
      size in interface Int2FloatMap
      Specified by:
      size in interface Map<Integer,Float>
      Returns:
      the number of key-value mappings in this map.
      See Also:
      • Size64
    • isEmpty

      public boolean isEmpty()
      Specified by:
      isEmpty in interface Map<Integer,Float>
      Overrides:
      isEmpty in class AbstractInt2FloatMap
    • fixPointers

      protected void fixPointers(int i)
      Modifies the link vector so that the given entry is removed. This method will complete in constant time.
      Parameters:
      i - the index of an entry.
    • fixPointers

      protected void fixPointers(int s, int d)
      Modifies the link vector for a shift from s to d.

      This method will complete in constant time.

      Parameters:
      s - the source position.
      d - the destination position.
    • firstIntKey

      public int firstIntKey()
      Returns the first key of this map in iteration order.
      Specified by:
      firstIntKey in interface Int2FloatSortedMap
      Returns:
      the first key in iteration order.
      See Also:
    • lastIntKey

      public int lastIntKey()
      Returns the last key of this map in iteration order.
      Specified by:
      lastIntKey in interface Int2FloatSortedMap
      Returns:
      the last key in iteration order.
      See Also:
    • tailMap

      public Int2FloatSortedMap tailMap(int from)
      Returns a view of the portion of this sorted map whose keys are greater than or equal to fromKey.
      Specified by:
      tailMap in interface Int2FloatSortedMap
      See Also:
    • headMap

      public Int2FloatSortedMap headMap(int to)
      Returns a view of the portion of this sorted map whose keys are strictly less than toKey.
      Specified by:
      headMap in interface Int2FloatSortedMap
      See Also:
    • subMap

      public Int2FloatSortedMap subMap(int from, int to)
      Returns a view of the portion of this sorted map whose keys range from fromKey, inclusive, to toKey, exclusive.
      Specified by:
      subMap in interface Int2FloatSortedMap
      See Also:
    • comparator

      public it.unimi.dsi.fastutil.ints.IntComparator comparator()
      Returns the comparator associated with this sorted set, or null if it uses its keys' natural ordering.
      Specified by:
      comparator in interface Int2FloatSortedMap
      Specified by:
      comparator in interface SortedMap<Integer,Float>
      See Also:
    • int2FloatEntrySet

      public Int2FloatSortedMap.FastSortedEntrySet int2FloatEntrySet()
      Description copied from interface: Int2FloatSortedMap
      Returns a type-specific sorted-set view of the mappings contained in this map.
      Specified by:
      int2FloatEntrySet in interface Int2FloatMap
      Specified by:
      int2FloatEntrySet in interface Int2FloatSortedMap
      Returns:
      a type-specific sorted-set view of the mappings contained in this map.
      See Also:
    • keySet

      public it.unimi.dsi.fastutil.ints.IntSortedSet keySet()
      Description copied from class: AbstractInt2FloatSortedMap
      Returns a type-specific-set view of the keys of this map.

      The view is backed by the set returned by Map.entrySet(). Note that no attempt is made at caching the result of this method, as this would require adding some attributes that lightweight implementations would not need. Subclasses may easily override this policy by calling this method and caching the result, but implementors are encouraged to write more efficient ad-hoc implementations.

      The view is backed by the sorted set returned by Map.entrySet(). Note that no attempt is made at caching the result of this method, as this would require adding some attributes that lightweight implementations would not need. Subclasses may easily override this policy by calling this method and caching the result, but implementors are encouraged to write more efficient ad-hoc implementations.

      Specified by:
      keySet in interface Int2FloatMap
      Specified by:
      keySet in interface Int2FloatSortedMap
      Specified by:
      keySet in interface Map<Integer,Float>
      Specified by:
      keySet in interface SortedMap<Integer,Float>
      Overrides:
      keySet in class AbstractInt2FloatSortedMap
      Returns:
      a sorted set view of the keys of this map; it may be safely cast to a type-specific interface.
      See Also:
    • values

      public it.unimi.dsi.fastutil.floats.FloatCollection values()
      Description copied from class: AbstractInt2FloatSortedMap
      Returns a type-specific-set view of the values of this map.

      The view is backed by the set returned by Map.entrySet(). Note that no attempt is made at caching the result of this method, as this would require adding some attributes that lightweight implementations would not need. Subclasses may easily override this policy by calling this method and caching the result, but implementors are encouraged to write more efficient ad-hoc implementations.

      The view is backed by the sorted set returned by Map.entrySet(). Note that no attempt is made at caching the result of this method, as this would require adding some attributes that lightweight implementations would not need. Subclasses may easily override this policy by calling this method and caching the result, but implementors are encouraged to write more efficient ad-hoc implementations.

      Specified by:
      values in interface Int2FloatMap
      Specified by:
      values in interface Int2FloatSortedMap
      Specified by:
      values in interface Map<Integer,Float>
      Specified by:
      values in interface SortedMap<Integer,Float>
      Overrides:
      values in class AbstractInt2FloatSortedMap
      Returns:
      a type-specific collection view of the values contained in this map.
      See Also:
    • trim

      public boolean trim()
      Rehashes the map, making the table as small as possible.

      This method rehashes the table to the smallest size satisfying the load factor. It can be used when the set will not be changed anymore, so to optimize access speed and size.

      If the table size is already the minimum possible, this method does nothing.

      Returns:
      true if there was enough memory to trim the map.
      See Also:
    • trim

      public boolean trim(int n)
      Rehashes this map if the table is too large.

      Let N be the smallest table size that can hold max(n,size()) entries, still satisfying the load factor. If the current table size is smaller than or equal to N, this method does nothing. Otherwise, it rehashes this map in a table of size N.

      This method is useful when reusing maps. Clearing a map leaves the table size untouched. If you are reusing a map many times, you can call this method with a typical size to avoid keeping around a very large table just because of a few large transient maps.

      Parameters:
      n - the threshold for the trimming.
      Returns:
      true if there was enough memory to trim the map.
      See Also:
    • rehash

      protected void rehash(int newN)
      Rehashes the map.

      This method implements the basic rehashing strategy, and may be overridden by subclasses implementing different rehashing strategies (e.g., disk-based rehashing). However, you should not override this method unless you understand the internal workings of this class.

      Parameters:
      newN - the new size
    • clone

      Returns a deep copy of this map.

      This method performs a deep copy of this hash map; the data stored in the map, however, is not cloned. Note that this makes a difference only for object keys.

      Overrides:
      clone in class Object
      Returns:
      a deep copy of this map.
    • hashCode

      public int hashCode()
      Returns a hash code for this map. This method overrides the generic method provided by the superclass. Since equals() is not overriden, it is important that the value returned by this method is the same value as the one returned by the overriden method.
      Specified by:
      hashCode in interface Map<Integer,Float>
      Overrides:
      hashCode in class AbstractInt2FloatMap
      Returns:
      a hash code for this map.