com.carrotsearch.hppcrt.maps

Class ObjectCharIdentityHashMap<KType>

java.lang.Object

com.carrotsearch.hppcrt.maps.ObjectCharHashMap<KType>

com.carrotsearch.hppcrt.maps.ObjectCharIdentityHashMap<KType>

All Implemented Interfaces:

ObjectCharAssociativeContainer<KType>, ObjectCharMap<KType>, java.lang.Cloneable, java.lang.Iterable<ObjectCharCursor<KType>>

@Generated(date="2017-07-11T19:16:32+0200",
           value="KTypeVTypeIdentityHashMap.java")
public class ObjectCharIdentityHashMap<KType>
extends ObjectCharHashMap<KType>

An identity hash map of Object to char, implemented using open addressing with linear probing for collision resolution. The difference with ObjectCharHashMap is that it uses direct Object reference equality for comparison and direct "address" System.identityHashCode(Object) for hashCode(), instead of using the built-in ObjectCharHashMap.hashCode() / ObjectCharHashMap.equals(Object).

This implementation supports null keys.

Nested Class Summary

Nested classes/interfaces inherited from class com.carrotsearch.hppcrt.maps.ObjectCharHashMap

ObjectCharHashMap.EntryIterator, ObjectCharHashMap.KeysCollection, ObjectCharHashMap.KeysIterator, ObjectCharHashMap.ValuesCollection, ObjectCharHashMap.ValuesIterator

Field Summary

Fields inherited from class com.carrotsearch.hppcrt.maps.ObjectCharHashMap

allocatedDefaultKey, allocatedDefaultKeyValue, assigned, defaultValue, entryIteratorPool, hash_cache, keys, loadFactor, values

Constructor Summary

Constructors

Constructor and Description
ObjectCharIdentityHashMap() Default constructor: Creates a hash map with the default capacity of Containers.DEFAULT_EXPECTED_ELEMENTS, load factor of HashContainers.DEFAULT_LOAD_FACTOR.
ObjectCharIdentityHashMap(int initialCapacity) Creates a hash map with the given initial capacity, default load factor of HashContainers.DEFAULT_LOAD_FACTOR.
ObjectCharIdentityHashMap(int initialCapacity, double loadFactor) Creates a hash map with the given initial capacity, load factor.
ObjectCharIdentityHashMap(ObjectCharAssociativeContainer<KType> container) Create a hash map from all key-value pairs of another container.

Method Summary

Modifier and Type	Method and Description
ObjectCharIdentityHashMap<KType>	clone()
protected boolean	equalKeys(KType a, KType b) Equality customization to only consider object identity, comparing instances directly by ==.
static <KType> ObjectCharIdentityHashMap<KType>	from(KType[] keys, char[] values) Creates a hash map from two index-aligned arrays of key-value pairs.
static <KType> ObjectCharIdentityHashMap<KType>	from(ObjectCharAssociativeContainer<KType> container) Create a hash map from another associative container.
protected int	hashKey(KType key) Hash customization to only consider the identity hash code.
static <KType> ObjectCharIdentityHashMap<KType>	newInstance() Create a new hash map without providing the full generic signature (constructor shortcut).
static <KType> ObjectCharIdentityHashMap<KType>	newInstance(int initialCapacity, double loadFactor) Create a new hash map with initial capacity and load factor control.

Methods inherited from class com.carrotsearch.hppcrt.maps.ObjectCharHashMap

addTo, capacity, clear, containsKey, equals, forEach, forEach, get, getDefaultValue, hashCode, isEmpty, iterator, keys, put, putAll, putAll, putIfAbsent, putOrAdd, remove, removeAll, removeAll, removeAll, setDefaultValue, size, toString, values

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

ObjectCharIdentityHashMap

public ObjectCharIdentityHashMap()

Default constructor: Creates a hash map with the default capacity of Containers.DEFAULT_EXPECTED_ELEMENTS, load factor of HashContainers.DEFAULT_LOAD_FACTOR.

See class notes about hash distribution importance.

ObjectCharIdentityHashMap

public ObjectCharIdentityHashMap(int initialCapacity)

Creates a hash map with the given initial capacity, default load factor of HashContainers.DEFAULT_LOAD_FACTOR.

Parameters:

initialCapacity - Initial capacity (greater than zero and automatically rounded to the next power of two).

ObjectCharIdentityHashMap

public ObjectCharIdentityHashMap(int initialCapacity,
                                 double loadFactor)

Creates a hash map with the given initial capacity, load factor.

Parameters:

initialCapacity - Initial capacity (greater than zero and automatically rounded to the next power of two).

loadFactor - The load factor (greater than zero and smaller than 1).

ObjectCharIdentityHashMap

public ObjectCharIdentityHashMap(ObjectCharAssociativeContainer<KType> container)

Create a hash map from all key-value pairs of another container.

Method Detail

hashKey

protected int hashKey(KType key)

Hash customization to only consider the identity hash code.

Overrides:

hashKey in class ObjectCharHashMap<KType>

Parameters:

key - Object to be hashed.

Returns:

the hashed value of key, following the same semantic as ObjectCharHashMap.hashCode();

See Also:

ObjectCharHashMap.hashCode(), ObjectCharHashMap.equalKeys(Object, Object)

equalKeys

protected boolean equalKeys(KType a,
                            KType b)

Equality customization to only consider object identity, comparing instances directly by ==.

Overrides:

equalKeys in class ObjectCharHashMap<KType>

Parameters:

a - not-null Object to be compared

b - not-null Object to be compared

Returns:

true if a and b are considered equal, following the same semantic as ObjectCharHashMap.equals(Object).

See Also:

ObjectCharHashMap.equals(Object), ObjectCharHashMap.hashKey(Object)

clone

public ObjectCharIdentityHashMap<KType> clone()

Description copied from class: ObjectCharHashMap

Overrides:

clone in class ObjectCharHashMap<KType>

from

public static <KType> ObjectCharIdentityHashMap<KType> from(KType[] keys,
                                                            char[] values)

Creates a hash map from two index-aligned arrays of key-value pairs.

from

public static <KType> ObjectCharIdentityHashMap<KType> from(ObjectCharAssociativeContainer<KType> container)

Create a hash map from another associative container.

newInstance

public static <KType> ObjectCharIdentityHashMap<KType> newInstance()

Create a new hash map without providing the full generic signature (constructor shortcut).

newInstance

public static <KType> ObjectCharIdentityHashMap<KType> newInstance(int initialCapacity,
                                                                   double loadFactor)

Create a new hash map with initial capacity and load factor control. (constructor shortcut).