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

public Interface MutableObjectCharMap<K>

extends ObjectCharMap<K>
Imports
org.eclipse.collections.api.block.function.primitive.CharFunction, .CharFunction0, .CharToCharFunction, .CharToObjectFunction, .ObjectCharToCharFunction, org.eclipse.collections.api.block.predicate.primitive.CharPredicate, .ObjectCharPredicate, org.eclipse.collections.api.block.procedure.primitive.CharProcedure, org.eclipse.collections.api.collection.MutableCollection, org.eclipse.collections.api.collection.primitive.MutableCharCollection, org.eclipse.collections.api.iterator.MutableCharIterator, org.eclipse.collections.api.tuple.primitive.ObjectCharPair

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

Method Summary

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

public MutableObjectCharMap<K>
public MutableObjectCharMap<K>
public MutableCharIterator
charIterator()

Redeclares org.eclipse.collections.api.CharIterable.charIterator.

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

public void
clear()

Removes all entries from this map.

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

Redeclares org.eclipse.collections.api.CharIterable.collect.

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

public MutableCharObjectMap<K>
flipUniqueValues()

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

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

public default char

Returns:

the value associated with key, if one exists, or defaultValue if not
getAndPut
(K
the key
key
,
char
the value to associate with key if no such mapping exists
putValue
,
char
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 char

Returns:

the value associated with key, if one exists, or value if not
getIfAbsentPut
(K
the key
key
,
char
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 char

Returns:

the value associated with the key, if one exists, or the result of invoking function if not
getIfAbsentPut
(K
the key
key
,
CharFunction0
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
>
char

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
,
CharFunction<? 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 char

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
,
CharFunction<? 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 void
put(K
the key
key
,
char
the value to associate with value
value
)

Associates a value with the specified key.

public void
putAll(ObjectCharMap<? 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(ObjectCharPair<K> keyValuePair)

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

public MutableObjectCharMap<K>
reject(ObjectCharPredicate<? super K> predicate)

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

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

public MutableCharCollection
reject(CharPredicate predicate)

Redeclares org.eclipse.collections.api.CharIterable.reject.

Returns a new CharIterable with all of the elements in the CharIterable 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 char

Returns:

the value previously associated with the key, if one existed, or value if not
removeKeyIfAbsent
(K
the key to remove
key
,
char
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 MutableObjectCharMap<K>
select(ObjectCharPredicate<? super K> predicate)

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

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

public MutableCharCollection
select(CharPredicate predicate)

Redeclares org.eclipse.collections.api.CharIterable.select.

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

public default MutableObjectCharMap<K>
public char

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
,
char
the initial value to supply to the function if no mapping exists for the key
initialValueIfAbsent
,
CharToCharFunction
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(ObjectCharToCharFunction<? 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 MutableObjectCharMap<K>
public MutableObjectCharMap<K>

Returns:

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

Associates a value with the specified key.

public MutableObjectCharMap<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 MutableObjectCharMap<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.ObjectCharMap:
allSatisfyKeyValuecontainsKeycontainsValueforEachKeyforEachKeyValueforEachValuegetgetIfAbsentgetOrThrowinjectIntoKeyValuekeySetkeysViewkeyValuesViewtoImmutabletoStringvalues

Method Detail

addToValueback to summary
public char addToValue(K key, char toBeAdded)
asSynchronizedback to summary
public MutableObjectCharMap<K> asSynchronized()
asUnmodifiableback to summary
public MutableObjectCharMap<K> asUnmodifiable()
charIteratorback to summary
public MutableCharIterator charIterator()

Redeclares org.eclipse.collections.api.CharIterable.charIterator.

Doc from org.eclipse.collections.api.CharIterable.charIterator.

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

Annotations
@Override
clearback to summary
public void clear()

Removes all entries from this map.

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

Redeclares org.eclipse.collections.api.CharIterable.collect.

Doc from org.eclipse.collections.api.CharIterable.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 MutableCharObjectMap<K> flipUniqueValues()

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

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

Return the CharObjectMap 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 char getAndPut(K key, char putValue, char 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:char

the value to associate with key if no such mapping exists

defaultValue:char

the value to return if no mapping associated with key exists

Returns:char

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

Since
11.1.
getIfAbsentPutback to summary
public char getIfAbsentPut(K key, char 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:char

the value to associate with key if no such mapping exists

Returns:char

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

getIfAbsentPutback to summary
public char getIfAbsentPut(K key, CharFunction0 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:CharFunction0

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

Returns:char

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

getIfAbsentPutWithback to summary
public <P> char getIfAbsentPutWith(K key, CharFunction<? 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:CharFunction<? 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:char

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

getIfAbsentPutWithKeyback to summary
public char getIfAbsentPutWithKey(K key, CharFunction<? 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:CharFunction<? super K>

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

Returns:char

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

putback to summary
public void put(K key, char 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:char

the value to associate with value

putAllback to summary
public void putAll(ObjectCharMap<? 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:ObjectCharMap<? extends K>

the map to copy into this map

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

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

Since
9.1.0
See Also
put(Object, char)
rejectback to summary
public MutableObjectCharMap<K> reject(ObjectCharPredicate<? super K> predicate)

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

Doc from org.eclipse.collections.api.map.primitive.ObjectCharMap.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 MutableCharCollection reject(CharPredicate predicate)

Redeclares org.eclipse.collections.api.CharIterable.reject.

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

Returns a new CharIterable with all of the elements in the CharIterable 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 char removeKeyIfAbsent(K key, char 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:char

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

Returns:char

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

selectback to summary
public MutableObjectCharMap<K> select(ObjectCharPredicate<? super K> predicate)

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

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

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

Annotations
@Override
selectback to summary
public MutableCharCollection select(CharPredicate predicate)

Redeclares org.eclipse.collections.api.CharIterable.select.

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

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

Annotations
@Override
tapback to summary
public default MutableObjectCharMap<K> tap(CharProcedure procedure)

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

Annotations
@Override
Since
9.0.
updateValueback to summary
public char updateValue(K key, char initialValueIfAbsent, CharToCharFunction 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:char

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

function:CharToCharFunction

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

Returns:char

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(ObjectCharToCharFunction<? super K> function)

Updates the values in-place.

Parameters
function:ObjectCharToCharFunction<? 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 MutableObjectCharMap<K> withAllKeyValues(Iterable<ObjectCharPair<K>> keyValuePairs)
withKeyValueback to summary
public MutableObjectCharMap<K> withKeyValue(K key, char 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:char

the value to associate with value

Returns:MutableObjectCharMap<K>

this map

See Also
put(K, char)
withoutAllKeysback to summary
public MutableObjectCharMap<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:MutableObjectCharMap<K>

this map

See Also
remove(Object)
withoutKeyback to summary
public MutableObjectCharMap<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:MutableObjectCharMap<K>

this map

See Also
remove(Object)