com.koloboke.collect.map
Interface ObjByteMapFactory<K,F extends ObjByteMapFactory<K,F>>

Type Parameters:
K - the most general key type of the maps that could be constructed by this factory
F - the concrete factory type which extends this interface
All Superinterfaces:
ContainerFactory<F>
All Known Subinterfaces:
HashObjByteMapFactory<K>

public interface ObjByteMapFactory<K,F extends ObjByteMapFactory<K,F>>
extends ContainerFactory<F>

An immutable factory of ObjByteMaps.

See Also:
ObjByteMap, @KolobokeMap

Method Summary
 byte getDefaultValue()
          Returns the value to which default value of the maps constructed by this factory is set.
 Equivalence<K> getKeyEquivalence()
          Returns the equivalence to which key equivalence of the maps constructed by this factory is set.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Consumer<ObjByteConsumer<K2>> entriesSupplier)
          Constructs a new immutable map filled with mappings consumed by the callback within the given closure.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Consumer<ObjByteConsumer<K2>> entriesSupplier, int expectedSize)
          Constructs a new immutable map filled with mappings consumed by the callback within the given closure.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Iterable<? extends K2> keys, Iterable<Byte> 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.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Iterable<? extends K2> keys, Iterable<Byte> 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.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(K2[] keys, byte[] 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.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(K2[] keys, Byte[] 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.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(K2[] keys, byte[] 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.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(K2[] keys, Byte[] 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.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Map<? extends K2,Byte> map)
          Constructs a new immutable map with the same mappings as the specified map.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Map<? extends K2,Byte> map, int expectedSize)
          Constructs a new immutable map with the same mappings as the specified map.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2)
          Constructs a new immutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, int expectedSize)
          Constructs a new immutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3)
          Constructs a new immutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, int expectedSize)
          Constructs a new immutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, Map<? extends K2,Byte> map4)
          Constructs a new immutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, Map<? extends K2,Byte> map4, int expectedSize)
          Constructs a new immutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, Map<? extends K2,Byte> map4, Map<? extends K2,Byte> map5)
          Constructs a new immutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newImmutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, Map<? extends K2,Byte> map4, Map<? extends K2,Byte> map5, int expectedSize)
          Constructs a new immutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newImmutableMapOf(K2 k1, byte v1)
          Constructs a new immutable map of the single specified mapping.
<K2 extends K>
ObjByteMap<K2>
newImmutableMapOf(K2 k1, byte v1, K2 k2, byte v2)
          Constructs a new immutable map of the two specified mappings.
<K2 extends K>
ObjByteMap<K2>
newImmutableMapOf(K2 k1, byte v1, K2 k2, byte v2, K2 k3, byte v3)
          Constructs a new immutable map of the three specified mappings.
<K2 extends K>
ObjByteMap<K2>
newImmutableMapOf(K2 k1, byte v1, K2 k2, byte v2, K2 k3, byte v3, K2 k4, byte v4)
          Constructs a new immutable map of the four specified mappings.
<K2 extends K>
ObjByteMap<K2>
newImmutableMapOf(K2 k1, byte v1, K2 k2, byte v2, K2 k3, byte v3, K2 k4, byte v4, K2 k5, byte v5)
          Constructs a new immutable map of the five specified mappings.
<K2 extends K>
ObjByteMap<K2>
newMutableMap()
          Constructs a new empty mutable map of the default expected size.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Consumer<ObjByteConsumer<K2>> entriesSupplier)
          Constructs a new mutable map filled with mappings consumed by the callback within the given closure.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Consumer<ObjByteConsumer<K2>> entriesSupplier, int expectedSize)
          Constructs a new mutable map filled with mappings consumed by the callback within the given closure.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(int expectedSize)
          Constructs a new empty mutable map of the given expected size.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Iterable<? extends K2> keys, Iterable<Byte> 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.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Iterable<? extends K2> keys, Iterable<Byte> 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.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(K2[] keys, byte[] 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.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(K2[] keys, Byte[] 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.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(K2[] keys, byte[] 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.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(K2[] keys, Byte[] 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.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Map<? extends K2,Byte> map)
          Constructs a new mutable map with the same mappings as the specified map.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Map<? extends K2,Byte> map, int expectedSize)
          Constructs a new mutable map with the same mappings as the specified map.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2)
          Constructs a new mutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, int expectedSize)
          Constructs a new mutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3)
          Constructs a new mutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, int expectedSize)
          Constructs a new mutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, Map<? extends K2,Byte> map4)
          Constructs a new mutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, Map<? extends K2,Byte> map4, int expectedSize)
          Constructs a new mutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, Map<? extends K2,Byte> map4, Map<? extends K2,Byte> map5)
          Constructs a new mutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newMutableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, Map<? extends K2,Byte> map4, Map<? extends K2,Byte> map5, int expectedSize)
          Constructs a new mutable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newMutableMapOf(K2 k1, byte v1)
          Constructs a new mutable map of the single specified mapping.
<K2 extends K>
ObjByteMap<K2>
newMutableMapOf(K2 k1, byte v1, K2 k2, byte v2)
          Constructs a new mutable map of the two specified mappings.
<K2 extends K>
ObjByteMap<K2>
newMutableMapOf(K2 k1, byte v1, K2 k2, byte v2, K2 k3, byte v3)
          Constructs a new mutable map of the three specified mappings.
<K2 extends K>
ObjByteMap<K2>
newMutableMapOf(K2 k1, byte v1, K2 k2, byte v2, K2 k3, byte v3, K2 k4, byte v4)
          Constructs a new mutable map of the four specified mappings.
<K2 extends K>
ObjByteMap<K2>
newMutableMapOf(K2 k1, byte v1, K2 k2, byte v2, K2 k3, byte v3, K2 k4, byte v4, K2 k5, byte v5)
          Constructs a new mutable map of the five specified mappings.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap()
          Constructs a new empty updatable map of the default expected size.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Consumer<ObjByteConsumer<K2>> entriesSupplier)
          Constructs a new updatable map filled with mappings consumed by the callback within the given closure.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Consumer<ObjByteConsumer<K2>> entriesSupplier, int expectedSize)
          Constructs a new updatable map filled with mappings consumed by the callback within the given closure.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(int expectedSize)
          Constructs a new empty updatable map of the given expected size.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Iterable<? extends K2> keys, Iterable<Byte> 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.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Iterable<? extends K2> keys, Iterable<Byte> 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.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(K2[] keys, byte[] 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.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(K2[] keys, Byte[] 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.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(K2[] keys, byte[] 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.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(K2[] keys, Byte[] 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.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Map<? extends K2,Byte> map)
          Constructs a new updatable map with the same mappings as the specified map.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Map<? extends K2,Byte> map, int expectedSize)
          Constructs a new updatable map with the same mappings as the specified map.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2)
          Constructs a new updatable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, int expectedSize)
          Constructs a new updatable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3)
          Constructs a new updatable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, int expectedSize)
          Constructs a new updatable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, Map<? extends K2,Byte> map4)
          Constructs a new updatable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, Map<? extends K2,Byte> map4, int expectedSize)
          Constructs a new updatable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, Map<? extends K2,Byte> map4, Map<? extends K2,Byte> map5)
          Constructs a new updatable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMap(Map<? extends K2,Byte> map1, Map<? extends K2,Byte> map2, Map<? extends K2,Byte> map3, Map<? extends K2,Byte> map4, Map<? extends K2,Byte> map5, int expectedSize)
          Constructs a new updatable map which merge the mappings of the specified maps.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMapOf(K2 k1, byte v1)
          Constructs a new updatable map of the single specified mapping.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMapOf(K2 k1, byte v1, K2 k2, byte v2)
          Constructs a new updatable map of the two specified mappings.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMapOf(K2 k1, byte v1, K2 k2, byte v2, K2 k3, byte v3)
          Constructs a new updatable map of the three specified mappings.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMapOf(K2 k1, byte v1, K2 k2, byte v2, K2 k3, byte v3, K2 k4, byte v4)
          Constructs a new updatable map of the four specified mappings.
<K2 extends K>
ObjByteMap<K2>
newUpdatableMapOf(K2 k1, byte v1, K2 k2, byte v2, K2 k3, byte v3, K2 k4, byte v4, K2 k5, byte v5)
          Constructs a new updatable map of the five specified mappings.
 F withDefaultValue(byte defaultValue)
          Returns a copy of this factory, with exception that it constructs maps with default value set to the given byte value.
 
Methods inherited from interface com.koloboke.collect.ContainerFactory
getDefaultExpectedSize, withDefaultExpectedSize
 

Method Detail

getKeyEquivalence

@Nonnull
Equivalence<K> getKeyEquivalence()
Returns the equivalence to which key equivalence of the maps constructed by this factory is set.

Returns:
the key equivalence of the maps constructed by this factory

getDefaultValue

byte getDefaultValue()
Returns the value to which default value of the maps constructed by this factory is set. Default value is (byte) 0.

Returns:
the default value of the maps constructed by this factory

withDefaultValue

@Nonnull
F withDefaultValue(byte defaultValue)
Returns a copy of this factory, with exception that it constructs maps with default value set to the given byte value.

Parameters:
defaultValue - the new default byte value
Returns:
a copy of this factory, which constructs maps with the given defaultValue

newMutableMap

@Nonnull
<K2 extends K> ObjByteMap<K2> newMutableMap()
Constructs a new empty mutable map of the default expected size.

Type Parameters:
K2 - the key type of the returned map
Returns:
a new empty mutable map

newMutableMap

@Nonnull
<K2 extends K> ObjByteMap<K2> newMutableMap(int expectedSize)
Constructs a new empty mutable map of the given expected size.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Map<? extends K2,Byte> map,
                                                    int expectedSize)
Constructs a new mutable map with the same mappings as the specified map.

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

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Map<? extends K2,Byte> map1,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Map<? extends K2,Byte> map1,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> map2,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Map<? extends K2,Byte> map1,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> map2,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> map3,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Map<? extends K2,Byte> map1,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> map2,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> map3,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> map4,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Consumer<ObjByteConsumer<K2>> 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

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    K2[] keys,
                                                    @Nonnull
                                                    byte[] 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    K2[] keys,
                                                    @Nonnull
                                                    Byte[] 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.

Type Parameters:
K2 - the key 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
NullPointerException - if values contain null elements

newMutableMap

@Nonnull
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Iterable<? extends K2> keys,
                                                    @Nonnull
                                                    Iterable<Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Map<? extends K2,Byte> map)
Constructs a new mutable map with the same mappings as the specified map.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Map<? extends K2,Byte> map1,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Map<? extends K2,Byte> map1,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> map2,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Map<? extends K2,Byte> map1,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> map2,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> map3,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Map<? extends K2,Byte> map1,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> map2,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> map3,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> map4,
                                                    @Nonnull
                                                    Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Consumer<ObjByteConsumer<K2>> 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

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    K2[] keys,
                                                    @Nonnull
                                                    byte[] 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    K2[] keys,
                                                    @Nonnull
                                                    Byte[] 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.

Type Parameters:
K2 - the key 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
NullPointerException - if values contain null elements

newMutableMap

@Nonnull
<K2 extends K> ObjByteMap<K2> newMutableMap(@Nonnull
                                                    Iterable<? extends K2> keys,
                                                    @Nonnull
                                                    Iterable<Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMapOf(K2 k1,
                                                      byte v1)
Constructs a new mutable map of the single specified mapping.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMapOf(K2 k1,
                                                      byte v1,
                                                      K2 k2,
                                                      byte v2)
Constructs a new mutable map of the two specified mappings.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMapOf(K2 k1,
                                                      byte v1,
                                                      K2 k2,
                                                      byte v2,
                                                      K2 k3,
                                                      byte v3)
Constructs a new mutable map of the three specified mappings.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMapOf(K2 k1,
                                                      byte v1,
                                                      K2 k2,
                                                      byte v2,
                                                      K2 k3,
                                                      byte v3,
                                                      K2 k4,
                                                      byte v4)
Constructs a new mutable map of the four specified mappings.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newMutableMapOf(K2 k1,
                                                      byte v1,
                                                      K2 k2,
                                                      byte v2,
                                                      K2 k3,
                                                      byte v3,
                                                      K2 k4,
                                                      byte v4,
                                                      K2 k5,
                                                      byte v5)
Constructs a new mutable map of the five specified mappings.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap()
Constructs a new empty updatable map of the default expected size.

Type Parameters:
K2 - the key type of the returned map
Returns:
a new empty updatable map

newUpdatableMap

@Nonnull
<K2 extends K> ObjByteMap<K2> newUpdatableMap(int expectedSize)
Constructs a new empty updatable map of the given expected size.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Map<? extends K2,Byte> map,
                                                      int expectedSize)
Constructs a new updatable map with the same mappings as the specified map.

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

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map2,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map2,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map3,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map2,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map3,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map4,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Consumer<ObjByteConsumer<K2>> 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

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      K2[] keys,
                                                      @Nonnull
                                                      byte[] 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      K2[] keys,
                                                      @Nonnull
                                                      Byte[] 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.

Type Parameters:
K2 - the key 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
NullPointerException - if values contain null elements

newUpdatableMap

@Nonnull
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Iterable<? extends K2> keys,
                                                      @Nonnull
                                                      Iterable<Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Map<? extends K2,Byte> map)
Constructs a new updatable map with the same mappings as the specified map.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map2,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map2,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map3,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map2,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map3,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map4,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Consumer<ObjByteConsumer<K2>> 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

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      K2[] keys,
                                                      @Nonnull
                                                      byte[] 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      K2[] keys,
                                                      @Nonnull
                                                      Byte[] 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.

Type Parameters:
K2 - the key 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
NullPointerException - if values contain null elements

newUpdatableMap

@Nonnull
<K2 extends K> ObjByteMap<K2> newUpdatableMap(@Nonnull
                                                      Iterable<? extends K2> keys,
                                                      @Nonnull
                                                      Iterable<Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMapOf(K2 k1,
                                                        byte v1)
Constructs a new updatable map of the single specified mapping.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMapOf(K2 k1,
                                                        byte v1,
                                                        K2 k2,
                                                        byte v2)
Constructs a new updatable map of the two specified mappings.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMapOf(K2 k1,
                                                        byte v1,
                                                        K2 k2,
                                                        byte v2,
                                                        K2 k3,
                                                        byte v3)
Constructs a new updatable map of the three specified mappings.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMapOf(K2 k1,
                                                        byte v1,
                                                        K2 k2,
                                                        byte v2,
                                                        K2 k3,
                                                        byte v3,
                                                        K2 k4,
                                                        byte v4)
Constructs a new updatable map of the four specified mappings.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newUpdatableMapOf(K2 k1,
                                                        byte v1,
                                                        K2 k2,
                                                        byte v2,
                                                        K2 k3,
                                                        byte v3,
                                                        K2 k4,
                                                        byte v4,
                                                        K2 k5,
                                                        byte v5)
Constructs a new updatable map of the five specified mappings.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Map<? extends K2,Byte> map,
                                                      int expectedSize)
Constructs a new immutable map with the same mappings as the specified map.

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

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map2,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map2,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map3,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map2,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map3,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map4,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Consumer<ObjByteConsumer<K2>> 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

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      K2[] keys,
                                                      @Nonnull
                                                      byte[] 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      K2[] keys,
                                                      @Nonnull
                                                      Byte[] 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.

Type Parameters:
K2 - the key 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
NullPointerException - if values contain null elements

newImmutableMap

@Nonnull
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Iterable<? extends K2> keys,
                                                      @Nonnull
                                                      Iterable<Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Map<? extends K2,Byte> map)
Constructs a new immutable map with the same mappings as the specified map.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map2,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map2,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map3,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Map<? extends K2,Byte> map1,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map2,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map3,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> map4,
                                                      @Nonnull
                                                      Map<? extends K2,Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Consumer<ObjByteConsumer<K2>> 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

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      K2[] keys,
                                                      @Nonnull
                                                      byte[] 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      K2[] keys,
                                                      @Nonnull
                                                      Byte[] 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.

Type Parameters:
K2 - the key 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
NullPointerException - if values contain null elements

newImmutableMap

@Nonnull
<K2 extends K> ObjByteMap<K2> newImmutableMap(@Nonnull
                                                      Iterable<? extends K2> keys,
                                                      @Nonnull
                                                      Iterable<Byte> 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.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMapOf(K2 k1,
                                                        byte v1)
Constructs a new immutable map of the single specified mapping.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMapOf(K2 k1,
                                                        byte v1,
                                                        K2 k2,
                                                        byte v2)
Constructs a new immutable map of the two specified mappings.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMapOf(K2 k1,
                                                        byte v1,
                                                        K2 k2,
                                                        byte v2,
                                                        K2 k3,
                                                        byte v3)
Constructs a new immutable map of the three specified mappings.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMapOf(K2 k1,
                                                        byte v1,
                                                        K2 k2,
                                                        byte v2,
                                                        K2 k3,
                                                        byte v3,
                                                        K2 k4,
                                                        byte v4)
Constructs a new immutable map of the four specified mappings.

Type Parameters:
K2 - the key 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
<K2 extends K> ObjByteMap<K2> newImmutableMapOf(K2 k1,
                                                        byte v1,
                                                        K2 k2,
                                                        byte v2,
                                                        K2 k3,
                                                        byte v3,
                                                        K2 k4,
                                                        byte v4,
                                                        K2 k5,
                                                        byte v5)
Constructs a new immutable map of the five specified mappings.

Type Parameters:
K2 - the key 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