com.jogamp.common.util

Class LongObjectHashMap

java.lang.Object

com.jogamp.common.util.LongObjectHashMap

All Implemented Interfaces:

Cloneable, Iterable<LongObjectHashMap.Entry>

public class LongObjectHashMap
extends Object
implements Cloneable, Iterable<LongObjectHashMap.Entry>

Fast HashMap for primitive data. Optimized for being GC friendly. Original code is based on the skorpios project released under new BSD license.

Author:

Michael Bien, Simon Goller, Sven Gothel

See Also:

IntObjectHashMap, IntLongHashMap, IntIntHashMap, LongLongHashMap, LongIntHashMap

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LongObjectHashMap.Entry An entry mapping a key to a value.

Constructor Summary

Constructors

Constructor and Description
LongObjectHashMap()
LongObjectHashMap(int initialCapacity)
LongObjectHashMap(int initialCapacity, float loadFactor)

Method Summary

Methods

Modifier and Type	Method and Description
int	capacity() Returns the current capacity (buckets) in this map.
void	clear() Clears the entire map.
Object	clone() Disclaimer: If the value type doesn't implement clone(), only the reference is copied.
boolean	containsKey(long key)
boolean	containsValue(Object value)
Object	get(long key) Returns the value to which the specified key is mapped, or getKeyNotFoundValue() if this map contains no mapping for the key.
Object	getKeyNotFoundValue() Returns the value which is returned if no value has been found for the specified key.
Iterator<LongObjectHashMap.Entry>	iterator() Returns a new Iterator.
Object	put(long key, Object value) Maps the key to the specified value.
void	putAll(LongObjectHashMap source) Copies all of the mappings from the specified map to this map.
Object	remove(long key) Removes the key-value mapping from this map.
Object	setKeyNotFoundValue(Object newKeyNotFoundValue) Sets the new key not found value.
int	size() Returns the current number of key-value mappings in this map.
String	toString()
StringBuilder	toString(StringBuilder sb)

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

LongObjectHashMap

public LongObjectHashMap()

LongObjectHashMap

public LongObjectHashMap(int initialCapacity)

LongObjectHashMap

public LongObjectHashMap(int initialCapacity,
                 float loadFactor)

Method Detail

clone

public Object clone()

Disclaimer: If the value type doesn't implement clone(), only the reference is copied. Note: Due to private fields we cannot implement a copy constructor, sorry.

Overrides:

clone in class Object

Parameters:

source - the primitive hash map to copy

containsValue

public boolean containsValue(Object value)

containsKey

public boolean containsKey(long key)

get

public Object get(long key)

Returns the value to which the specified key is mapped, or getKeyNotFoundValue() if this map contains no mapping for the key.

put

public Object put(long key,
         Object value)

Maps the key to the specified value. If a mapping to this key already exists, the previous value will be returned (otherwise getKeyNotFoundValue()).

putAll

public void putAll(LongObjectHashMap source)

Copies all of the mappings from the specified map to this map.

remove

public Object remove(long key)

Removes the key-value mapping from this map. Returns the previously mapped value or getKeyNotFoundValue() if no such mapping exists.

size

public int size()

Returns the current number of key-value mappings in this map.

capacity

public int capacity()

Returns the current capacity (buckets) in this map.

clear

public void clear()

Clears the entire map. The size is 0 after this operation.

iterator

public Iterator<LongObjectHashMap.Entry> iterator()

Returns a new Iterator. Note: this Iterator does not yet support removal of elements.

Specified by:

iterator in interface Iterable<LongObjectHashMap.Entry>

setKeyNotFoundValue

public Object setKeyNotFoundValue(Object newKeyNotFoundValue)

Sets the new key not found value. For primitive types (int, long) the default is -1, for Object types, the default is null.

Returns:

the previous key not found value

See Also:

get(long), put(long, java.lang.Object)

getKeyNotFoundValue

public Object getKeyNotFoundValue()

Returns the value which is returned if no value has been found for the specified key.

See Also:

get(long), put(long, java.lang.Object)

toString

public StringBuilder toString(StringBuilder sb)

Parameters:

sb - if null, a new StringBuilder is created

Returns:

StringBuilder instance with appended string information of this Entry

toString

public String toString()

Overrides:

toString in class Object