com.koloboke.collect.map.hash

Class HashObjObjMaps

Object

com.koloboke.collect.map.hash.HashObjObjMaps

public final class HashObjObjMaps
extends Object

This class consists only of static factory methods to construct HashObjObjMaps, and the default HashObjObjMapFactory static provider (getDefaultFactory()).

See Also:

HashObjObjMap, @KolobokeMap

Method Summary

Modifier and Type	Method and Description
static <K,V> HashObjObjMapFactory<K,V>	getDefaultFactory() Returns the default HashObjObjMapFactory implementation, to which all static methods in this class delegate.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Consumer<BiConsumer<K,V>> entriesSupplier) Constructs a new immutable map filled with mappings consumed by the callback within the given closure.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Consumer<BiConsumer<K,V>> entriesSupplier, int expectedSize) Constructs a new immutable map filled with mappings consumed by the callback within the given closure.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Iterable<? extends K> keys, Iterable<? extends V> values) Constructs a new immutable map with the given mappings, i.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Iterable<? extends K> keys, Iterable<? extends V> values, int expectedSize) Constructs a new immutable map with the given mappings, i.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(K[] keys, V[] values) Constructs a new immutable map with the given mappings, i.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(K[] keys, V[] values, int expectedSize) Constructs a new immutable map with the given mappings, i.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Map<? extends K,? extends V> map) Constructs a new immutable map with the same mappings as the specified map.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Map<? extends K,? extends V> map, int expectedSize) Constructs a new immutable map with the same mappings as the specified map.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2) Constructs a new immutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, int expectedSize) Constructs a new immutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3) Constructs a new immutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, int expectedSize) Constructs a new immutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, Map<? extends K,? extends V> map4) Constructs a new immutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, Map<? extends K,? extends V> map4, int expectedSize) Constructs a new immutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, Map<? extends K,? extends V> map4, Map<? extends K,? extends V> map5) Constructs a new immutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newImmutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, Map<? extends K,? extends V> map4, Map<? extends K,? extends V> map5, int expectedSize) Constructs a new immutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newImmutableMapOf(K k1, V v1) Constructs a new immutable map of the single specified mapping.
static <K,V> HashObjObjMap<K,V>	newImmutableMapOf(K k1, V v1, K k2, V v2) Constructs a new immutable map of the two specified mappings.
static <K,V> HashObjObjMap<K,V>	newImmutableMapOf(K k1, V v1, K k2, V v2, K k3, V v3) Constructs a new immutable map of the three specified mappings.
static <K,V> HashObjObjMap<K,V>	newImmutableMapOf(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4) Constructs a new immutable map of the four specified mappings.
static <K,V> HashObjObjMap<K,V>	newImmutableMapOf(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5) Constructs a new immutable map of the five specified mappings.
static <K,V> HashObjObjMap<K,V>	newMutableMap() Constructs a new empty mutable map of the default expected size.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Consumer<BiConsumer<K,V>> entriesSupplier) Constructs a new mutable map filled with mappings consumed by the callback within the given closure.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Consumer<BiConsumer<K,V>> entriesSupplier, int expectedSize) Constructs a new mutable map filled with mappings consumed by the callback within the given closure.
static <K,V> HashObjObjMap<K,V>	newMutableMap(int expectedSize) Constructs a new empty mutable map of the given expected size.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Iterable<? extends K> keys, Iterable<? extends V> values) Constructs a new mutable map with the given mappings, i.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Iterable<? extends K> keys, Iterable<? extends V> values, int expectedSize) Constructs a new mutable map with the given mappings, i.
static <K,V> HashObjObjMap<K,V>	newMutableMap(K[] keys, V[] values) Constructs a new mutable map with the given mappings, i.
static <K,V> HashObjObjMap<K,V>	newMutableMap(K[] keys, V[] values, int expectedSize) Constructs a new mutable map with the given mappings, i.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Map<? extends K,? extends V> map) Constructs a new mutable map with the same mappings as the specified map.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Map<? extends K,? extends V> map, int expectedSize) Constructs a new mutable map with the same mappings as the specified map.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2) Constructs a new mutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, int expectedSize) Constructs a new mutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3) Constructs a new mutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, int expectedSize) Constructs a new mutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, Map<? extends K,? extends V> map4) Constructs a new mutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, Map<? extends K,? extends V> map4, int expectedSize) Constructs a new mutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, Map<? extends K,? extends V> map4, Map<? extends K,? extends V> map5) Constructs a new mutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newMutableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, Map<? extends K,? extends V> map4, Map<? extends K,? extends V> map5, int expectedSize) Constructs a new mutable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newMutableMapOf(K k1, V v1) Constructs a new mutable map of the single specified mapping.
static <K,V> HashObjObjMap<K,V>	newMutableMapOf(K k1, V v1, K k2, V v2) Constructs a new mutable map of the two specified mappings.
static <K,V> HashObjObjMap<K,V>	newMutableMapOf(K k1, V v1, K k2, V v2, K k3, V v3) Constructs a new mutable map of the three specified mappings.
static <K,V> HashObjObjMap<K,V>	newMutableMapOf(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4) Constructs a new mutable map of the four specified mappings.
static <K,V> HashObjObjMap<K,V>	newMutableMapOf(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5) Constructs a new mutable map of the five specified mappings.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap() Constructs a new empty updatable map of the default expected size.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Consumer<BiConsumer<K,V>> entriesSupplier) Constructs a new updatable map filled with mappings consumed by the callback within the given closure.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Consumer<BiConsumer<K,V>> entriesSupplier, int expectedSize) Constructs a new updatable map filled with mappings consumed by the callback within the given closure.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(int expectedSize) Constructs a new empty updatable map of the given expected size.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Iterable<? extends K> keys, Iterable<? extends V> values) Constructs a new updatable map with the given mappings, i.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Iterable<? extends K> keys, Iterable<? extends V> values, int expectedSize) Constructs a new updatable map with the given mappings, i.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(K[] keys, V[] values) Constructs a new updatable map with the given mappings, i.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(K[] keys, V[] values, int expectedSize) Constructs a new updatable map with the given mappings, i.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Map<? extends K,? extends V> map) Constructs a new updatable map with the same mappings as the specified map.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Map<? extends K,? extends V> map, int expectedSize) Constructs a new updatable map with the same mappings as the specified map.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2) Constructs a new updatable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, int expectedSize) Constructs a new updatable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3) Constructs a new updatable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, int expectedSize) Constructs a new updatable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, Map<? extends K,? extends V> map4) Constructs a new updatable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, Map<? extends K,? extends V> map4, int expectedSize) Constructs a new updatable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, Map<? extends K,? extends V> map4, Map<? extends K,? extends V> map5) Constructs a new updatable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newUpdatableMap(Map<? extends K,? extends V> map1, Map<? extends K,? extends V> map2, Map<? extends K,? extends V> map3, Map<? extends K,? extends V> map4, Map<? extends K,? extends V> map5, int expectedSize) Constructs a new updatable map which merge the mappings of the specified maps.
static <K,V> HashObjObjMap<K,V>	newUpdatableMapOf(K k1, V v1) Constructs a new updatable map of the single specified mapping.
static <K,V> HashObjObjMap<K,V>	newUpdatableMapOf(K k1, V v1, K k2, V v2) Constructs a new updatable map of the two specified mappings.
static <K,V> HashObjObjMap<K,V>	newUpdatableMapOf(K k1, V v1, K k2, V v2, K k3, V v3) Constructs a new updatable map of the three specified mappings.
static <K,V> HashObjObjMap<K,V>	newUpdatableMapOf(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4) Constructs a new updatable map of the four specified mappings.
static <K,V> HashObjObjMap<K,V>	newUpdatableMapOf(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5) Constructs a new updatable map of the five specified mappings.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getDefaultFactory

@Nonnull
public static <K,V> HashObjObjMapFactory<K,V> getDefaultFactory()

Returns the default HashObjObjMapFactory implementation, to which all static methods in this class delegate.

Type Parameters:

K - the most general key type of the maps that could be constructed by the returned factory

V - the most general value type of the maps that could be constructed by the returned factory

Returns:

the default HashObjObjMapFactory implementation

Throws:

RuntimeException - if no implementations of HashObjObjMapFactory are provided

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap()

Constructs a new empty mutable map of the default expected size.

This method simply delegates to getDefaultFactory().newMutableMap().

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Returns:

a new empty mutable map

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(int expectedSize)

Constructs a new empty mutable map of the given expected size.

This method simply delegates to getDefaultFactory().newMutableMap(expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

expectedSize - the expected size of the returned map

Returns:

a new empty mutable map of the given expected size

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Map<? extends K,? extends V> map,
                                                               int expectedSize)

Constructs a new mutable map with the same mappings as the specified map.

If the specified map is an instance of ObjObjMap and has the same key equivalence with this factory (and thus the constructed map), the expectedSize argument is ignored.

This method simply delegates to getDefaultFactory().newMutableMap(map, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map - the map whose mappings are to be placed in the returned map

expectedSize - the expected size of the returned map

Returns:

a new mutable map with the same mappings as the specified map

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Map<? extends K,? extends V> map1,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map2,
                                                               int expectedSize)

Constructs a new mutable map which merge the mappings of the specified maps. On conflict, mappings from the map2 have priority over mappings from the map1 with the same keys.

This method simply delegates to getDefaultFactory().newMutableMap(map1, map2, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

expectedSize - the expected size of the returned map

Returns:

a new mutable map which merge the mappings of the specified maps

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Map<? extends K,? extends V> map1,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map2,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map3,
                                                               int expectedSize)

Constructs a new mutable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newMutableMap(map1, map2, map3, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

expectedSize - the expected size of the returned map

Returns:

a new mutable map which merge the mappings of the specified maps

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Map<? extends K,? extends V> map1,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map2,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map3,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map4,
                                                               int expectedSize)

Constructs a new mutable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newMutableMap(map1, map2, map3, map4, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

map4 - the fourth map to merge

expectedSize - the expected size of the returned map

Returns:

a new mutable map which merge the mappings of the specified maps

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Map<? extends K,? extends V> map1,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map2,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map3,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map4,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map5,
                                                               int expectedSize)

Constructs a new mutable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newMutableMap(map1, map2, map3, map4, map5, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

map4 - the fourth map to merge

map5 - the fifth map to merge

expectedSize - the expected size of the returned map

Returns:

a new mutable map which merge the mappings of the specified maps

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Consumer<BiConsumer<K,V>> entriesSupplier,
                                                               int expectedSize)

Constructs a new mutable map filled with mappings consumed by the callback within the given closure. Mappings supplied later within the closure have priority over the mappings passed earlier with the same keys.

Example: TODO

This method simply delegates to getDefaultFactory().newMutableMap(entriesSupplier, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

entriesSupplier - the function which supply mappings for the returned map via the callback passed in

expectedSize - the expected size of the returned map

Returns:

a new mutable map with mappings consumed by the callback within the given closure

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               K[] keys,
                                                               @Nonnull
                                                               V[] values,
                                                               int expectedSize)

Constructs a new mutable map with the given mappings, i. e. pairs of elements from the keys and values arrays at the same index. If keys array have duplicate elements, value corresponding the key with the highest index is left in the returned map.

This method simply delegates to getDefaultFactory().newMutableMap(keys, values, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

keys - the keys of the returned map

values - the values of the returned map, each value is associated with the element of the keys array at the same index

expectedSize - the expected size of the returned map

Returns:

a new mutable map with the given mappings

Throws:

IllegalArgumentException - if keys and values arrays have different length

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Iterable<? extends K> keys,
                                                               @Nonnull
                                                               Iterable<? extends V> values,
                                                               int expectedSize)

Constructs a new mutable map with the given mappings, i. e. pairs of elements from the keys and values iterables at the same iteration position. If keys have duplicate elements, value corresponding the key appeared last in the iteration is left in the returned map.

This method simply delegates to getDefaultFactory().newMutableMap(keys, values, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

keys - the keys of the returned map

values - the values of the returned map, each value is associated with the element of the keys iterable at the same iteration position

expectedSize - the expected size of the returned map

Returns:

a new mutable map with the given mappings

Throws:

IllegalArgumentException - if keys and values have different size

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Map<? extends K,? extends V> map)

Constructs a new mutable map with the same mappings as the specified map.

This method simply delegates to getDefaultFactory().newMutableMap(map).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map - the map whose mappings are to be placed in the returned map

Returns:

a new mutable map with the same mappings as the specified map

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Map<? extends K,? extends V> map1,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map2)

Constructs a new mutable map which merge the mappings of the specified maps. On conflict, mappings from the map2 have priority over mappings from the map1 with the same keys.

This method simply delegates to getDefaultFactory().newMutableMap(map1, map2).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

Returns:

a new mutable map which merge the mappings of the specified maps

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Map<? extends K,? extends V> map1,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map2,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map3)

Constructs a new mutable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newMutableMap(map1, map2, map3).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

Returns:

a new mutable map which merge the mappings of the specified maps

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Map<? extends K,? extends V> map1,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map2,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map3,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map4)

Constructs a new mutable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newMutableMap(map1, map2, map3, map4).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

map4 - the fourth map to merge

Returns:

a new mutable map which merge the mappings of the specified maps

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Map<? extends K,? extends V> map1,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map2,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map3,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map4,
                                                               @Nonnull
                                                               Map<? extends K,? extends V> map5)

Constructs a new mutable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newMutableMap(map1, map2, map3, map4, map5).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

map4 - the fourth map to merge

map5 - the fifth map to merge

Returns:

a new mutable map which merge the mappings of the specified maps

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Consumer<BiConsumer<K,V>> entriesSupplier)

Constructs a new mutable map filled with mappings consumed by the callback within the given closure. Mappings supplied later within the closure have priority over the mappings passed earlier with the same keys.

Example: TODO

This method simply delegates to getDefaultFactory().newMutableMap(entriesSupplier).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

entriesSupplier - the function which supply mappings for the returned map via the callback passed in

Returns:

a new mutable map with mappings consumed by the callback within the given closure

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               K[] keys,
                                                               @Nonnull
                                                               V[] values)

Constructs a new mutable map with the given mappings, i. e. pairs of elements from the keys and values arrays at the same index. If keys array have duplicate elements, value corresponding the key with the highest index is left in the returned map.

This method simply delegates to getDefaultFactory().newMutableMap(keys, values).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

keys - the keys of the returned map

values - the values of the returned map, each value is associated with the element of the keys array at the same index

Returns:

a new mutable map with the given mappings

Throws:

IllegalArgumentException - if keys and values arrays have different length

newMutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMap(@Nonnull
                                                               Iterable<? extends K> keys,
                                                               @Nonnull
                                                               Iterable<? extends V> values)

Constructs a new mutable map with the given mappings, i. e. pairs of elements from the keys and values iterables at the same iteration position. If keys have duplicate elements, value corresponding the key appeared last in the iteration is left in the returned map.

This method simply delegates to getDefaultFactory().newMutableMap(keys, values).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

keys - the keys of the returned map

values - the values of the returned map, each value is associated with the element of the keys iterable at the same iteration position

Returns:

a new mutable map with the given mappings

Throws:

IllegalArgumentException - if keys and values have different size

newMutableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMapOf(K k1,
                                                                 V v1)

Constructs a new mutable map of the single specified mapping.

This method simply delegates to getDefaultFactory().newMutableMapOf(k1, v1).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the sole mapping

v1 - the value of the sole mapping

Returns:

a new mutable map of the single specified mapping

newMutableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMapOf(K k1,
                                                                 V v1,
                                                                 K k2,
                                                                 V v2)

Constructs a new mutable map of the two specified mappings.

This method simply delegates to getDefaultFactory().newMutableMapOf(k1, v1, k2, v2).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the first mapping

v1 - the value of the first mapping

k2 - the key of the second mapping

v2 - the value of the second mapping

Returns:

a new mutable map of the two specified mappings

newMutableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMapOf(K k1,
                                                                 V v1,
                                                                 K k2,
                                                                 V v2,
                                                                 K k3,
                                                                 V v3)

Constructs a new mutable map of the three specified mappings.

This method simply delegates to getDefaultFactory().newMutableMapOf(k1, v1, k2, v2, k3, v3).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the first mapping

v1 - the value of the first mapping

k2 - the key of the second mapping

v2 - the value of the second mapping

k3 - the key of the third mapping

v3 - the value of the third mapping

Returns:

a new mutable map of the three specified mappings

newMutableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMapOf(K k1,
                                                                 V v1,
                                                                 K k2,
                                                                 V v2,
                                                                 K k3,
                                                                 V v3,
                                                                 K k4,
                                                                 V v4)

Constructs a new mutable map of the four specified mappings.

This method simply delegates to getDefaultFactory().newMutableMapOf(k1, v1, k2, v2, k3, v3, k4, v4).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the first mapping

v1 - the value of the first mapping

k2 - the key of the second mapping

v2 - the value of the second mapping

k3 - the key of the third mapping

v3 - the value of the third mapping

k4 - the key of the fourth mapping

v4 - the value of the fourth mapping

Returns:

a new mutable map of the four specified mappings

newMutableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newMutableMapOf(K k1,
                                                                 V v1,
                                                                 K k2,
                                                                 V v2,
                                                                 K k3,
                                                                 V v3,
                                                                 K k4,
                                                                 V v4,
                                                                 K k5,
                                                                 V v5)

Constructs a new mutable map of the five specified mappings.

This method simply delegates to getDefaultFactory().newMutableMapOf(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the first mapping

v1 - the value of the first mapping

k2 - the key of the second mapping

v2 - the value of the second mapping

k3 - the key of the third mapping

v3 - the value of the third mapping

k4 - the key of the fourth mapping

v4 - the value of the fourth mapping

k5 - the key of the fifth mapping

v5 - the value of the fifth mapping

Returns:

a new mutable map of the five specified mappings

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap()

Constructs a new empty updatable map of the default expected size.

This method simply delegates to getDefaultFactory().newUpdatableMap().

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Returns:

a new empty updatable map

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(int expectedSize)

Constructs a new empty updatable map of the given expected size.

This method simply delegates to getDefaultFactory().newUpdatableMap(expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

expectedSize - the expected size of the returned map

Returns:

a new empty updatable map of the given expected size

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map,
                                                                 int expectedSize)

Constructs a new updatable map with the same mappings as the specified map.

If the specified map is an instance of ObjObjMap and has the same key equivalence with this factory (and thus the constructed map), the expectedSize argument is ignored.

This method simply delegates to getDefaultFactory().newUpdatableMap(map, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map - the map whose mappings are to be placed in the returned map

expectedSize - the expected size of the returned map

Returns:

a new updatable map with the same mappings as the specified map

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 int expectedSize)

Constructs a new updatable map which merge the mappings of the specified maps. On conflict, mappings from the map2 have priority over mappings from the map1 with the same keys.

This method simply delegates to getDefaultFactory().newUpdatableMap(map1, map2, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

expectedSize - the expected size of the returned map

Returns:

a new updatable map which merge the mappings of the specified maps

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map3,
                                                                 int expectedSize)

Constructs a new updatable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newUpdatableMap(map1, map2, map3, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

expectedSize - the expected size of the returned map

Returns:

a new updatable map which merge the mappings of the specified maps

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map3,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map4,
                                                                 int expectedSize)

Constructs a new updatable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newUpdatableMap(map1, map2, map3, map4, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

map4 - the fourth map to merge

expectedSize - the expected size of the returned map

Returns:

a new updatable map which merge the mappings of the specified maps

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map3,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map4,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map5,
                                                                 int expectedSize)

Constructs a new updatable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newUpdatableMap(map1, map2, map3, map4, map5, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

map4 - the fourth map to merge

map5 - the fifth map to merge

expectedSize - the expected size of the returned map

Returns:

a new updatable map which merge the mappings of the specified maps

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Consumer<BiConsumer<K,V>> entriesSupplier,
                                                                 int expectedSize)

Constructs a new updatable map filled with mappings consumed by the callback within the given closure. Mappings supplied later within the closure have priority over the mappings passed earlier with the same keys.

Example: TODO

This method simply delegates to getDefaultFactory().newUpdatableMap(entriesSupplier, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

entriesSupplier - the function which supply mappings for the returned map via the callback passed in

expectedSize - the expected size of the returned map

Returns:

a new updatable map with mappings consumed by the callback within the given closure

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 K[] keys,
                                                                 @Nonnull
                                                                 V[] values,
                                                                 int expectedSize)

Constructs a new updatable map with the given mappings, i. e. pairs of elements from the keys and values arrays at the same index. If keys array have duplicate elements, value corresponding the key with the highest index is left in the returned map.

This method simply delegates to getDefaultFactory().newUpdatableMap(keys, values, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

keys - the keys of the returned map

values - the values of the returned map, each value is associated with the element of the keys array at the same index

expectedSize - the expected size of the returned map

Returns:

a new updatable map with the given mappings

Throws:

IllegalArgumentException - if keys and values arrays have different length

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Iterable<? extends K> keys,
                                                                 @Nonnull
                                                                 Iterable<? extends V> values,
                                                                 int expectedSize)

Constructs a new updatable map with the given mappings, i. e. pairs of elements from the keys and values iterables at the same iteration position. If keys have duplicate elements, value corresponding the key appeared last in the iteration is left in the returned map.

This method simply delegates to getDefaultFactory().newUpdatableMap(keys, values, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

keys - the keys of the returned map

values - the values of the returned map, each value is associated with the element of the keys iterable at the same iteration position

expectedSize - the expected size of the returned map

Returns:

a new updatable map with the given mappings

Throws:

IllegalArgumentException - if keys and values have different size

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map)

Constructs a new updatable map with the same mappings as the specified map.

This method simply delegates to getDefaultFactory().newUpdatableMap(map).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map - the map whose mappings are to be placed in the returned map

Returns:

a new updatable map with the same mappings as the specified map

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2)

Constructs a new updatable map which merge the mappings of the specified maps. On conflict, mappings from the map2 have priority over mappings from the map1 with the same keys.

This method simply delegates to getDefaultFactory().newUpdatableMap(map1, map2).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

Returns:

a new updatable map which merge the mappings of the specified maps

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map3)

Constructs a new updatable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newUpdatableMap(map1, map2, map3).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

Returns:

a new updatable map which merge the mappings of the specified maps

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map3,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map4)

Constructs a new updatable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newUpdatableMap(map1, map2, map3, map4).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

map4 - the fourth map to merge

Returns:

a new updatable map which merge the mappings of the specified maps

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map3,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map4,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map5)

Constructs a new updatable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newUpdatableMap(map1, map2, map3, map4, map5).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

map4 - the fourth map to merge

map5 - the fifth map to merge

Returns:

a new updatable map which merge the mappings of the specified maps

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Consumer<BiConsumer<K,V>> entriesSupplier)

Constructs a new updatable map filled with mappings consumed by the callback within the given closure. Mappings supplied later within the closure have priority over the mappings passed earlier with the same keys.

Example: TODO

This method simply delegates to getDefaultFactory().newUpdatableMap(entriesSupplier).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

entriesSupplier - the function which supply mappings for the returned map via the callback passed in

Returns:

a new updatable map with mappings consumed by the callback within the given closure

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 K[] keys,
                                                                 @Nonnull
                                                                 V[] values)

Constructs a new updatable map with the given mappings, i. e. pairs of elements from the keys and values arrays at the same index. If keys array have duplicate elements, value corresponding the key with the highest index is left in the returned map.

This method simply delegates to getDefaultFactory().newUpdatableMap(keys, values).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

keys - the keys of the returned map

values - the values of the returned map, each value is associated with the element of the keys array at the same index

Returns:

a new updatable map with the given mappings

Throws:

IllegalArgumentException - if keys and values arrays have different length

newUpdatableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMap(@Nonnull
                                                                 Iterable<? extends K> keys,
                                                                 @Nonnull
                                                                 Iterable<? extends V> values)

Constructs a new updatable map with the given mappings, i. e. pairs of elements from the keys and values iterables at the same iteration position. If keys have duplicate elements, value corresponding the key appeared last in the iteration is left in the returned map.

This method simply delegates to getDefaultFactory().newUpdatableMap(keys, values).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

keys - the keys of the returned map

values - the values of the returned map, each value is associated with the element of the keys iterable at the same iteration position

Returns:

a new updatable map with the given mappings

Throws:

IllegalArgumentException - if keys and values have different size

newUpdatableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMapOf(K k1,
                                                                   V v1)

Constructs a new updatable map of the single specified mapping.

This method simply delegates to getDefaultFactory().newUpdatableMapOf(k1, v1).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the sole mapping

v1 - the value of the sole mapping

Returns:

a new updatable map of the single specified mapping

newUpdatableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMapOf(K k1,
                                                                   V v1,
                                                                   K k2,
                                                                   V v2)

Constructs a new updatable map of the two specified mappings.

This method simply delegates to getDefaultFactory().newUpdatableMapOf(k1, v1, k2, v2).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the first mapping

v1 - the value of the first mapping

k2 - the key of the second mapping

v2 - the value of the second mapping

Returns:

a new updatable map of the two specified mappings

newUpdatableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMapOf(K k1,
                                                                   V v1,
                                                                   K k2,
                                                                   V v2,
                                                                   K k3,
                                                                   V v3)

Constructs a new updatable map of the three specified mappings.

This method simply delegates to getDefaultFactory().newUpdatableMapOf(k1, v1, k2, v2, k3, v3).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the first mapping

v1 - the value of the first mapping

k2 - the key of the second mapping

v2 - the value of the second mapping

k3 - the key of the third mapping

v3 - the value of the third mapping

Returns:

a new updatable map of the three specified mappings

newUpdatableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMapOf(K k1,
                                                                   V v1,
                                                                   K k2,
                                                                   V v2,
                                                                   K k3,
                                                                   V v3,
                                                                   K k4,
                                                                   V v4)

Constructs a new updatable map of the four specified mappings.

This method simply delegates to getDefaultFactory().newUpdatableMapOf(k1, v1, k2, v2, k3, v3, k4, v4).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the first mapping

v1 - the value of the first mapping

k2 - the key of the second mapping

v2 - the value of the second mapping

k3 - the key of the third mapping

v3 - the value of the third mapping

k4 - the key of the fourth mapping

v4 - the value of the fourth mapping

Returns:

a new updatable map of the four specified mappings

newUpdatableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newUpdatableMapOf(K k1,
                                                                   V v1,
                                                                   K k2,
                                                                   V v2,
                                                                   K k3,
                                                                   V v3,
                                                                   K k4,
                                                                   V v4,
                                                                   K k5,
                                                                   V v5)

Constructs a new updatable map of the five specified mappings.

This method simply delegates to getDefaultFactory().newUpdatableMapOf(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the first mapping

v1 - the value of the first mapping

k2 - the key of the second mapping

v2 - the value of the second mapping

k3 - the key of the third mapping

v3 - the value of the third mapping

k4 - the key of the fourth mapping

v4 - the value of the fourth mapping

k5 - the key of the fifth mapping

v5 - the value of the fifth mapping

Returns:

a new updatable map of the five specified mappings

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map,
                                                                 int expectedSize)

Constructs a new immutable map with the same mappings as the specified map.

If the specified map is an instance of ObjObjMap and has the same key equivalence with this factory (and thus the constructed map), the expectedSize argument is ignored.

This method simply delegates to getDefaultFactory().newImmutableMap(map, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map - the map whose mappings are to be placed in the returned map

expectedSize - the expected size of the returned map

Returns:

a new immutable map with the same mappings as the specified map

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 int expectedSize)

Constructs a new immutable map which merge the mappings of the specified maps. On conflict, mappings from the map2 have priority over mappings from the map1 with the same keys.

This method simply delegates to getDefaultFactory().newImmutableMap(map1, map2, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

expectedSize - the expected size of the returned map

Returns:

a new immutable map which merge the mappings of the specified maps

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map3,
                                                                 int expectedSize)

Constructs a new immutable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newImmutableMap(map1, map2, map3, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

expectedSize - the expected size of the returned map

Returns:

a new immutable map which merge the mappings of the specified maps

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map3,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map4,
                                                                 int expectedSize)

Constructs a new immutable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newImmutableMap(map1, map2, map3, map4, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

map4 - the fourth map to merge

expectedSize - the expected size of the returned map

Returns:

a new immutable map which merge the mappings of the specified maps

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map3,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map4,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map5,
                                                                 int expectedSize)

Constructs a new immutable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newImmutableMap(map1, map2, map3, map4, map5, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

map4 - the fourth map to merge

map5 - the fifth map to merge

expectedSize - the expected size of the returned map

Returns:

a new immutable map which merge the mappings of the specified maps

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Consumer<BiConsumer<K,V>> entriesSupplier,
                                                                 int expectedSize)

Constructs a new immutable map filled with mappings consumed by the callback within the given closure. Mappings supplied later within the closure have priority over the mappings passed earlier with the same keys.

Example: TODO

This method simply delegates to getDefaultFactory().newImmutableMap(entriesSupplier, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

entriesSupplier - the function which supply mappings for the returned map via the callback passed in

expectedSize - the expected size of the returned map

Returns:

a new immutable map with mappings consumed by the callback within the given closure

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 K[] keys,
                                                                 @Nonnull
                                                                 V[] values,
                                                                 int expectedSize)

Constructs a new immutable map with the given mappings, i. e. pairs of elements from the keys and values arrays at the same index. If keys array have duplicate elements, value corresponding the key with the highest index is left in the returned map.

This method simply delegates to getDefaultFactory().newImmutableMap(keys, values, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

keys - the keys of the returned map

values - the values of the returned map, each value is associated with the element of the keys array at the same index

expectedSize - the expected size of the returned map

Returns:

a new immutable map with the given mappings

Throws:

IllegalArgumentException - if keys and values arrays have different length

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Iterable<? extends K> keys,
                                                                 @Nonnull
                                                                 Iterable<? extends V> values,
                                                                 int expectedSize)

Constructs a new immutable map with the given mappings, i. e. pairs of elements from the keys and values iterables at the same iteration position. If keys have duplicate elements, value corresponding the key appeared last in the iteration is left in the returned map.

This method simply delegates to getDefaultFactory().newImmutableMap(keys, values, expectedSize).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

keys - the keys of the returned map

values - the values of the returned map, each value is associated with the element of the keys iterable at the same iteration position

expectedSize - the expected size of the returned map

Returns:

a new immutable map with the given mappings

Throws:

IllegalArgumentException - if keys and values have different size

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map)

Constructs a new immutable map with the same mappings as the specified map.

This method simply delegates to getDefaultFactory().newImmutableMap(map).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map - the map whose mappings are to be placed in the returned map

Returns:

a new immutable map with the same mappings as the specified map

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2)

Constructs a new immutable map which merge the mappings of the specified maps. On conflict, mappings from the map2 have priority over mappings from the map1 with the same keys.

This method simply delegates to getDefaultFactory().newImmutableMap(map1, map2).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

Returns:

a new immutable map which merge the mappings of the specified maps

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map3)

Constructs a new immutable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newImmutableMap(map1, map2, map3).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

Returns:

a new immutable map which merge the mappings of the specified maps

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map3,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map4)

Constructs a new immutable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newImmutableMap(map1, map2, map3, map4).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

map4 - the fourth map to merge

Returns:

a new immutable map which merge the mappings of the specified maps

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Map<? extends K,? extends V> map1,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map2,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map3,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map4,
                                                                 @Nonnull
                                                                 Map<? extends K,? extends V> map5)

Constructs a new immutable map which merge the mappings of the specified maps. On conflict, mappings from the maps passed later in the argument list have priority over mappings from the maps passed earlier with the same keys.

This method simply delegates to getDefaultFactory().newImmutableMap(map1, map2, map3, map4, map5).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

map1 - the first map to merge

map2 - the second map to merge

map3 - the third map to merge

map4 - the fourth map to merge

map5 - the fifth map to merge

Returns:

a new immutable map which merge the mappings of the specified maps

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Consumer<BiConsumer<K,V>> entriesSupplier)

Constructs a new immutable map filled with mappings consumed by the callback within the given closure. Mappings supplied later within the closure have priority over the mappings passed earlier with the same keys.

Example: TODO

This method simply delegates to getDefaultFactory().newImmutableMap(entriesSupplier).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

entriesSupplier - the function which supply mappings for the returned map via the callback passed in

Returns:

a new immutable map with mappings consumed by the callback within the given closure

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 K[] keys,
                                                                 @Nonnull
                                                                 V[] values)

Constructs a new immutable map with the given mappings, i. e. pairs of elements from the keys and values arrays at the same index. If keys array have duplicate elements, value corresponding the key with the highest index is left in the returned map.

This method simply delegates to getDefaultFactory().newImmutableMap(keys, values).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

keys - the keys of the returned map

values - the values of the returned map, each value is associated with the element of the keys array at the same index

Returns:

a new immutable map with the given mappings

Throws:

IllegalArgumentException - if keys and values arrays have different length

newImmutableMap

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMap(@Nonnull
                                                                 Iterable<? extends K> keys,
                                                                 @Nonnull
                                                                 Iterable<? extends V> values)

Constructs a new immutable map with the given mappings, i. e. pairs of elements from the keys and values iterables at the same iteration position. If keys have duplicate elements, value corresponding the key appeared last in the iteration is left in the returned map.

This method simply delegates to getDefaultFactory().newImmutableMap(keys, values).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

keys - the keys of the returned map

values - the values of the returned map, each value is associated with the element of the keys iterable at the same iteration position

Returns:

a new immutable map with the given mappings

Throws:

IllegalArgumentException - if keys and values have different size

newImmutableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMapOf(K k1,
                                                                   V v1)

Constructs a new immutable map of the single specified mapping.

This method simply delegates to getDefaultFactory().newImmutableMapOf(k1, v1).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the sole mapping

v1 - the value of the sole mapping

Returns:

a new immutable map of the single specified mapping

newImmutableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMapOf(K k1,
                                                                   V v1,
                                                                   K k2,
                                                                   V v2)

Constructs a new immutable map of the two specified mappings.

This method simply delegates to getDefaultFactory().newImmutableMapOf(k1, v1, k2, v2).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the first mapping

v1 - the value of the first mapping

k2 - the key of the second mapping

v2 - the value of the second mapping

Returns:

a new immutable map of the two specified mappings

newImmutableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMapOf(K k1,
                                                                   V v1,
                                                                   K k2,
                                                                   V v2,
                                                                   K k3,
                                                                   V v3)

Constructs a new immutable map of the three specified mappings.

This method simply delegates to getDefaultFactory().newImmutableMapOf(k1, v1, k2, v2, k3, v3).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the first mapping

v1 - the value of the first mapping

k2 - the key of the second mapping

v2 - the value of the second mapping

k3 - the key of the third mapping

v3 - the value of the third mapping

Returns:

a new immutable map of the three specified mappings

newImmutableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMapOf(K k1,
                                                                   V v1,
                                                                   K k2,
                                                                   V v2,
                                                                   K k3,
                                                                   V v3,
                                                                   K k4,
                                                                   V v4)

Constructs a new immutable map of the four specified mappings.

This method simply delegates to getDefaultFactory().newImmutableMapOf(k1, v1, k2, v2, k3, v3, k4, v4).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the first mapping

v1 - the value of the first mapping

k2 - the key of the second mapping

v2 - the value of the second mapping

k3 - the key of the third mapping

v3 - the value of the third mapping

k4 - the key of the fourth mapping

v4 - the value of the fourth mapping

Returns:

a new immutable map of the four specified mappings

newImmutableMapOf

@Nonnull
public static <K,V> HashObjObjMap<K,V> newImmutableMapOf(K k1,
                                                                   V v1,
                                                                   K k2,
                                                                   V v2,
                                                                   K k3,
                                                                   V v3,
                                                                   K k4,
                                                                   V v4,
                                                                   K k5,
                                                                   V v5)

Constructs a new immutable map of the five specified mappings.

This method simply delegates to getDefaultFactory().newImmutableMapOf(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5).

Type Parameters:

K - the key type of the returned map

V - the value type of the returned map

Parameters:

k1 - the key of the first mapping

v1 - the value of the first mapping

k2 - the key of the second mapping

v2 - the value of the second mapping

k3 - the key of the third mapping

v3 - the value of the third mapping

k4 - the key of the fourth mapping

v4 - the value of the fourth mapping

k5 - the key of the fifth mapping

v5 - the value of the fifth mapping

Returns:

a new immutable map of the five specified mappings