gnu.trove

Class TLongHashSet

java.lang.Object

gnu.trove.THash

gnu.trove.TPrimitiveHash

gnu.trove.TLongHash

gnu.trove.TLongHashSet

All Implemented Interfaces:

TLongHashingStrategy, Serializable, Cloneable

public class TLongHashSet
extends TLongHash
implements Serializable

An open addressed set implementation for long primitives. Created: Sat Nov 3 10:38:17 2001

Version:

$Id: TLongHashSet.java,v 1.3 2004/11/24 20:00:00 casutton Exp $

Author:

Eric D. Friedman

See Also:

Serialized Form

Field Summary

Fields inherited from class gnu.trove.TLongHash

_set

Fields inherited from class gnu.trove.TPrimitiveHash

_states, FREE, FULL, REMOVED

Fields inherited from class gnu.trove.THash

_free, _loadFactor, _maxSize, _size, DEFAULT_INITIAL_CAPACITY, DEFAULT_LOAD_FACTOR

Constructor Summary

Constructors

Constructor and Description
TLongHashSet() Creates a new TLongHashSet instance with the default capacity and load factor.
TLongHashSet(int initialCapacity) Creates a new TLongHashSet instance with a prime capacity equal to or greater than initialCapacity and with the default load factor.
TLongHashSet(int initialCapacity, float loadFactor) Creates a new TLongHashSet instance with a prime capacity equal to or greater than initialCapacity and with the specified load factor.
TLongHashSet(int initialCapacity, float loadFactor, TLongHashingStrategy strategy) Creates a new TLongHash instance with a prime value at or near the specified capacity and load factor.
TLongHashSet(int initialCapacity, TLongHashingStrategy strategy) Creates a new TLongHash instance whose capacity is the next highest prime above initialCapacity + 1 unless that value is already prime.
TLongHashSet(long[] array) Creates a new TLongHashSet instance containing the elements of array.
TLongHashSet(long[] array, TLongHashingStrategy strategy) Creates a new TLongHashSet instance containing the elements of array.
TLongHashSet(TLongHashingStrategy strategy) Creates a new TLongHash instance with the default capacity and load factor.

Method Summary

Modifier and Type	Method and Description
boolean	add(long val) Inserts a value into the set.
boolean	addAll(long[] array) Adds all of the elements in array to the set.
void	clear() Empties the set.
boolean	containsAll(long[] array) Tests the set to determine if all of the elements in array are present.
boolean	equals(Object other) Compares this set with another set for equality of their stored entries.
TLongIterator	iterator()
protected void	rehash(int newCapacity) Expands the set to accomodate new values.
boolean	remove(long val) Removes val from the set.
boolean	removeAll(long[] array) Removes all of the elements in array from the set.
boolean	retainAll(long[] array) Removes any values in the set which are not contained in array.
long[]	toArray() Returns a new array containing the values in the set.

Methods inherited from class gnu.trove.TLongHash

clone, computeHashCode, contains, forEach, index, insertionIndex, removeAt, setUp

Methods inherited from class gnu.trove.TPrimitiveHash

capacity

Methods inherited from class gnu.trove.THash

compact, ensureCapacity, isEmpty, postInsertHook, size, trimToSize

Methods inherited from class java.lang.Object

finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TLongHashSet

public TLongHashSet()

Creates a new TLongHashSet instance with the default capacity and load factor.

TLongHashSet

public TLongHashSet(int initialCapacity)

Creates a new TLongHashSet instance with a prime capacity equal to or greater than initialCapacity and with the default load factor.

Parameters:

initialCapacity - an int value

TLongHashSet

public TLongHashSet(int initialCapacity,
                    float loadFactor)

Creates a new TLongHashSet instance with a prime capacity equal to or greater than initialCapacity and with the specified load factor.

Parameters:

initialCapacity - an int value

loadFactor - a float value

TLongHashSet

public TLongHashSet(long[] array)

Creates a new TLongHashSet instance containing the elements of array.

Parameters:

array - an array of long primitives

TLongHashSet

public TLongHashSet(TLongHashingStrategy strategy)

Creates a new TLongHash instance with the default capacity and load factor.

Parameters:

strategy - used to compute hash codes and to compare keys.

TLongHashSet

public TLongHashSet(int initialCapacity,
                    TLongHashingStrategy strategy)

Creates a new TLongHash instance whose capacity is the next highest prime above initialCapacity + 1 unless that value is already prime.

Parameters:

initialCapacity - an int value

strategy - used to compute hash codes and to compare keys.

TLongHashSet

public TLongHashSet(int initialCapacity,
                    float loadFactor,
                    TLongHashingStrategy strategy)

Creates a new TLongHash instance with a prime value at or near the specified capacity and load factor.

Parameters:

initialCapacity - used to find a prime capacity for the table.

loadFactor - used to calculate the threshold over which rehashing takes place.

strategy - used to compute hash codes and to compare keys.

TLongHashSet

public TLongHashSet(long[] array,
                    TLongHashingStrategy strategy)

Creates a new TLongHashSet instance containing the elements of array.

Parameters:

array - an array of long primitives

strategy - used to compute hash codes and to compare keys.

Method Detail

iterator

public TLongIterator iterator()

Returns:

a TLongIterator with access to the values in this set

add

public boolean add(long val)

Inserts a value into the set.

Parameters:

val - an long value

Returns:

true if the set was modified by the add operation

rehash

protected void rehash(int newCapacity)

Expands the set to accomodate new values.

Specified by:

rehash in class THash

Parameters:

newCapacity - an int value

toArray

public long[] toArray()

Returns a new array containing the values in the set.

Returns:

an long[] value

clear

public void clear()

Empties the set.

Overrides:

clear in class THash

equals

public boolean equals(Object other)

Compares this set with another set for equality of their stored entries.

Overrides:

equals in class Object

Parameters:

other - an Object value

Returns:

a boolean value

remove

public boolean remove(long val)

Removes val from the set.

Parameters:

val - an long value

Returns:

true if the set was modified by the remove operation.

containsAll

public boolean containsAll(long[] array)

Tests the set to determine if all of the elements in array are present.

Parameters:

array - an array of long primitives.

Returns:

true if all elements were present in the set.

addAll

public boolean addAll(long[] array)

Adds all of the elements in array to the set.

Parameters:

array - an array of long primitives.

Returns:

true if the set was modified by the add all operation.

removeAll

public boolean removeAll(long[] array)

Removes all of the elements in array from the set.

Parameters:

array - an array of long primitives.

Returns:

true if the set was modified by the remove all operation.

retainAll

public boolean retainAll(long[] array)

Removes any values in the set which are not contained in array.

Parameters:

array - an array of long primitives.

Returns:

true if the set was modified by the retain all operation