net.openhft.koloboke.collect.map.hash.HashLongIntMaps Maven / Gradle / Ivy
Show all versions of koloboke-api-jdk8 Show documentation
/*
* Copyright 2014 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.openhft.koloboke.collect.map.hash;
import net.openhft.koloboke.collect.map.LongIntMap;
import java.util.function.Consumer;
import javax.annotation.Nonnull;
import java.util.Map;
import java.util.ServiceLoader;
/**
* This class consists only of static factory methods to construct {@code HashLongIntMap}s, and
* the default {@link HashLongIntMapFactory} static provider ({@link #getDefaultFactory()}).
*
* @see HashLongIntMap
*/
public final class HashLongIntMaps {
private static class DefaultFactoryHolder {
private static final HashLongIntMapFactory defaultFactory =
ServiceLoader.load(HashLongIntMapFactory.class).iterator().next();
}
/**
* Returns the default {@link HashLongIntMapFactory} implementation, to which
* all static methods in this class delegate.
*
* @return the default {@link HashLongIntMapFactory} implementation
* @throws RuntimeException if no implementations
* of {@link HashLongIntMapFactory} are provided
*/
@Nonnull
public static HashLongIntMapFactory getDefaultFactory() {
return (HashLongIntMapFactory) DefaultFactoryHolder.defaultFactory;
}
/**
* Constructs a new empty mutable map of the default expected size.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap() newMutableMap()}.
*
* @return a new empty mutable map
*/
@Nonnull
public static HashLongIntMap newMutableMap() {
return getDefaultFactory().newMutableMap();
}
/**
* Constructs a new empty mutable map of the given expected size.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(int) newMutableMap(expectedSize)}.
*
* @param expectedSize the expected size of the returned map
* @return a new empty mutable map of the given expected size
*/
@Nonnull
public static HashLongIntMap newMutableMap(int expectedSize) {
return getDefaultFactory().newMutableMap(expectedSize);
}
/**
* Constructs a new mutable map which merge the mappings of the specified maps. On conflict,
* mappings from the {@code map2} have priority over mappings from the {@code map1} with
* the same keys.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(Map,
* Map, int) newMutableMap(map1, map2, expectedSize)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param expectedSize the expected size of the returned map
* @return a new mutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Map map1,
@Nonnull Map map2, int expectedSize) {
return getDefaultFactory().newMutableMap(map1, map2, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(Map, Map,
* Map, int) newMutableMap(map1, map2, map3, expectedSize)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param expectedSize the expected size of the returned map
* @return a new mutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3, int expectedSize) {
return getDefaultFactory().newMutableMap(map1, map2, map3, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(Map, Map,
* Map, Map, int) newMutableMap(map1, map2, map3, map4, expectedSize)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param map4 the fourth map to merge
* @param expectedSize the expected size of the returned map
* @return a new mutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3,
@Nonnull Map map4, int expectedSize) {
return getDefaultFactory().newMutableMap(map1, map2, map3, map4, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(Map, Map,
* Map, Map, Map, int) newMutableMap(map1, map2, map3, map4, map5, expectedSize)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param map4 the fourth map to merge
* @param map5 the fifth map to merge
* @param expectedSize the expected size of the returned map
* @return a new mutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3,
@Nonnull Map map4,
@Nonnull Map map5, int expectedSize) {
return getDefaultFactory().newMutableMap(map1, map2, map3, map4, map5, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(
* Consumer, int) newMutableMap(entriesSupplier, expectedSize)}.
*
* @param entriesSupplier the function which supply mappings for the returned map via
* the callback passed in
* @param expectedSize the expected size of the returned map
* @return a new mutable map with mappings consumed by the callback within the given closure
*/
@Nonnull
public static HashLongIntMap newMutableMap(@Nonnull
Consumer entriesSupplier
, int expectedSize) {
return getDefaultFactory().newMutableMap(entriesSupplier, expectedSize);
}
/**
* Constructs a new mutable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} arrays at the same index. If {@code keys} array have
* duplicate elements, value corresponding the key with the highest index is left
* in the returned map.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(long[], int[], int
* ) newMutableMap(keys, values, expectedSize)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} array at the same index
* @param expectedSize the expected size of the returned map
* @return a new mutable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} arrays have different
* length
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull long[] keys, @Nonnull int[] values, int expectedSize) {
return getDefaultFactory().newMutableMap(keys, values, expectedSize);
}
/**
* Constructs a new mutable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} arrays at the same index. If {@code keys} array have
* duplicate elements, value corresponding the key with the highest index is left
* in the returned map.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(Long[],
* Integer[], int) newMutableMap(keys, values, expectedSize)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} array at the same index
* @param expectedSize the expected size of the returned map
* @return a new mutable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} arrays have different
* length
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Long[] keys, @Nonnull Integer[] values, int expectedSize) {
return getDefaultFactory().newMutableMap(keys, values, expectedSize);
}
/**
* Constructs a new mutable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} iterables at the same iteration position. If {@code keys}
* have duplicate elements, value corresponding the key appeared last in the iteration is left
* in the returned map.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(Iterable, Iterable, int
* ) newMutableMap(keys, values, expectedSize)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} iterable at the same iteration position
* @param expectedSize the expected size of the returned map
* @return a new mutable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} have different size
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Iterable keys, @Nonnull Iterable values
, int expectedSize) {
return getDefaultFactory().newMutableMap(keys, values, expectedSize);
}
/**
* Constructs a new mutable map with the same mappings as the specified {@code map}.
*
*
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(
* Map) newMutableMap(map)}.
*
* @param map the map whose mappings are to be placed in the returned map
*
* @return a new mutable map with the same mappings as the specified {@code map}
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Map map) {
return getDefaultFactory().newMutableMap(map);
}
/**
* Constructs a new mutable map which merge the mappings of the specified maps. On conflict,
* mappings from the {@code map2} have priority over mappings from the {@code map1} with
* the same keys.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(Map,
* Map) newMutableMap(map1, map2)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
*
* @return a new mutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Map map1,
@Nonnull Map map2) {
return getDefaultFactory().newMutableMap(map1, map2);
}
/**
* 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(Map, Map,
* Map) newMutableMap(map1, map2, map3)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
*
* @return a new mutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3) {
return getDefaultFactory().newMutableMap(map1, map2, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(Map, Map,
* Map, Map) newMutableMap(map1, map2, map3, map4)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param map4 the fourth map to merge
*
* @return a new mutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3,
@Nonnull Map map4) {
return getDefaultFactory().newMutableMap(map1, map2, map3, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(Map, Map,
* Map, Map, Map) newMutableMap(map1, map2, map3, map4, map5)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param map4 the fourth map to merge
* @param map5 the fifth map to merge
*
* @return a new mutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3,
@Nonnull Map map4,
@Nonnull Map map5) {
return getDefaultFactory().newMutableMap(map1, map2, map3, map4, map5);
}
/**
* 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(
* Consumer) newMutableMap(entriesSupplier)}.
*
* @param entriesSupplier the function which supply mappings for the returned map via
* the callback passed in
*
* @return a new mutable map with mappings consumed by the callback within the given closure
*/
@Nonnull
public static HashLongIntMap newMutableMap(@Nonnull
Consumer entriesSupplier
) {
return getDefaultFactory().newMutableMap(entriesSupplier);
}
/**
* Constructs a new mutable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} arrays at the same index. If {@code keys} array have
* duplicate elements, value corresponding the key with the highest index is left
* in the returned map.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(long[], int[]
* ) newMutableMap(keys, values)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} array at the same index
*
* @return a new mutable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} arrays have different
* length
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull long[] keys, @Nonnull int[] values) {
return getDefaultFactory().newMutableMap(keys, values);
}
/**
* Constructs a new mutable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} arrays at the same index. If {@code keys} array have
* duplicate elements, value corresponding the key with the highest index is left
* in the returned map.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(Long[],
* Integer[]) newMutableMap(keys, values)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} array at the same index
*
* @return a new mutable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} arrays have different
* length
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Long[] keys, @Nonnull Integer[] values) {
return getDefaultFactory().newMutableMap(keys, values);
}
/**
* Constructs a new mutable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} iterables at the same iteration position. If {@code keys}
* have duplicate elements, value corresponding the key appeared last in the iteration is left
* in the returned map.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMap(Iterable, Iterable
* ) newMutableMap(keys, values)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} iterable at the same iteration position
*
* @return a new mutable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} have different size
*/
@Nonnull
public static HashLongIntMap newMutableMap(
@Nonnull Iterable keys, @Nonnull Iterable values
) {
return getDefaultFactory().newMutableMap(keys, values);
}
/**
* Constructs a new mutable map of the single specified mapping.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMapOf(long, int
* ) newMutableMapOf(k1, v1)}.
*
* @param k1 the key of the sole mapping
* @param v1 the value of the sole mapping
* @return a new mutable map of the single specified mapping
*/
@Nonnull
public static HashLongIntMap newMutableMapOf(
long k1, int v1) {
return getDefaultFactory().newMutableMapOf(k1, v1);
}
/**
* Constructs a new mutable map of the two specified mappings.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMapOf(long, int,
* long, int) newMutableMapOf(k1, v1, k2, v2)}.
*
* @param k1 the key of the first mapping
* @param v1 the value of the first mapping
* @param k2 the key of the second mapping
* @param v2 the value of the second mapping
* @return a new mutable map of the two specified mappings
*/
@Nonnull
public static HashLongIntMap newMutableMapOf(
long k1, int v1, long k2, int v2) {
return getDefaultFactory().newMutableMapOf(k1, v1, k2, v2);
}
/**
* Constructs a new mutable map of the three specified mappings.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMapOf(long, int,
* long, int, long, int) newMutableMapOf(k1, v1, k2, v2,
* k3, v3)}.
*
* @param k1 the key of the first mapping
* @param v1 the value of the first mapping
* @param k2 the key of the second mapping
* @param v2 the value of the second mapping
* @param k3 the key of the third mapping
* @param v3 the value of the third mapping
* @return a new mutable map of the three specified mappings
*/
@Nonnull
public static HashLongIntMap newMutableMapOf(
long k1, int v1, long k2, int v2,
long k3, int v3) {
return getDefaultFactory().newMutableMapOf(k1, v1, k2, v2, k3, v3);
}
/**
* Constructs a new mutable map of the four specified mappings.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMapOf(long, int,
* long, int, long, int, long, int
* ) newMutableMapOf(k1, v1, k2, v2, k3, v3, k4, v4)}.
*
* @param k1 the key of the first mapping
* @param v1 the value of the first mapping
* @param k2 the key of the second mapping
* @param v2 the value of the second mapping
* @param k3 the key of the third mapping
* @param v3 the value of the third mapping
* @param k4 the key of the fourth mapping
* @param v4 the value of the fourth mapping
* @return a new mutable map of the four specified mappings
*/
@Nonnull
public static HashLongIntMap newMutableMapOf(
long k1, int v1, long k2, int v2,
long k3, int v3, long k4, int v4) {
return getDefaultFactory().newMutableMapOf(k1, v1, k2, v2, k3, v3, k4, v4);
}
/**
* Constructs a new mutable map of the five specified mappings.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newMutableMapOf(long, int,
* long, int, long, int, long, int,
* long, int) newMutableMapOf(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5)}.
*
* @param k1 the key of the first mapping
* @param v1 the value of the first mapping
* @param k2 the key of the second mapping
* @param v2 the value of the second mapping
* @param k3 the key of the third mapping
* @param v3 the value of the third mapping
* @param k4 the key of the fourth mapping
* @param v4 the value of the fourth mapping
* @param k5 the key of the fifth mapping
* @param v5 the value of the fifth mapping
* @return a new mutable map of the five specified mappings
*/
@Nonnull
public static HashLongIntMap newMutableMapOf(
long k1, int v1, long k2, int v2,
long k3, int v3, long k4, int v4,
long k5, int v5) {
return getDefaultFactory().newMutableMapOf(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5);
}
/**
* Constructs a new empty updatable map of the default expected size.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap() newUpdatableMap()}.
*
* @return a new empty updatable map
*/
@Nonnull
public static HashLongIntMap newUpdatableMap() {
return getDefaultFactory().newUpdatableMap();
}
/**
* Constructs a new empty updatable map of the given expected size.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(int) newUpdatableMap(expectedSize)}.
*
* @param expectedSize the expected size of the returned map
* @return a new empty updatable map of the given expected size
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(int expectedSize) {
return getDefaultFactory().newUpdatableMap(expectedSize);
}
/**
* Constructs a new updatable map which merge the mappings of the specified maps. On conflict,
* mappings from the {@code map2} have priority over mappings from the {@code map1} with
* the same keys.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(Map,
* Map, int) newUpdatableMap(map1, map2, expectedSize)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param expectedSize the expected size of the returned map
* @return a new updatable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Map map1,
@Nonnull Map map2, int expectedSize) {
return getDefaultFactory().newUpdatableMap(map1, map2, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(Map, Map,
* Map, int) newUpdatableMap(map1, map2, map3, expectedSize)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param expectedSize the expected size of the returned map
* @return a new updatable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3, int expectedSize) {
return getDefaultFactory().newUpdatableMap(map1, map2, map3, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(Map, Map,
* Map, Map, int) newUpdatableMap(map1, map2, map3, map4, expectedSize)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param map4 the fourth map to merge
* @param expectedSize the expected size of the returned map
* @return a new updatable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3,
@Nonnull Map map4, int expectedSize) {
return getDefaultFactory().newUpdatableMap(map1, map2, map3, map4, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(Map, Map,
* Map, Map, Map, int) newUpdatableMap(map1, map2, map3, map4, map5, expectedSize)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param map4 the fourth map to merge
* @param map5 the fifth map to merge
* @param expectedSize the expected size of the returned map
* @return a new updatable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3,
@Nonnull Map map4,
@Nonnull Map map5, int expectedSize) {
return getDefaultFactory().newUpdatableMap(map1, map2, map3, map4, map5, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(
* Consumer, int) newUpdatableMap(entriesSupplier, expectedSize)}.
*
* @param entriesSupplier the function which supply mappings for the returned map via
* the callback passed in
* @param expectedSize the expected size of the returned map
* @return a new updatable map with mappings consumed by the callback within the given closure
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(@Nonnull
Consumer entriesSupplier
, int expectedSize) {
return getDefaultFactory().newUpdatableMap(entriesSupplier, expectedSize);
}
/**
* Constructs a new updatable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} arrays at the same index. If {@code keys} array have
* duplicate elements, value corresponding the key with the highest index is left
* in the returned map.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(long[], int[], int
* ) newUpdatableMap(keys, values, expectedSize)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} array at the same index
* @param expectedSize the expected size of the returned map
* @return a new updatable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} arrays have different
* length
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull long[] keys, @Nonnull int[] values, int expectedSize) {
return getDefaultFactory().newUpdatableMap(keys, values, expectedSize);
}
/**
* Constructs a new updatable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} arrays at the same index. If {@code keys} array have
* duplicate elements, value corresponding the key with the highest index is left
* in the returned map.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(Long[],
* Integer[], int) newUpdatableMap(keys, values, expectedSize)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} array at the same index
* @param expectedSize the expected size of the returned map
* @return a new updatable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} arrays have different
* length
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Long[] keys, @Nonnull Integer[] values, int expectedSize) {
return getDefaultFactory().newUpdatableMap(keys, values, expectedSize);
}
/**
* Constructs a new updatable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} iterables at the same iteration position. If {@code keys}
* have duplicate elements, value corresponding the key appeared last in the iteration is left
* in the returned map.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(Iterable, Iterable, int
* ) newUpdatableMap(keys, values, expectedSize)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} iterable at the same iteration position
* @param expectedSize the expected size of the returned map
* @return a new updatable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} have different size
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Iterable keys, @Nonnull Iterable values
, int expectedSize) {
return getDefaultFactory().newUpdatableMap(keys, values, expectedSize);
}
/**
* Constructs a new updatable map with the same mappings as the specified {@code map}.
*
*
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(
* Map) newUpdatableMap(map)}.
*
* @param map the map whose mappings are to be placed in the returned map
*
* @return a new updatable map with the same mappings as the specified {@code map}
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Map map) {
return getDefaultFactory().newUpdatableMap(map);
}
/**
* Constructs a new updatable map which merge the mappings of the specified maps. On conflict,
* mappings from the {@code map2} have priority over mappings from the {@code map1} with
* the same keys.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(Map,
* Map) newUpdatableMap(map1, map2)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
*
* @return a new updatable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Map map1,
@Nonnull Map map2) {
return getDefaultFactory().newUpdatableMap(map1, map2);
}
/**
* 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(Map, Map,
* Map) newUpdatableMap(map1, map2, map3)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
*
* @return a new updatable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3) {
return getDefaultFactory().newUpdatableMap(map1, map2, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(Map, Map,
* Map, Map) newUpdatableMap(map1, map2, map3, map4)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param map4 the fourth map to merge
*
* @return a new updatable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3,
@Nonnull Map map4) {
return getDefaultFactory().newUpdatableMap(map1, map2, map3, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(Map, Map,
* Map, Map, Map) newUpdatableMap(map1, map2, map3, map4, map5)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param map4 the fourth map to merge
* @param map5 the fifth map to merge
*
* @return a new updatable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3,
@Nonnull Map map4,
@Nonnull Map map5) {
return getDefaultFactory().newUpdatableMap(map1, map2, map3, map4, map5);
}
/**
* 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(
* Consumer) newUpdatableMap(entriesSupplier)}.
*
* @param entriesSupplier the function which supply mappings for the returned map via
* the callback passed in
*
* @return a new updatable map with mappings consumed by the callback within the given closure
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(@Nonnull
Consumer entriesSupplier
) {
return getDefaultFactory().newUpdatableMap(entriesSupplier);
}
/**
* Constructs a new updatable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} arrays at the same index. If {@code keys} array have
* duplicate elements, value corresponding the key with the highest index is left
* in the returned map.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(long[], int[]
* ) newUpdatableMap(keys, values)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} array at the same index
*
* @return a new updatable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} arrays have different
* length
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull long[] keys, @Nonnull int[] values) {
return getDefaultFactory().newUpdatableMap(keys, values);
}
/**
* Constructs a new updatable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} arrays at the same index. If {@code keys} array have
* duplicate elements, value corresponding the key with the highest index is left
* in the returned map.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(Long[],
* Integer[]) newUpdatableMap(keys, values)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} array at the same index
*
* @return a new updatable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} arrays have different
* length
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Long[] keys, @Nonnull Integer[] values) {
return getDefaultFactory().newUpdatableMap(keys, values);
}
/**
* Constructs a new updatable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} iterables at the same iteration position. If {@code keys}
* have duplicate elements, value corresponding the key appeared last in the iteration is left
* in the returned map.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMap(Iterable, Iterable
* ) newUpdatableMap(keys, values)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} iterable at the same iteration position
*
* @return a new updatable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} have different size
*/
@Nonnull
public static HashLongIntMap newUpdatableMap(
@Nonnull Iterable keys, @Nonnull Iterable values
) {
return getDefaultFactory().newUpdatableMap(keys, values);
}
/**
* Constructs a new updatable map of the single specified mapping.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMapOf(long, int
* ) newUpdatableMapOf(k1, v1)}.
*
* @param k1 the key of the sole mapping
* @param v1 the value of the sole mapping
* @return a new updatable map of the single specified mapping
*/
@Nonnull
public static HashLongIntMap newUpdatableMapOf(
long k1, int v1) {
return getDefaultFactory().newUpdatableMapOf(k1, v1);
}
/**
* Constructs a new updatable map of the two specified mappings.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMapOf(long, int,
* long, int) newUpdatableMapOf(k1, v1, k2, v2)}.
*
* @param k1 the key of the first mapping
* @param v1 the value of the first mapping
* @param k2 the key of the second mapping
* @param v2 the value of the second mapping
* @return a new updatable map of the two specified mappings
*/
@Nonnull
public static HashLongIntMap newUpdatableMapOf(
long k1, int v1, long k2, int v2) {
return getDefaultFactory().newUpdatableMapOf(k1, v1, k2, v2);
}
/**
* Constructs a new updatable map of the three specified mappings.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMapOf(long, int,
* long, int, long, int) newUpdatableMapOf(k1, v1, k2, v2,
* k3, v3)}.
*
* @param k1 the key of the first mapping
* @param v1 the value of the first mapping
* @param k2 the key of the second mapping
* @param v2 the value of the second mapping
* @param k3 the key of the third mapping
* @param v3 the value of the third mapping
* @return a new updatable map of the three specified mappings
*/
@Nonnull
public static HashLongIntMap newUpdatableMapOf(
long k1, int v1, long k2, int v2,
long k3, int v3) {
return getDefaultFactory().newUpdatableMapOf(k1, v1, k2, v2, k3, v3);
}
/**
* Constructs a new updatable map of the four specified mappings.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMapOf(long, int,
* long, int, long, int, long, int
* ) newUpdatableMapOf(k1, v1, k2, v2, k3, v3, k4, v4)}.
*
* @param k1 the key of the first mapping
* @param v1 the value of the first mapping
* @param k2 the key of the second mapping
* @param v2 the value of the second mapping
* @param k3 the key of the third mapping
* @param v3 the value of the third mapping
* @param k4 the key of the fourth mapping
* @param v4 the value of the fourth mapping
* @return a new updatable map of the four specified mappings
*/
@Nonnull
public static HashLongIntMap newUpdatableMapOf(
long k1, int v1, long k2, int v2,
long k3, int v3, long k4, int v4) {
return getDefaultFactory().newUpdatableMapOf(k1, v1, k2, v2, k3, v3, k4, v4);
}
/**
* Constructs a new updatable map of the five specified mappings.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newUpdatableMapOf(long, int,
* long, int, long, int, long, int,
* long, int) newUpdatableMapOf(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5)}.
*
* @param k1 the key of the first mapping
* @param v1 the value of the first mapping
* @param k2 the key of the second mapping
* @param v2 the value of the second mapping
* @param k3 the key of the third mapping
* @param v3 the value of the third mapping
* @param k4 the key of the fourth mapping
* @param v4 the value of the fourth mapping
* @param k5 the key of the fifth mapping
* @param v5 the value of the fifth mapping
* @return a new updatable map of the five specified mappings
*/
@Nonnull
public static HashLongIntMap newUpdatableMapOf(
long k1, int v1, long k2, int v2,
long k3, int v3, long k4, int v4,
long k5, int v5) {
return getDefaultFactory().newUpdatableMapOf(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5);
}
/**
* Constructs a new immutable map which merge the mappings of the specified maps. On conflict,
* mappings from the {@code map2} have priority over mappings from the {@code map1} with
* the same keys.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(Map,
* Map, int) newImmutableMap(map1, map2, expectedSize)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param expectedSize the expected size of the returned map
* @return a new immutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Map map1,
@Nonnull Map map2, int expectedSize) {
return getDefaultFactory().newImmutableMap(map1, map2, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(Map, Map,
* Map, int) newImmutableMap(map1, map2, map3, expectedSize)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param expectedSize the expected size of the returned map
* @return a new immutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3, int expectedSize) {
return getDefaultFactory().newImmutableMap(map1, map2, map3, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(Map, Map,
* Map, Map, int) newImmutableMap(map1, map2, map3, map4, expectedSize)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param map4 the fourth map to merge
* @param expectedSize the expected size of the returned map
* @return a new immutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3,
@Nonnull Map map4, int expectedSize) {
return getDefaultFactory().newImmutableMap(map1, map2, map3, map4, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(Map, Map,
* Map, Map, Map, int) newImmutableMap(map1, map2, map3, map4, map5, expectedSize)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param map4 the fourth map to merge
* @param map5 the fifth map to merge
* @param expectedSize the expected size of the returned map
* @return a new immutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3,
@Nonnull Map map4,
@Nonnull Map map5, int expectedSize) {
return getDefaultFactory().newImmutableMap(map1, map2, map3, map4, map5, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(
* Consumer, int) newImmutableMap(entriesSupplier, expectedSize)}.
*
* @param entriesSupplier the function which supply mappings for the returned map via
* the callback passed in
* @param expectedSize the expected size of the returned map
* @return a new immutable map with mappings consumed by the callback within the given closure
*/
@Nonnull
public static HashLongIntMap newImmutableMap(@Nonnull
Consumer entriesSupplier
, int expectedSize) {
return getDefaultFactory().newImmutableMap(entriesSupplier, expectedSize);
}
/**
* Constructs a new immutable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} arrays at the same index. If {@code keys} array have
* duplicate elements, value corresponding the key with the highest index is left
* in the returned map.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(long[], int[], int
* ) newImmutableMap(keys, values, expectedSize)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} array at the same index
* @param expectedSize the expected size of the returned map
* @return a new immutable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} arrays have different
* length
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull long[] keys, @Nonnull int[] values, int expectedSize) {
return getDefaultFactory().newImmutableMap(keys, values, expectedSize);
}
/**
* Constructs a new immutable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} arrays at the same index. If {@code keys} array have
* duplicate elements, value corresponding the key with the highest index is left
* in the returned map.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(Long[],
* Integer[], int) newImmutableMap(keys, values, expectedSize)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} array at the same index
* @param expectedSize the expected size of the returned map
* @return a new immutable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} arrays have different
* length
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Long[] keys, @Nonnull Integer[] values, int expectedSize) {
return getDefaultFactory().newImmutableMap(keys, values, expectedSize);
}
/**
* Constructs a new immutable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} iterables at the same iteration position. If {@code keys}
* have duplicate elements, value corresponding the key appeared last in the iteration is left
* in the returned map.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(Iterable, Iterable, int
* ) newImmutableMap(keys, values, expectedSize)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} iterable at the same iteration position
* @param expectedSize the expected size of the returned map
* @return a new immutable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} have different size
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Iterable keys, @Nonnull Iterable values
, int expectedSize) {
return getDefaultFactory().newImmutableMap(keys, values, expectedSize);
}
/**
* Constructs a new immutable map with the same mappings as the specified {@code map}.
*
*
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(
* Map) newImmutableMap(map)}.
*
* @param map the map whose mappings are to be placed in the returned map
*
* @return a new immutable map with the same mappings as the specified {@code map}
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Map map) {
return getDefaultFactory().newImmutableMap(map);
}
/**
* Constructs a new immutable map which merge the mappings of the specified maps. On conflict,
* mappings from the {@code map2} have priority over mappings from the {@code map1} with
* the same keys.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(Map,
* Map) newImmutableMap(map1, map2)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
*
* @return a new immutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Map map1,
@Nonnull Map map2) {
return getDefaultFactory().newImmutableMap(map1, map2);
}
/**
* 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(Map, Map,
* Map) newImmutableMap(map1, map2, map3)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
*
* @return a new immutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3) {
return getDefaultFactory().newImmutableMap(map1, map2, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(Map, Map,
* Map, Map) newImmutableMap(map1, map2, map3, map4)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param map4 the fourth map to merge
*
* @return a new immutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3,
@Nonnull Map map4) {
return getDefaultFactory().newImmutableMap(map1, map2, map3, 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(Map, Map,
* Map, Map, Map) newImmutableMap(map1, map2, map3, map4, map5)}.
*
* @param map1 the first map to merge
* @param map2 the second map to merge
* @param map3 the third map to merge
* @param map4 the fourth map to merge
* @param map5 the fifth map to merge
*
* @return a new immutable map which merge the mappings of the specified maps
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Map map1,
@Nonnull Map map2,
@Nonnull Map map3,
@Nonnull Map map4,
@Nonnull Map map5) {
return getDefaultFactory().newImmutableMap(map1, map2, map3, map4, map5);
}
/**
* 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 {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(
* Consumer) newImmutableMap(entriesSupplier)}.
*
* @param entriesSupplier the function which supply mappings for the returned map via
* the callback passed in
*
* @return a new immutable map with mappings consumed by the callback within the given closure
*/
@Nonnull
public static HashLongIntMap newImmutableMap(@Nonnull
Consumer entriesSupplier
) {
return getDefaultFactory().newImmutableMap(entriesSupplier);
}
/**
* Constructs a new immutable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} arrays at the same index. If {@code keys} array have
* duplicate elements, value corresponding the key with the highest index is left
* in the returned map.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(long[], int[]
* ) newImmutableMap(keys, values)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} array at the same index
*
* @return a new immutable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} arrays have different
* length
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull long[] keys, @Nonnull int[] values) {
return getDefaultFactory().newImmutableMap(keys, values);
}
/**
* Constructs a new immutable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} arrays at the same index. If {@code keys} array have
* duplicate elements, value corresponding the key with the highest index is left
* in the returned map.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(Long[],
* Integer[]) newImmutableMap(keys, values)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} array at the same index
*
* @return a new immutable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} arrays have different
* length
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Long[] keys, @Nonnull Integer[] values) {
return getDefaultFactory().newImmutableMap(keys, values);
}
/**
* Constructs a new immutable map with the given mappings, i. e. pairs of elements from
* the {@code keys} and {@code values} iterables at the same iteration position. If {@code keys}
* have duplicate elements, value corresponding the key appeared last in the iteration is left
* in the returned map.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMap(Iterable, Iterable
* ) newImmutableMap(keys, values)}.
*
* @param keys the keys of the returned map
* @param values the values of the returned map, each value is associated with the element
* of the {@code keys} iterable at the same iteration position
*
* @return a new immutable map with the given mappings
* @throws IllegalArgumentException if {@code keys} and {@code values} have different size
*/
@Nonnull
public static HashLongIntMap newImmutableMap(
@Nonnull Iterable keys, @Nonnull Iterable values
) {
return getDefaultFactory().newImmutableMap(keys, values);
}
/**
* Constructs a new immutable map of the single specified mapping.
*
* This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMapOf(long, int
* ) newImmutableMapOf(k1, v1)}.
*
* @param k1 the key of the sole mapping
* @param v1 the value of the sole mapping
* @return a new immutable map of the single specified mapping
*/
@Nonnull
public static HashLongIntMap newImmutableMapOf(
long k1, int v1) {
return getDefaultFactory().newImmutableMapOf(k1, v1);
}
/**
* Constructs a new immutable map of the two specified mappings.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMapOf(long, int,
* long, int) newImmutableMapOf(k1, v1, k2, v2)}.
*
* @param k1 the key of the first mapping
* @param v1 the value of the first mapping
* @param k2 the key of the second mapping
* @param v2 the value of the second mapping
* @return a new immutable map of the two specified mappings
*/
@Nonnull
public static HashLongIntMap newImmutableMapOf(
long k1, int v1, long k2, int v2) {
return getDefaultFactory().newImmutableMapOf(k1, v1, k2, v2);
}
/**
* Constructs a new immutable map of the three specified mappings.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMapOf(long, int,
* long, int, long, int) newImmutableMapOf(k1, v1, k2, v2,
* k3, v3)}.
*
* @param k1 the key of the first mapping
* @param v1 the value of the first mapping
* @param k2 the key of the second mapping
* @param v2 the value of the second mapping
* @param k3 the key of the third mapping
* @param v3 the value of the third mapping
* @return a new immutable map of the three specified mappings
*/
@Nonnull
public static HashLongIntMap newImmutableMapOf(
long k1, int v1, long k2, int v2,
long k3, int v3) {
return getDefaultFactory().newImmutableMapOf(k1, v1, k2, v2, k3, v3);
}
/**
* Constructs a new immutable map of the four specified mappings.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMapOf(long, int,
* long, int, long, int, long, int
* ) newImmutableMapOf(k1, v1, k2, v2, k3, v3, k4, v4)}.
*
* @param k1 the key of the first mapping
* @param v1 the value of the first mapping
* @param k2 the key of the second mapping
* @param v2 the value of the second mapping
* @param k3 the key of the third mapping
* @param v3 the value of the third mapping
* @param k4 the key of the fourth mapping
* @param v4 the value of the fourth mapping
* @return a new immutable map of the four specified mappings
*/
@Nonnull
public static HashLongIntMap newImmutableMapOf(
long k1, int v1, long k2, int v2,
long k3, int v3, long k4, int v4) {
return getDefaultFactory().newImmutableMapOf(k1, v1, k2, v2, k3, v3, k4, v4);
}
/**
* Constructs a new immutable map of the five specified mappings.
*
*
This method simply delegates to {@link #getDefaultFactory()
* }.{@link HashLongIntMapFactory#newImmutableMapOf(long, int,
* long, int, long, int, long, int,
* long, int) newImmutableMapOf(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5)}.
*
* @param k1 the key of the first mapping
* @param v1 the value of the first mapping
* @param k2 the key of the second mapping
* @param v2 the value of the second mapping
* @param k3 the key of the third mapping
* @param v3 the value of the third mapping
* @param k4 the key of the fourth mapping
* @param v4 the value of the fourth mapping
* @param k5 the key of the fifth mapping
* @param v5 the value of the fifth mapping
* @return a new immutable map of the five specified mappings
*/
@Nonnull
public static HashLongIntMap newImmutableMapOf(
long k1, int v1, long k2, int v2,
long k3, int v3, long k4, int v4,
long k5, int v5) {
return getDefaultFactory().newImmutableMapOf(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5);
}
private HashLongIntMaps() {}
}