Package org.eclipse.collections.api.map.primitive

Interface ObjectLongMap<K>

All Superinterfaces:

LongIterable, PrimitiveIterable

All Known Subinterfaces:

ImmutableObjectLongMap<K>, MutableObjectLongMap<K>

All Known Implementing Classes:

AbstractImmutableObjectLongMap, ObjectLongHashMap, ObjectLongHashMapWithHashingStrategy, SynchronizedObjectLongMap, UnmodifiableObjectLongMap

public interface ObjectLongMap<K>
extends LongIterable

This file was automatically generated from template file objectPrimitiveMap.stg.

Since:

3.0.

Method Summary

Modifier and Type	Method	Description
boolean	containsKey(Object key)	Returns whether or not the key is present in the map.
boolean	containsValue(long value)	Returns whether or not this map contains the value.
LongObjectMap<K>	flipUniqueValues()	Return the LongObjectMap that is obtained by flipping the direction of this map and making the associations from value to key.
void	forEachKey(Procedure<? super K> procedure)	Iterates through each key in the map, invoking the procedure for each.
void	forEachKeyValue(ObjectLongProcedure<? super K> procedure)	Iterates through each key/value pair in the map, invoking the procedure for each.
void	forEachValue(LongProcedure procedure)	Iterates through each value in this map.
long	get(Object key)	Retrieves the value associated with the key.
long	getIfAbsent(Object key, long ifAbsent)	Retrieves the value associated with the key, returning the specified default value if no such mapping exists.
long	getOrThrow(Object key)	Retrieves the value associated with the key, throwing an IllegalStateException if no such mapping exists.
default <IV> IV	injectIntoKeyValue(IV injectedValue, ObjectObjectLongToObjectFunction<? super IV,? super K,? extends IV> function)	Implements the injectInto pattern with each key/value pair of the map.
Set<K>	keySet()	Returns a set containing all the keys in this map.
LazyIterable<K>	keysView()	Returns a view of the keys in this map.
RichIterable<ObjectLongPair<K>>	keyValuesView()	Returns a view of the key/value pairs in this map.
ObjectLongMap<K>	reject(ObjectLongPredicate<? super K> predicate)	Return a copy of this map containing only the key/value pairs that do not match the predicate.
ObjectLongMap<K>	select(ObjectLongPredicate<? super K> predicate)	Return a copy of this map containing only the key/value pairs that match the predicate.
default ObjectLongMap<K>	tap(LongProcedure procedure)
ImmutableObjectLongMap<K>	toImmutable()	Returns a copy of this map that is immutable (if this map is mutable) or itself if it is already immutable.
String	toString()	Follows the same general contract as AbstractMap.toString()
MutableLongCollection	values()	Returns the values in this map as a separate collection.

Methods inherited from interface org.eclipse.collections.api.LongIterable

allSatisfy, anySatisfy, asLazy, average, averageIfEmpty, chunk, collect, collect, collectBoolean, collectByte, collectChar, collectDouble, collectFloat, collectInt, collectLong, collectShort, contains, containsAll, containsAll, containsAny, containsAny, containsNone, containsNone, count, detectIfNone, each, flatCollect, forEach, injectInto, injectIntoBoolean, injectIntoByte, injectIntoChar, injectIntoDouble, injectIntoFloat, injectIntoInt, injectIntoLong, injectIntoShort, longIterator, max, maxIfEmpty, median, medianIfEmpty, min, minIfEmpty, noneSatisfy, reduce, reduceIfEmpty, reject, reject, select, select, sum, summaryStatistics, toArray, toArray, toBag, toList, toSet, toSortedArray, toSortedList, toSortedList, toSortedListBy, toSortedListBy

Methods inherited from interface org.eclipse.collections.api.PrimitiveIterable

appendString, appendString, appendString, isEmpty, makeString, makeString, makeString, notEmpty, size

Method Details

get

long get(Object key)

Retrieves the value associated with the key. If no mapping exists for the key, the default value (usually 0) is returned.

Parameters:

key - the key

Returns:

the value associated with the key, or the default value if no such mapping exists

getOrThrow

long getOrThrow(Object key)

Retrieves the value associated with the key, throwing an IllegalStateException if no such mapping exists.

Parameters:

key - the key

Returns:

the value associated with the key

Throws:

IllegalStateException - if no mapping exists for the key

getIfAbsent

long getIfAbsent(Object key,
 long ifAbsent)

Retrieves the value associated with the key, returning the specified default value if no such mapping exists.

Parameters:

key - the key

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

Returns:

the value associated with the key, or ifAbsent if no such mapping exists.

containsKey

boolean containsKey(Object key)

Returns whether or not the key is present in the map.

Parameters:

key - the key

Returns:

if a mapping exists in this map for the key

containsValue

boolean containsValue(long value)

Returns whether or not this map contains the value.

Parameters:

value - the value to test

Returns:

if this collection contains the value

forEachValue

void forEachValue(LongProcedure procedure)

Iterates through each value in this map.

Parameters:

procedure - the procedure to invoke for each value in this map.

forEachKey

void forEachKey(Procedure<? super K> procedure)

Iterates through each key in the map, invoking the procedure for each.

Parameters:

procedure - the procedure to invoke for each key

forEachKeyValue

void forEachKeyValue(ObjectLongProcedure<? super K> procedure)

Iterates through each key/value pair in the map, invoking the procedure for each.

Parameters:

procedure - the procedure to invoke for each key/value pair

flipUniqueValues

LongObjectMap<K> flipUniqueValues()

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

Throws:

IllegalStateException - if the LongObjectMap contains duplicate values.

Since:

9.0

injectIntoKeyValue

default <IV> IV injectIntoKeyValue(IV injectedValue,
 ObjectObjectLongToObjectFunction<? super IV,? super K,? extends IV> function)

Implements the injectInto pattern with each key/value pair of the map.

Parameters:

value - to be injected into the map

function - to apply to the injected value and key/value pairs

Returns:

result of injecting the injectedValue into the map

Since:

11.1

select

ObjectLongMap<K> select(ObjectLongPredicate<? super K> predicate)

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

Parameters:

predicate - the predicate to determine which key/value pairs in this map should be included in the returned map

Returns:

a copy of this map with the matching key/value pairs

reject

ObjectLongMap<K> reject(ObjectLongPredicate<? super K> predicate)

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

Parameters:

predicate - the predicate to determine which key/value pairs in this map should be excluded from the returned map

Returns:

a copy of this map without the matching key/value pairs

tap

default ObjectLongMap<K> tap(LongProcedure procedure)

Specified by:

tap in interface LongIterable

Since:

9.0.

toString

String toString()

Follows the same general contract as AbstractMap.toString()

Specified by:

toString in interface PrimitiveIterable

Overrides:

toString in class Object

Returns:

a string representation of this ObjectLongMap

See Also:

• AbstractCollection.toString()

toImmutable

ImmutableObjectLongMap<K> toImmutable()

Returns a copy of this map that is immutable (if this map is mutable) or itself if it is already immutable.

Returns:

an immutable map that is equivalent to this one

keySet

Set<K> keySet()

Returns a set containing all the keys in this map. The set is backed by the map, so any modifications to the returned set will affect this map.

Returns:

a mutable set containing the keys in this map

values

MutableLongCollection values()

Returns the values in this map as a separate collection. The returned collection is backed by the map, so any changes made to the returned collection will affect the state of this map.

Returns:

the values as a collection backed by this map

keysView

LazyIterable<K> keysView()

Returns a view of the keys in this map. This iterable is backed by the map, so any modifications to the underlying map will be reflected in the keys returned by the iterable.

Returns:

a view of the keys in this map

Since:

5.0

keyValuesView

RichIterable<ObjectLongPair<K>> keyValuesView()

Returns a view of the key/value pairs in this map. This iterable is backed by the map, so any modifications to the underlying map will be reflected in the pairs returned by the iterable.

Returns:

a view of the keys in this map

Since:

5.0