Top Description Methods
org.eclipse.collections.api.map.primitive

public Interface MutableObjectIntMap<K>

extends ObjectIntMap<K>
Imports
org.eclipse.collections.api.block.function.primitive.IntFunction, .IntFunction0, .IntToIntFunction, .IntToObjectFunction, .ObjectIntToIntFunction, org.eclipse.collections.api.block.predicate.primitive.IntPredicate, .ObjectIntPredicate, org.eclipse.collections.api.block.procedure.primitive.IntProcedure, org.eclipse.collections.api.collection.MutableCollection, org.eclipse.collections.api.collection.primitive.MutableIntCollection, org.eclipse.collections.api.iterator.MutableIntIterator, org.eclipse.collections.api.tuple.primitive.ObjectIntPair

This file was automatically generated from template file mutableObjectPrimitiveMap.stg.
Since
3.0.

Method Summary

Modifier and TypeMethod and Description
public int
addToValue(K key, int toBeAdded)

public MutableObjectIntMap<K>
public MutableObjectIntMap<K>
public void
clear()

Removes all entries from this map.

public <V> MutableCollection<V>
collect(IntToObjectFunction<? extends V> function)

Redeclares org.eclipse.collections.api.IntIterable.collect.

Returns a new collection with the results of applying the specified function on each element of the source collection.

public MutableIntObjectMap<K>
flipUniqueValues()

Redeclares org.eclipse.collections.api.map.primitive.ObjectIntMap.flipUniqueValues.

Return the IntObjectMap that is obtained by flipping the direction of this map and making the associations from value to key.

public default int

Returns:

the value associated with key, if one exists, or defaultValue if not
getAndPut
(K
the key
key
,
int
the value to associate with key if no such mapping exists
putValue
,
int
the value to return if no mapping associated with key exists
defaultValue
)

Retrieves the value associated with the key if one exists; if it does not, associates a putValue with the key.

public int

Returns:

the value associated with key, if one exists, or value if not
getIfAbsentPut
(K
the key
key
,
int
the value to associate with key if no such mapping exists
value
)

Retrieves the value associated with the key if one exists; if it does not, associates a value with the key.

public int

Returns:

the value associated with the key, if one exists, or the result of invoking function if not
getIfAbsentPut
(K
the key
key
,
IntFunction0
the supplier that provides the value if no mapping exists for key
function
)

Retrieves the value associated with the key if one exists; if it does not, invokes the supplier and associates the result with the key.

public <
the type of the value function's parameter
P
>
int

Returns:

the value associated with the key, if one exists, or the result of invoking function with parameter if not
getIfAbsentPutWith
(K
the key
key
,
IntFunction<? super P>
the function that provides the value if no mapping exists. The specified parameter will be passed as the argument to the function.
function
,
P
the parameter to provide to function if no value exists for key
parameter
)

Retrieves the value associated with the key if one exists; if it does not, invokes the value function with the parameter and associates the result with the key.

public int

Returns:

the value associated with the key, if one exists, or the result of invoking function with key if not
getIfAbsentPutWithKey
(K
the key
key
,
IntFunction<? super K>
the function that provides the value if no mapping exists. The key will be passed as the argument to the function.
function
)

Retrieves the value associated with the key if one exists; if it does not, associates the result of invoking the value function with the key.

public MutableIntIterator
intIterator()

Redeclares org.eclipse.collections.api.IntIterable.intIterator.

Returns a primitive iterator that can be used to iterate over the IntIterable in an imperative style.

public void
put(K
the key
key
,
int
the value to associate with value
value
)

Associates a value with the specified key.

public void
putAll(ObjectIntMap<? extends K>
the map to copy into this map
map
)

Puts all of the key/value mappings from the specified map into this map.

public default void
putPair(ObjectIntPair<K> keyValuePair)

This method allows MutableObjectIntMap the ability to add an element in the form of ObjectIntPair<K>.

public MutableObjectIntMap<K>
reject(ObjectIntPredicate<? super K> predicate)

Redeclares org.eclipse.collections.api.map.primitive.ObjectIntMap.reject.

Return a copy of this map containing only the key/value pairs that do not match the predicate.

public MutableIntCollection
reject(IntPredicate predicate)

Redeclares org.eclipse.collections.api.IntIterable.reject.

Returns a new IntIterable with all of the elements in the IntIterable that return false for the specified predicate.

public void
remove(Object
the key to remove
key
)

Removes the mapping associated with the key, if one exists, from the map.

public void
removeKey(K
the key to remove
key
)

Removes the mapping associated with the key, if one exists, from the map.

public int

Returns:

the value previously associated with the key, if one existed, or value if not
removeKeyIfAbsent
(K
the key to remove
key
,
int
the default value to return if no mapping for the key exists
value
)

Removes the mapping associated with the key, if one exists, from the map, returning the previously associated value with the key.

public MutableObjectIntMap<K>
select(ObjectIntPredicate<? super K> predicate)

Redeclares org.eclipse.collections.api.map.primitive.ObjectIntMap.select.

Return a copy of this map containing only the key/value pairs that match the predicate.

public MutableIntCollection
select(IntPredicate predicate)

Redeclares org.eclipse.collections.api.IntIterable.select.

Returns a new IntIterable with all of the elements in the IntIterable that return true for the specified predicate.

public default MutableObjectIntMap<K>
public int

Returns:

the new value associated with the key, either as a result of applying function to the value already associated with the key or as a result of applying it to initialValueIfAbsent and associating the result with key
updateValue
(K
the key
key
,
int
the initial value to supply to the function if no mapping exists for the key
initialValueIfAbsent
,
IntToIntFunction
the function that returns the updated value based on the current value or the initial value, if no value exists
function
)

Updates or sets the value associated with the key by applying the function to the existing value, if one exists, or to the specified initial value if one does not.

public void
updateValues(ObjectIntToIntFunction<? super K>
that takes a key and its value and that returns a new value for this key
function
)

Updates the values in-place.

public default MutableObjectIntMap<K>
public MutableObjectIntMap<K>

Returns:

this map
withKeyValue
(K
the key
key
,
int
the value to associate with value
value
)

Associates a value with the specified key.

public MutableObjectIntMap<K>

Returns:

this map
withoutAllKeys
(Iterable<? extends K>
the keys to remove
keys
)

Removes the mappings associated with all the keys, if they exist, from this map.

public MutableObjectIntMap<K>

Returns:

this map
withoutKey
(K
the key to remove
key
)

Removes the mapping associated with the key, if one exists, from this map.

Inherited from org.eclipse.collections.api.map.primitive.ObjectIntMap:
allSatisfyKeyValuecontainsKeycontainsValueforEachKeyforEachKeyValueforEachValuegetgetIfAbsentgetOrThrowinjectIntoKeyValuekeySetkeysViewkeyValuesViewtoImmutabletoStringvalues

Method Detail

addToValueback to summary
public int addToValue(K key, int toBeAdded)
asSynchronizedback to summary
public MutableObjectIntMap<K> asSynchronized()
asUnmodifiableback to summary
public MutableObjectIntMap<K> asUnmodifiable()
clearback to summary
public void clear()

Removes all entries from this map.

collectback to summary
public <V> MutableCollection<V> collect(IntToObjectFunction<? extends V> function)

Redeclares org.eclipse.collections.api.IntIterable.collect.

Doc from org.eclipse.collections.api.IntIterable.collect.

Returns a new collection with the results of applying the specified function on each element of the source collection. This method is also commonly called transform or map.

Annotations
@Override
flipUniqueValuesback to summary
public MutableIntObjectMap<K> flipUniqueValues()

Redeclares org.eclipse.collections.api.map.primitive.ObjectIntMap.flipUniqueValues.

Doc from org.eclipse.collections.api.map.primitive.ObjectIntMap.flipUniqueValues.

Return the IntObjectMap that is obtained by flipping the direction of this map and making the associations from value to key.

Annotations
@Override
getAndPutback to summary
public default int getAndPut(K key, int putValue, int defaultValue)

Retrieves the value associated with the key if one exists; if it does not, associates a putValue with the key.

Parameters
key:K

the key

putValue:int

the value to associate with key if no such mapping exists

defaultValue:int

the value to return if no mapping associated with key exists

Returns:int

the value associated with key, if one exists, or defaultValue if not

Since
11.1.
getIfAbsentPutback to summary
public int getIfAbsentPut(K key, int value)

Retrieves the value associated with the key if one exists; if it does not, associates a value with the key. a new value with they key

Parameters
key:K

the key

value:int

the value to associate with key if no such mapping exists

Returns:int

the value associated with key, if one exists, or value if not

getIfAbsentPutback to summary
public int getIfAbsentPut(K key, IntFunction0 function)

Retrieves the value associated with the key if one exists; if it does not, invokes the supplier and associates the result with the key.

Parameters
key:K

the key

function:IntFunction0

the supplier that provides the value if no mapping exists for key

Returns:int

the value associated with the key, if one exists, or the result of invoking function if not

getIfAbsentPutWithback to summary
public <P> int getIfAbsentPutWith(K key, IntFunction<? super P> function, P parameter)

Retrieves the value associated with the key if one exists; if it does not, invokes the value function with the parameter and associates the result with the key.

Parameters
<P>
the type of the value function's parameter
key:K

the key

function:IntFunction<? super P>

the function that provides the value if no mapping exists. The specified parameter will be passed as the argument to the function.

parameter:P

the parameter to provide to function if no value exists for key

Returns:int

the value associated with the key, if one exists, or the result of invoking function with parameter if not

getIfAbsentPutWithKeyback to summary
public int getIfAbsentPutWithKey(K key, IntFunction<? super K> function)

Retrieves the value associated with the key if one exists; if it does not, associates the result of invoking the value function with the key.

Parameters
key:K

the key

function:IntFunction<? super K>

the function that provides the value if no mapping exists. The key will be passed as the argument to the function.

Returns:int

the value associated with the key, if one exists, or the result of invoking function with key if not

intIteratorback to summary
public MutableIntIterator intIterator()

Redeclares org.eclipse.collections.api.IntIterable.intIterator.

Doc from org.eclipse.collections.api.IntIterable.intIterator.

Returns a primitive iterator that can be used to iterate over the IntIterable in an imperative style.

Annotations
@Override
putback to summary
public void put(K key, int value)

Associates a value with the specified key. If a value is already associated with the key in this map, it will be replaced with value.

Parameters
key:K

the key

value:int

the value to associate with value

putAllback to summary
public void putAll(ObjectIntMap<? extends K> map)

Puts all of the key/value mappings from the specified map into this map. If this map already has a value associated with one of the keys in the map, it will be replaced with the value in map.

Parameters
map:ObjectIntMap<? extends K>

the map to copy into this map

putPairback to summary
public default void putPair(ObjectIntPair<K> keyValuePair)

This method allows MutableObjectIntMap the ability to add an element in the form of ObjectIntPair<K>.

Since
9.1.0
See Also
put(Object, int)
rejectback to summary
public MutableObjectIntMap<K> reject(ObjectIntPredicate<? super K> predicate)

Redeclares org.eclipse.collections.api.map.primitive.ObjectIntMap.reject.

Doc from org.eclipse.collections.api.map.primitive.ObjectIntMap.reject.

Return a copy of this map containing only the key/value pairs that do not match the predicate.

Annotations
@Override
rejectback to summary
public MutableIntCollection reject(IntPredicate predicate)

Redeclares org.eclipse.collections.api.IntIterable.reject.

Doc from org.eclipse.collections.api.IntIterable.reject.

Returns a new IntIterable with all of the elements in the IntIterable that return false for the specified predicate.

Annotations
@Override
removeback to summary
public void remove(Object key)

Removes the mapping associated with the key, if one exists, from the map.

Parameters
key:Object

the key to remove

See Also
removeKey(K)
removeKeyback to summary
public void removeKey(K key)

Removes the mapping associated with the key, if one exists, from the map.

Parameters
key:K

the key to remove

See Also
remove(Object)
removeKeyIfAbsentback to summary
public int removeKeyIfAbsent(K key, int value)

Removes the mapping associated with the key, if one exists, from the map, returning the previously associated value with the key. If no mapping existed for the key, the specified default value is returned.

Parameters
key:K

the key to remove

value:int

the default value to return if no mapping for the key exists

Returns:int

the value previously associated with the key, if one existed, or value if not

selectback to summary
public MutableObjectIntMap<K> select(ObjectIntPredicate<? super K> predicate)

Redeclares org.eclipse.collections.api.map.primitive.ObjectIntMap.select.

Doc from org.eclipse.collections.api.map.primitive.ObjectIntMap.select.

Return a copy of this map containing only the key/value pairs that match the predicate.

Annotations
@Override
selectback to summary
public MutableIntCollection select(IntPredicate predicate)

Redeclares org.eclipse.collections.api.IntIterable.select.

Doc from org.eclipse.collections.api.IntIterable.select.

Returns a new IntIterable with all of the elements in the IntIterable that return true for the specified predicate.

Annotations
@Override
tapback to summary
public default MutableObjectIntMap<K> tap(IntProcedure procedure)

Overrides default org.eclipse.collections.api.map.primitive.ObjectIntMap.tap.

Annotations
@Override
Since
9.0.
updateValueback to summary
public int updateValue(K key, int initialValueIfAbsent, IntToIntFunction function)

Updates or sets the value associated with the key by applying the function to the existing value, if one exists, or to the specified initial value if one does not.

Parameters
key:K

the key

initialValueIfAbsent:int

the initial value to supply to the function if no mapping exists for the key

function:IntToIntFunction

the function that returns the updated value based on the current value or the initial value, if no value exists

Returns:int

the new value associated with the key, either as a result of applying function to the value already associated with the key or as a result of applying it to initialValueIfAbsent and associating the result with key

updateValuesback to summary
public void updateValues(ObjectIntToIntFunction<? super K> function)

Updates the values in-place.

Parameters
function:ObjectIntToIntFunction<? super K>

that takes a key and its value and that returns a new value for this key

Since
10.0
withAllKeyValuesback to summary
public default MutableObjectIntMap<K> withAllKeyValues(Iterable<ObjectIntPair<K>> keyValuePairs)
withKeyValueback to summary
public MutableObjectIntMap<K> withKeyValue(K key, int value)

Associates a value with the specified key. If a value is already associated with the key in this map, it will be replaced with value.

Parameters
key:K

the key

value:int

the value to associate with value

Returns:MutableObjectIntMap<K>

this map

See Also
put(K, int)
withoutAllKeysback to summary
public MutableObjectIntMap<K> withoutAllKeys(Iterable<? extends K> keys)

Removes the mappings associated with all the keys, if they exist, from this map.

Parameters
keys:Iterable<? extends K>

the keys to remove

Returns:MutableObjectIntMap<K>

this map

See Also
remove(Object)
withoutKeyback to summary
public MutableObjectIntMap<K> withoutKey(K key)

Removes the mapping associated with the key, if one exists, from this map.

Parameters
key:K

the key to remove

Returns:MutableObjectIntMap<K>

this map

See Also
remove(Object)