Class UnifiedSet<T>

java.lang.Object

org.eclipse.collections.impl.AbstractRichIterable<T>

org.eclipse.collections.impl.collection.mutable.AbstractMutableCollection<T>

org.eclipse.collections.impl.set.AbstractUnifiedSet<T>

org.eclipse.collections.impl.set.mutable.UnifiedSet<T>

All Implemented Interfaces:

Externalizable, Serializable, Cloneable, Iterable<T>, Collection<T>, Set<T>, MutableCollection<T>, InternalIterable<T>, RichIterable<T>, MutableSet<T>, MutableSetIterable<T>, Pool<T>, SetIterable<T>, UnsortedSetIterable<T>, BatchIterable<T>

public class UnifiedSet<T>
extends AbstractUnifiedSet<T>
implements Externalizable

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	UnifiedSet.ChainedBucket
protected class	UnifiedSet.PositionalIterator
private final class	UnifiedSet.UnifiedSetParallelUnsortedIterable
private final class	UnifiedSet.UnifiedUnsortedSetBatch

Field Summary

Fields

Modifier and Type	Field	Description
protected static final Object	NULL_KEY
protected int	occupied
private static final long	serialVersionUID
protected Object[]	table

Fields inherited from class AbstractUnifiedSet

DEFAULT_INITIAL_CAPACITY, DEFAULT_LOAD_FACTOR, loadFactor, maxSize

Constructor Summary

Constructors

Constructor	Description
UnifiedSet()
UnifiedSet(int initialCapacity)
UnifiedSet(int initialCapacity, float loadFactor)
UnifiedSet(Collection<? extends T> collection)
UnifiedSet(UnifiedSet<T> set)

Method Summary

Modifier and Type	Method	Description
boolean	add(T key)
boolean	addAllIterable(Iterable<? extends T> iterable)
private void	addForTrim(Object key, int oldIndex, int mask)
private void	addIfFound(T key, UnifiedSet<T> other)
private void	addIfFoundFromChain(UnifiedSet.ChainedBucket bucket, T key, UnifiedSet<T> other)
protected void	allocateTable(int sizeToAllocate)
ParallelUnsortedSetIterable<T>	asParallel(ExecutorService executorService, int batchSize)	Returns a parallel iterable of this SetIterable.
void	batchForEach(Procedure<? super T> procedure, int sectionIndex, int sectionCount)
private boolean	chainContains(UnifiedSet.ChainedBucket bucket, T key)
private boolean	chainedAdd(T key, int index)
private void	chainedAddForTrim(Object key, int index)
private Object	chainedDetect(UnifiedSet.ChainedBucket bucket, Predicate<? super T> predicate)
private void	chainedForEach(UnifiedSet.ChainedBucket bucket, Procedure<? super T> procedure)
private <P> void	chainedForEachWith(UnifiedSet.ChainedBucket bucket, Procedure2<? super T, ? super P> procedure, P parameter)
private int	chainedForEachWithIndex(UnifiedSet.ChainedBucket bucket, ObjectIntProcedure<? super T> procedure, int count)
private T	chainedGet(T key, UnifiedSet.ChainedBucket bucket)
private int	chainedHashCode(UnifiedSet.ChainedBucket bucket)
private T	chainedPut(T key, int index)
private boolean	chainedShortCircuit(UnifiedSet.ChainedBucket bucket, Predicate<? super T> predicate, boolean expected)
private <P> boolean	chainedShortCircuitWith(UnifiedSet.ChainedBucket bucket, Predicate2<? super T, ? super P> predicate, P parameter, boolean expected)
private void	chainedTrimToSize(UnifiedSet.ChainedBucket bucket, int oldIndex, int mask)
void	clear()
UnifiedSet<T>	clone()
boolean	contains(Object key)	Returns true if the iterable has an element which responds true to element.equals(object).
private int	copyBucketToArray(Object[] result, UnifiedSet.ChainedBucket bucket, int count)
private boolean	copyChain(UnifiedSet.ChainedBucket bucket)
protected boolean	copySet(UnifiedSet<?> unifiedset)
private void	copyToArray(Object[] result)
protected T	detect(Predicate<? super T> predicate, int start, int end)
protected Optional<T>	detectOptional(Predicate<? super T> predicate, int start, int end)
void	each(Procedure<? super T> procedure)	The procedure is executed for each element in the iterable.
protected void	each(Procedure<? super T> procedure, int start, int end)
private void	ensureCapacity(int size)
boolean	equals(Object object)	Follows the same general contract as Set.equals(Object).
private int	fastCeil(float v)
<P> void	forEachWith(Procedure2<? super T, ? super P> procedure, P parameter)	The procedure2 is evaluated for each element in the iterable with the specified parameter provided as the second argument.
void	forEachWithIndex(ObjectIntProcedure<? super T> objectIntProcedure)	Iterates over the iterable passing each element and the current relative int index to the specified instance of ObjectIntProcedure.
T	get(T key)	Locates an object in the pool which is equal to key.
T	getFirst()	Returns the first element of an iterable.
T	getLast()	Returns the last element of an iterable.
private T	getLast(UnifiedSet.ChainedBucket bucket)
protected Object[]	getTable()
<V> UnifiedSetMultimap<V,T>	groupBy(Function<? super T, ? extends V> function)	For each element of the iterable, the function is evaluated and the results of these evaluations are collected into a new multimap, where the transformed value is the key and the original values are added to the same (or similar) species of collection as the source iterable.
<V> UnifiedSetMultimap<V,T>	groupByEach(Function<? super T, ? extends Iterable<V>> function)	Similar to RichIterable.groupBy(Function), except the result of evaluating function will return a collection of keys for each value.
int	hashCode()	Follows the same general contract as Set.hashCode().
protected int	index(Object key)
Iterator<T>	iterator()
UnifiedSet<T>	newEmpty()	Creates a new empty mutable version of the same collection type.
UnifiedSet<T>	newEmpty(int size)
static <K> UnifiedSet<K>	newSet()
static <K> UnifiedSet<K>	newSet(int size)
static <K> UnifiedSet<K>	newSet(int size, float loadFactor)
static <K> UnifiedSet<K>	newSet(Iterable<? extends K> source)
static <K> UnifiedSet<K>	newSetWith(K... elements)
private boolean	nonNullTableObjectEquals(Object cur, T key)
private T	nonSentinel(Object key)
PartitionMutableSet<T>	partition(Predicate<? super T> predicate)	Filters a collection into a PartitionedIterable based on the evaluation of the predicate.
<P> PartitionMutableSet<T>	partitionWith(Predicate2<? super T, ? super P> predicate, P parameter)	Filters a collection into a PartitionIterable based on the evaluation of the predicate.
T	put(T key)	Puts key into the pool.
void	readExternal(ObjectInput in)
protected void	rehash(int newCapacity)
UnifiedSet<T>	reject(Predicate<? super T> predicate)	Returns all elements of the source collection that return false when evaluating of the predicate.
<P> UnifiedSet<T>	rejectWith(Predicate2<? super T, ? super P> predicate, P parameter)	Similar to RichIterable.reject(Predicate), except with an evaluation parameter for the second generic argument in Predicate2.
boolean	remove(Object key)
private boolean	removeDeepChain(UnifiedSet.ChainedBucket oldBucket, T key)
private T	removeDeepChainForPool(UnifiedSet.ChainedBucket oldBucket, T key)
private boolean	removeFromChain(UnifiedSet.ChainedBucket bucket, T key, int index)
private T	removeFromChainForPool(UnifiedSet.ChainedBucket bucket, T key, int index)
T	removeFromPool(T key)	Locates an object in the pool which is equal to key and removes it.
private boolean	retainAllFromNonSet(Iterable<?> iterable)
private boolean	retainAllFromSet(Set<?> collection)
boolean	retainAllIterable(Iterable<?> iterable)
UnifiedSet<T>	select(Predicate<? super T> predicate)	Returns all elements of the source collection that return true when evaluating the predicate.
<P> Twin<MutableList<T>>	selectAndRejectWith(Predicate2<? super T, ? super P> predicate, P parameter)	Filters a collection into two separate collections based on a predicate returned via a Pair.
<S> UnifiedSet<S>	selectInstancesOf(Class<S> clazz)	Returns all elements of the source collection that are instances of the Class clazz.
<P> UnifiedSet<T>	selectWith(Predicate2<? super T, ? super P> predicate, P parameter)	Similar to RichIterable.select(Predicate), except with an evaluation parameter for the second generic argument in Predicate2.
protected boolean	shortCircuit(Predicate<? super T> predicate, boolean expected, boolean onShortCircuit, boolean atEnd, int start, int end)
protected <P> boolean	shortCircuitWith(Predicate2<? super T, ? super P> predicate2, P parameter, boolean expected, boolean onShortCircuit, boolean atEnd)
int	size()	Returns the number of items in this iterable.
MutableSet<T>	tap(Procedure<? super T> procedure)	Executes the Procedure for each element in the iterable and returns this.
Object[]	toArray()	Converts this iterable to an array.
<T> T[]	toArray(T[] array)	Converts this iterable to an array using the specified target array, assuming the target array is as long or longer than the iterable.
ImmutableSet<T>	toImmutable()	Converts this MutableCollection to an ImmutableCollection.
private static Object	toSentinelIfNull(Object key)
boolean	trimToSize()
UnifiedSet<T>	with(T element)	This method allows mutable and fixed size collections the ability to add elements to their existing elements.
UnifiedSet<T>	with(T... elements)
UnifiedSet<T>	with(T element1, T element2)
UnifiedSet<T>	with(T element1, T element2, T element3)
UnifiedSet<T>	withAll(Iterable<? extends T> iterable)	This method allows mutable and fixed size collections the ability to add multiple elements to their existing elements.
UnifiedSet<T>	without(T element)	This method allows mutable and fixed size collections the ability to remove elements from their existing elements.
UnifiedSet<T>	withoutAll(Iterable<? extends T> elements)	This method allows mutable and fixed size collections the ability to remove multiple elements from their existing elements.
void	writeExternal(ObjectOutput out)
private void	writeExternalChain(ObjectOutput out, UnifiedSet.ChainedBucket bucket)

Methods inherited from class AbstractUnifiedSet

allocate, allSatisfy, allSatisfyWith, anySatisfy, anySatisfyWith, asSynchronized, asUnmodifiable, cartesianProduct, chunk, collect, collectIf, collectWith, computeMaxSize, detect, detectOptional, difference, differenceInto, flatCollect, getBatchCount, groupByUniqueKey, init, injectIntoWith, intersect, intersectInto, isProperSubsetOf, isSubsetOf, noneSatisfy, noneSatisfyWith, powerSet, rehash, removeAllIterable, retainAll, shortCircuit, symmetricDifference, symmetricDifferenceInto, union, unionInto, zip, zipWithIndex

Methods inherited from class AbstractMutableCollection

addAll, countBy, countByEach, countByWith, reduce, removeAll, removeIf, removeIfWith, sumByDouble, sumByFloat, sumByInt, sumByLong

Methods inherited from class AbstractRichIterable

appendString, appendString, asLazy, collect, collectIf, collectWith, containsAll, containsAllArguments, containsAllIterable, count, countWith, detectWith, detectWithIfNone, detectWithOptional, flatCollect, forEach, groupBy, groupByEach, groupByUniqueKey, injectInto, injectInto, injectInto, injectInto, injectInto, into, isEmpty, max, max, maxBy, min, min, minBy, reject, rejectWith, select, selectWith, sumOfDouble, sumOfFloat, sumOfInt, sumOfLong, toBag, toBiMap, toList, toMap, toSet, toSortedBag, toSortedBag, toSortedBagBy, toSortedListBy, toSortedMap, toSortedMap, toSortedMapBy, toSortedSet, toSortedSet, toSortedSetBy, toString, zip, zipWithIndex

Methods inherited from class Object

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

Methods inherited from interface BatchIterable

forEach

Methods inherited from interface Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface InternalIterable

forEach

Methods inherited from interface MutableCollection

aggregateBy, aggregateInPlaceBy, collectBoolean, collectByte, collectChar, collectDouble, collectFloat, collectInt, collectLong, collectShort, countBy, countByEach, countByWith, flatCollectWith, removeIf, removeIfWith, sumByDouble, sumByFloat, sumByInt, sumByLong

Methods inherited from interface MutableSet

collectBoolean, collectByte, collectChar, collectDouble, collectFloat, collectInt, collectLong, collectShort, flatCollectWith, toImmutableSet

Methods inherited from interface RichIterable

aggregateBy, appendString, appendString, appendString, asLazy, collect, collectBoolean, collectByte, collectChar, collectDouble, collectFloat, collectIf, collectInt, collectLong, collectShort, collectWith, containsAll, containsAllArguments, containsAllIterable, containsAny, containsAnyIterable, containsBy, containsNone, containsNoneIterable, count, countBy, countByEach, countByWith, countWith, detectIfNone, detectWith, detectWithIfNone, detectWithOptional, flatCollect, flatCollectBoolean, flatCollectByte, flatCollectChar, flatCollectDouble, flatCollectFloat, flatCollectInt, flatCollectLong, flatCollectShort, flatCollectWith, forEach, getAny, getOnly, groupBy, groupByAndCollect, groupByEach, groupByUniqueKey, injectInto, injectInto, injectInto, injectInto, injectInto, injectIntoDouble, injectIntoFloat, injectIntoInt, injectIntoLong, into, isEmpty, makeString, makeString, makeString, makeString, max, max, maxBy, maxByOptional, maxOptional, maxOptional, min, min, minBy, minByOptional, minOptional, minOptional, notEmpty, reduce, reduceBy, reduceBy, reduceInPlace, reduceInPlace, reject, rejectWith, select, selectWith, summarizeDouble, summarizeFloat, summarizeInt, summarizeLong, sumOfDouble, sumOfFloat, sumOfInt, sumOfLong, toBag, toBiMap, toImmutableBag, toImmutableBiMap, toImmutableList, toImmutableMap, toImmutableSortedBag, toImmutableSortedBag, toImmutableSortedBagBy, toImmutableSortedList, toImmutableSortedList, toImmutableSortedListBy, toImmutableSortedSet, toImmutableSortedSet, toImmutableSortedSetBy, toList, toMap, toMap, toSet, toSortedBag, toSortedBag, toSortedBagBy, toSortedList, toSortedList, toSortedListBy, toSortedMap, toSortedMap, toSortedMapBy, toSortedSet, toSortedSet, toSortedSetBy, toString, zip, zipWithIndex

Methods inherited from interface Set

addAll, containsAll, isEmpty, removeAll, spliterator

Field Details

NULL_KEY

protected static final Object NULL_KEY

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

table

protected transient Object[] table

occupied

protected transient int occupied

Constructor Details

UnifiedSet

public UnifiedSet()

UnifiedSet

public UnifiedSet(int initialCapacity)

UnifiedSet

public UnifiedSet(int initialCapacity,
 float loadFactor)

UnifiedSet

public UnifiedSet(Collection<? extends T> collection)

UnifiedSet

public UnifiedSet(UnifiedSet<T> set)

Method Details

newSet

public static <K> UnifiedSet<K> newSet()

newSet

public static <K> UnifiedSet<K> newSet(int size)

newSet

public static <K> UnifiedSet<K> newSet(Iterable<? extends K> source)

newSet

public static <K> UnifiedSet<K> newSet(int size,
 float loadFactor)

newSetWith

public static <K> UnifiedSet<K> newSetWith(K... elements)

fastCeil

private int fastCeil(float v)

getTable

protected Object[] getTable()

Specified by:

getTable in class AbstractUnifiedSet<T>

allocateTable

protected void allocateTable(int sizeToAllocate)

Specified by:

allocateTable in class AbstractUnifiedSet<T>

index

protected int index(Object key)

clear

public void clear()

Specified by:

clear in interface Collection<T>

Specified by:

clear in interface Pool<T>

Specified by:

clear in interface Set<T>

add

public boolean add(T key)

Specified by:

add in interface Collection<T>

Specified by:

add in interface Set<T>

Overrides:

add in class AbstractMutableCollection<T>

chainedAdd

private boolean chainedAdd(T key,
 int index)

rehash

protected void rehash(int newCapacity)

Specified by:

rehash in class AbstractUnifiedSet<T>

contains

public boolean contains(Object key)

Description copied from interface: RichIterable

Returns true if the iterable has an element which responds true to element.equals(object).

Specified by:

contains in interface Collection<T>

Specified by:

contains in interface RichIterable<T>

Specified by:

contains in interface Set<T>

Overrides:

contains in class AbstractRichIterable<T>

chainContains

private boolean chainContains(UnifiedSet.ChainedBucket bucket,
 T key)

batchForEach

public void batchForEach(Procedure<? super T> procedure,
 int sectionIndex,
 int sectionCount)

Specified by:

batchForEach in interface BatchIterable<T>

tap

public MutableSet<T> tap(Procedure<? super T> procedure)

Description copied from interface: RichIterable

Executes the Procedure for each element in the iterable and returns this.

Example using a Java 8 lambda expression:

RichIterable<Person> tapped =
    people.tap(person -> LOGGER.info(person.getName()));

Specified by:

tap in interface MutableCollection<T>

Specified by:

tap in interface MutableSet<T>

Specified by:

tap in interface MutableSetIterable<T>

Specified by:

tap in interface RichIterable<T>

Specified by:

tap in interface SetIterable<T>

Specified by:

tap in interface UnsortedSetIterable<T>

See Also:

• RichIterable.each(Procedure)
• RichIterable.forEach(Procedure)

each

public void each(Procedure<? super T> procedure)

Description copied from interface: RichIterable

The procedure is executed for each element in the iterable.

Example using a Java 8 lambda expression:

people.each(person -> LOGGER.info(person.getName()));

This method is a variant of InternalIterable.forEach(Procedure) that has a signature conflict with Iterable.forEach(java.util.function.Consumer).

Specified by:

each in interface RichIterable<T>

See Also:

• InternalIterable.forEach(Procedure)
• Iterable.forEach(java.util.function.Consumer)

each

protected void each(Procedure<? super T> procedure,
 int start,
 int end)

chainedForEach

private void chainedForEach(UnifiedSet.ChainedBucket bucket,
 Procedure<? super T> procedure)

forEachWith

public <P> void forEachWith(Procedure2<? super T, ? super P> procedure,
 P parameter)

Description copied from interface: InternalIterable

The procedure2 is evaluated for each element in the iterable with the specified parameter provided as the second argument.

Example using a Java 8 lambda:

people.forEachWith((Person person, Person other) ->
    {
        if (person.isRelatedTo(other))
        {
             LOGGER.info(person.getName());
        }
    }, fred);

Example using an anonymous inner class:

people.forEachWith(new Procedure2<Person, Person>()
{
    public void value(Person person, Person other)
    {
        if (person.isRelatedTo(other))
        {
             LOGGER.info(person.getName());
        }
    }
}, fred);

Specified by:

forEachWith in interface InternalIterable<T>

Overrides:

forEachWith in class AbstractRichIterable<T>

chainedForEachWith

private <P> void chainedForEachWith(UnifiedSet.ChainedBucket bucket,
 Procedure2<? super T, ? super P> procedure,
 P parameter)

forEachWithIndex

public void forEachWithIndex(ObjectIntProcedure<? super T> objectIntProcedure)

Description copied from interface: InternalIterable

Iterates over the iterable passing each element and the current relative int index to the specified instance of ObjectIntProcedure.

Example using a Java 8 lambda:

people.forEachWithIndex((Person person, int index) -> LOGGER.info("Index: " + index + " person: " + person.getName()));

Example using an anonymous inner class:

people.forEachWithIndex(new ObjectIntProcedure<Person>()
{
    public void value(Person person, int index)
    {
        LOGGER.info("Index: " + index + " person: " + person.getName());
    }
});

Specified by:

forEachWithIndex in interface InternalIterable<T>

Overrides:

forEachWithIndex in class AbstractRichIterable<T>

chainedForEachWithIndex

private int chainedForEachWithIndex(UnifiedSet.ChainedBucket bucket,
 ObjectIntProcedure<? super T> procedure,
 int count)

newEmpty

public UnifiedSet<T> newEmpty()

Description copied from interface: MutableCollection

Creates a new empty mutable version of the same collection type. For example, if this instance is a FastList, this method will return a new empty FastList. If the class of this instance is immutable or fixed size (i.e. SingletonList) then a mutable alternative to the class will be provided.

Specified by:

newEmpty in interface MutableCollection<T>

Specified by:

newEmpty in interface MutableSet<T>

newEmpty

public UnifiedSet<T> newEmpty(int size)

Specified by:

newEmpty in class AbstractUnifiedSet<T>

getFirst

public T getFirst()

Description copied from interface: RichIterable

Returns the first element of an iterable. In the case of a List it is the element at the first index. In the case of any other Collection, it is the first element that would be returned during an iteration. If the iterable is empty, null is returned. If null is a valid element of the container, then a developer would need to check to see if the iterable is empty to validate that a null result was not due to the container being empty.

The order of Sets are not guaranteed (except for TreeSets and other Ordered Set implementations), so if you use this method, the first element could be any element from the Set.

Specified by:

getFirst in interface RichIterable<T>

getLast

public T getLast()

Description copied from interface: RichIterable

Returns the last element of an iterable. In the case of a List it is the element at the last index. In the case of any other Collection, it is the last element that would be returned during an iteration. If the iterable is empty, null is returned. If null is a valid element of the container, then a developer would need to check to see if the iterable is empty to validate that a null result was not due to the container being empty.

The order of Sets are not guaranteed (except for TreeSets and other Ordered Set implementations), so if you use this method, the last element could be any element from the Set.

Specified by:

getLast in interface RichIterable<T>

getLast

private T getLast(UnifiedSet.ChainedBucket bucket)

select

public UnifiedSet<T> select(Predicate<? super T> predicate)

Description copied from interface: RichIterable

Returns all elements of the source collection that return true when evaluating the predicate. This method is also commonly called filter.

Example using a Java 8 lambda expression:

RichIterable<Person> selected =
    people.select(person -> person.getAddress().getCity().equals("London"));

Specified by:

select in interface MutableCollection<T>

Specified by:

select in interface MutableSet<T>

Specified by:

select in interface MutableSetIterable<T>

Specified by:

select in interface RichIterable<T>

Specified by:

select in interface SetIterable<T>

Specified by:

select in interface UnsortedSetIterable<T>

selectWith

public <P> UnifiedSet<T> selectWith(Predicate2<? super T, ? super P> predicate,
 P parameter)

Description copied from interface: RichIterable

Similar to RichIterable.select(Predicate), except with an evaluation parameter for the second generic argument in Predicate2.

E.g. return a Collection of Person elements where the person has an age greater than or equal to 18 years

Example using a Java 8 lambda expression:

RichIterable<Person> selected =
    people.selectWith((Person person, Integer age) -> person.getAge()>= age, Integer.valueOf(18));

Specified by:

selectWith in interface MutableCollection<T>

Specified by:

selectWith in interface MutableSet<T>

Specified by:

selectWith in interface MutableSetIterable<T>

Specified by:

selectWith in interface RichIterable<T>

Specified by:

selectWith in interface SetIterable<T>

Specified by:

selectWith in interface UnsortedSetIterable<T>

Parameters:

predicate - a Predicate2 to use as the select criteria

parameter - a parameter to pass in for evaluation of the second argument P in predicate

See Also:

• RichIterable.select(Predicate)

reject

public UnifiedSet<T> reject(Predicate<? super T> predicate)

Description copied from interface: RichIterable

Returns all elements of the source collection that return false when evaluating of the predicate. This method is also sometimes called filterNot and is the equivalent of calling iterable.select(Predicates.not(predicate)).

Example using a Java 8 lambda expression:

RichIterable<Person> rejected =
    people.reject(person -> person.person.getLastName().equals("Smith"));

Specified by:

reject in interface MutableCollection<T>

Specified by:

reject in interface MutableSet<T>

Specified by:

reject in interface MutableSetIterable<T>

Specified by:

reject in interface RichIterable<T>

Specified by:

reject in interface SetIterable<T>

Specified by:

reject in interface UnsortedSetIterable<T>

Parameters:

predicate - a Predicate to use as the reject criteria

Returns:

a RichIterable that contains elements that cause Predicate.accept(Object) method to evaluate to false

rejectWith

public <P> UnifiedSet<T> rejectWith(Predicate2<? super T, ? super P> predicate,
 P parameter)

Description copied from interface: RichIterable

Similar to RichIterable.reject(Predicate), except with an evaluation parameter for the second generic argument in Predicate2.

E.g. return a Collection of Person elements where the person has an age greater than or equal to 18 years

Example using a Java 8 lambda expression:

RichIterable<Person> rejected =
    people.rejectWith((Person person, Integer age) -> person.getAge() < age, Integer.valueOf(18));

Specified by:

rejectWith in interface MutableCollection<T>

Specified by:

rejectWith in interface MutableSet<T>

Specified by:

rejectWith in interface MutableSetIterable<T>

Specified by:

rejectWith in interface RichIterable<T>

Specified by:

rejectWith in interface SetIterable<T>

Specified by:

rejectWith in interface UnsortedSetIterable<T>

Parameters:

predicate - a Predicate2 to use as the select criteria

parameter - a parameter to pass in for evaluation of the second argument P in predicate

See Also:

• RichIterable.select(Predicate)

selectAndRejectWith

public <P> Twin<MutableList<T>> selectAndRejectWith(Predicate2<? super T, ? super P> predicate,
 P parameter)

Description copied from interface: MutableCollection

Filters a collection into two separate collections based on a predicate returned via a Pair.

e.g.
return lastNames.selectAndRejectWith(Predicates2.lessThan(), "Mason");

Specified by:

selectAndRejectWith in interface MutableCollection<T>

Overrides:

selectAndRejectWith in class AbstractMutableCollection<T>

partition

public PartitionMutableSet<T> partition(Predicate<? super T> predicate)

Description copied from interface: RichIterable

Filters a collection into a PartitionedIterable based on the evaluation of the predicate.

Example using a Java 8 lambda expression:

PartitionIterable<Person> newYorkersAndNonNewYorkers =
    people.partition(person -> person.getAddress().getState().getName().equals("New York"));

Specified by:

partition in interface MutableCollection<T>

Specified by:

partition in interface MutableSet<T>

Specified by:

partition in interface MutableSetIterable<T>

Specified by:

partition in interface RichIterable<T>

Specified by:

partition in interface SetIterable<T>

partitionWith

public <P> PartitionMutableSet<T> partitionWith(Predicate2<? super T, ? super P> predicate,
 P parameter)

Description copied from interface: RichIterable

Filters a collection into a PartitionIterable based on the evaluation of the predicate.

Example using a Java 8 lambda expression:

PartitionIterable<Person> newYorkersAndNonNewYorkers =
    people.partitionWith((Person person, String state) -> person.getAddress().getState().getName().equals(state), "New York");

Specified by:

partitionWith in interface MutableCollection<T>

Specified by:

partitionWith in interface MutableSet<T>

Specified by:

partitionWith in interface MutableSetIterable<T>

Specified by:

partitionWith in interface RichIterable<T>

Specified by:

partitionWith in interface SetIterable<T>

selectInstancesOf

public <S> UnifiedSet<S> selectInstancesOf(Class<S> clazz)

Description copied from interface: RichIterable

Returns all elements of the source collection that are instances of the Class clazz.

RichIterable<Integer> integers =
    List.mutable.with(new Integer(0), new Long(0L), new Double(0.0)).selectInstancesOf(Integer.class);

Specified by:

selectInstancesOf in interface MutableCollection<T>

Specified by:

selectInstancesOf in interface MutableSet<T>

Specified by:

selectInstancesOf in interface MutableSetIterable<T>

Specified by:

selectInstancesOf in interface RichIterable<T>

Specified by:

selectInstancesOf in interface SetIterable<T>

Specified by:

selectInstancesOf in interface UnsortedSetIterable<T>

detect

protected T detect(Predicate<? super T> predicate,
 int start,
 int end)

Specified by:

detect in class AbstractUnifiedSet<T>

detectOptional

protected Optional<T> detectOptional(Predicate<? super T> predicate,
 int start,
 int end)

Specified by:

detectOptional in class AbstractUnifiedSet<T>

chainedDetect

private Object chainedDetect(UnifiedSet.ChainedBucket bucket,
 Predicate<? super T> predicate)

shortCircuit

protected boolean shortCircuit(Predicate<? super T> predicate,
 boolean expected,
 boolean onShortCircuit,
 boolean atEnd,
 int start,
 int end)

Specified by:

shortCircuit in class AbstractUnifiedSet<T>

chainedShortCircuit

private boolean chainedShortCircuit(UnifiedSet.ChainedBucket bucket,
 Predicate<? super T> predicate,
 boolean expected)

shortCircuitWith

protected <P> boolean shortCircuitWith(Predicate2<? super T, ? super P> predicate2,
 P parameter,
 boolean expected,
 boolean onShortCircuit,
 boolean atEnd)

Specified by:

shortCircuitWith in class AbstractUnifiedSet<T>

chainedShortCircuitWith

private <P> boolean chainedShortCircuitWith(UnifiedSet.ChainedBucket bucket,
 Predicate2<? super T, ? super P> predicate,
 P parameter,
 boolean expected)

toImmutable

public ImmutableSet<T> toImmutable()

Description copied from interface: MutableCollection

Converts this MutableCollection to an ImmutableCollection.

Specified by:

toImmutable in interface MutableCollection<T>

Specified by:

toImmutable in interface MutableSet<T>

Specified by:

toImmutable in interface SetIterable<T>

Specified by:

toImmutable in interface UnsortedSetIterable<T>

with

public UnifiedSet<T> with(T element)

Description copied from interface: MutableCollection

This method allows mutable and fixed size collections the ability to add elements to their existing elements. In order to support fixed size a new instance of a collection would have to be returned taking the elements of the original collection and appending the new element to form the new collection. In the case of mutable collections, the original collection is modified, and is returned. In order to use this method properly with mutable and fixed size collections the following approach must be taken:

MutableCollection<String> list = list.with("1");
list = list.with("2");
return list;

In the case of FixedSizeCollection a new instance of MutableCollection will be returned by with, and any variables that previously referenced the original collection will need to be redirected to reference the new instance. For other MutableCollection types you will replace the reference to collection with the same collection, since the instance will return "this" after calling add on itself.

Specified by:

with in interface MutableCollection<T>

Specified by:

with in interface MutableSet<T>

Specified by:

with in interface MutableSetIterable<T>

See Also:

• Collection.add(Object)

with

public UnifiedSet<T> with(T element1,
 T element2)

with

public UnifiedSet<T> with(T element1,
 T element2,
 T element3)

with

public UnifiedSet<T> with(T... elements)

withAll

public UnifiedSet<T> withAll(Iterable<? extends T> iterable)

Description copied from interface: MutableCollection

This method allows mutable and fixed size collections the ability to add multiple elements to their existing elements. In order to support fixed size a new instance of a collection would have to be returned taking the elements of the original collection and appending the new elements to form the new collection. In the case of mutable collections, the original collection is modified, and is returned. In order to use this method properly with mutable and fixed size collections the following approach must be taken:

MutableCollection<String> list = list.withAll(FastList.newListWith("1", "2"));

In the case of FixedSizeCollection a new instance of MutableCollection will be returned by withAll, and any variables that previously referenced the original collection will need to be redirected to reference the new instance. For other MutableCollection types you will replace the reference to collection with the same collection, since the instance will return "this" after calling addAll on itself.

Specified by:

withAll in interface MutableCollection<T>

Specified by:

withAll in interface MutableSet<T>

Specified by:

withAll in interface MutableSetIterable<T>

See Also:

• Collection.addAll(Collection)

without

public UnifiedSet<T> without(T element)

Description copied from interface: MutableCollection

This method allows mutable and fixed size collections the ability to remove elements from their existing elements. In order to support fixed size a new instance of a collection would have to be returned containing the elements that would be left from the original collection after calling remove. In the case of mutable collections, the original collection is modified, and is returned. In order to use this method properly with mutable and fixed size collections the following approach must be taken:

MutableCollection<String> list = list.without("1");
list = list.without("2");
return list;

In the case of FixedSizeCollection a new instance of MutableCollection will be returned by without, and any variables that previously referenced the original collection will need to be redirected to reference the new instance. For other MutableCollection types you will replace the reference to collection with the same collection, since the instance will return "this" after calling remove on itself.

Specified by:

without in interface MutableCollection<T>

Specified by:

without in interface MutableSet<T>

Specified by:

without in interface MutableSetIterable<T>

See Also:

• Collection.remove(Object)

withoutAll

public UnifiedSet<T> withoutAll(Iterable<? extends T> elements)

Description copied from interface: MutableCollection

This method allows mutable and fixed size collections the ability to remove multiple elements from their existing elements. In order to support fixed size a new instance of a collection would have to be returned containing the elements that would be left from the original collection after calling removeAll. In the case of mutable collections, the original collection is modified, and is returned. In order to use this method properly with mutable and fixed size collections the following approach must be taken:

MutableCollection<String> list = list.withoutAll(FastList.newListWith("1", "2"));

In the case of FixedSizeCollection a new instance of MutableCollection will be returned by withoutAll, and any variables that previously referenced the original collection will need to be redirected to reference the new instance. For other MutableCollection types you will replace the reference to collection with the same collection, since the instance will return "this" after calling removeAll on itself.

Specified by:

withoutAll in interface MutableCollection<T>

Specified by:

withoutAll in interface MutableSet<T>

Specified by:

withoutAll in interface MutableSetIterable<T>

See Also:

• Collection.removeAll(Collection)

addAllIterable

public boolean addAllIterable(Iterable<? extends T> iterable)

Specified by:

addAllIterable in interface MutableCollection<T>

Overrides:

addAllIterable in class AbstractMutableCollection<T>

See Also:

• Collection.addAll(Collection)

ensureCapacity

private void ensureCapacity(int size)

copySet

protected boolean copySet(UnifiedSet<?> unifiedset)

copyChain

private boolean copyChain(UnifiedSet.ChainedBucket bucket)

remove

public boolean remove(Object key)

Specified by:

remove in interface Collection<T>

Specified by:

remove in interface Set<T>

Overrides:

remove in class AbstractMutableCollection<T>

removeFromChain

private boolean removeFromChain(UnifiedSet.ChainedBucket bucket,
 T key,
 int index)

removeDeepChain

private boolean removeDeepChain(UnifiedSet.ChainedBucket oldBucket,
 T key)

size

public int size()

Description copied from interface: RichIterable

Returns the number of items in this iterable.

Specified by:

size in interface BatchIterable<T>

Specified by:

size in interface Collection<T>

Specified by:

size in interface Pool<T>

Specified by:

size in interface RichIterable<T>

Specified by:

size in interface Set<T>

equals

public boolean equals(Object object)

Description copied from interface: SetIterable

Follows the same general contract as Set.equals(Object).

Specified by:

equals in interface Collection<T>

Specified by:

equals in interface Set<T>

Specified by:

equals in interface SetIterable<T>

Overrides:

equals in class Object

hashCode

public int hashCode()

Description copied from interface: SetIterable

Follows the same general contract as Set.hashCode().

Specified by:

hashCode in interface Collection<T>

Specified by:

hashCode in interface Set<T>

Specified by:

hashCode in interface SetIterable<T>

Overrides:

hashCode in class Object

chainedHashCode

private int chainedHashCode(UnifiedSet.ChainedBucket bucket)

trimToSize

public boolean trimToSize()

chainedTrimToSize

private void chainedTrimToSize(UnifiedSet.ChainedBucket bucket,
 int oldIndex,
 int mask)

addForTrim

private void addForTrim(Object key,
 int oldIndex,
 int mask)

chainedAddForTrim

private void chainedAddForTrim(Object key,
 int index)

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Throws:

IOException

ClassNotFoundException

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

writeExternalChain

private void writeExternalChain(ObjectOutput out,
 UnifiedSet.ChainedBucket bucket)
                         throws IOException

Throws:

IOException

addIfFound

private void addIfFound(T key,
 UnifiedSet<T> other)

addIfFoundFromChain

private void addIfFoundFromChain(UnifiedSet.ChainedBucket bucket,
 T key,
 UnifiedSet<T> other)

retainAllIterable

public boolean retainAllIterable(Iterable<?> iterable)

Specified by:

retainAllIterable in interface MutableCollection<T>

Overrides:

retainAllIterable in class AbstractMutableCollection<T>

See Also:

• Collection.retainAll(Collection)

retainAllFromNonSet

private boolean retainAllFromNonSet(Iterable<?> iterable)

retainAllFromSet

private boolean retainAllFromSet(Set<?> collection)

clone

public UnifiedSet<T> clone()

Specified by:

clone in interface MutableSet<T>

Specified by:

clone in class AbstractUnifiedSet<T>

toArray

public Object[] toArray()

Description copied from interface: RichIterable

Converts this iterable to an array.

Specified by:

toArray in interface Collection<T>

Specified by:

toArray in interface MutableCollection<T>

Specified by:

toArray in interface MutableSetIterable<T>

Specified by:

toArray in interface RichIterable<T>

Specified by:

toArray in interface Set<T>

See Also:

• Collection.toArray()

copyToArray

private void copyToArray(Object[] result)

copyBucketToArray

private int copyBucketToArray(Object[] result,
 UnifiedSet.ChainedBucket bucket,
 int count)

toArray

public <T> T[] toArray(T[] array)

Description copied from interface: RichIterable

Converts this iterable to an array using the specified target array, assuming the target array is as long or longer than the iterable.

Specified by:

toArray in interface Collection<T>

Specified by:

toArray in interface MutableCollection<T>

Specified by:

toArray in interface MutableSetIterable<T>

Specified by:

toArray in interface RichIterable<T>

Specified by:

toArray in interface Set<T>

See Also:

• Collection.toArray(Object[])

iterator

public Iterator<T> iterator()

Specified by:

iterator in interface Collection<T>

Specified by:

iterator in interface Iterable<T>

Specified by:

iterator in interface Set<T>

groupBy

public <V> UnifiedSetMultimap<V,T> groupBy(Function<? super T, ? extends V> function)

Description copied from interface: RichIterable

For each element of the iterable, the function is evaluated and the results of these evaluations are collected into a new multimap, where the transformed value is the key and the original values are added to the same (or similar) species of collection as the source iterable.

Example using a Java 8 method reference:

Multimap<String, Person> peopleByLastName =
    people.groupBy(Person::getLastName);

Specified by:

groupBy in interface MutableCollection<T>

Specified by:

groupBy in interface MutableSet<T>

Specified by:

groupBy in interface MutableSetIterable<T>

Specified by:

groupBy in interface RichIterable<T>

Specified by:

groupBy in interface UnsortedSetIterable<T>

groupByEach

public <V> UnifiedSetMultimap<V,T> groupByEach(Function<? super T, ? extends Iterable<V>> function)

Description copied from interface: RichIterable

Similar to RichIterable.groupBy(Function), except the result of evaluating function will return a collection of keys for each value.

Specified by:

groupByEach in interface MutableCollection<T>

Specified by:

groupByEach in interface MutableSet<T>

Specified by:

groupByEach in interface MutableSetIterable<T>

Specified by:

groupByEach in interface RichIterable<T>

Specified by:

groupByEach in interface UnsortedSetIterable<T>

get

public T get(T key)

Description copied from interface: Pool

Locates an object in the pool which is equal to key.

Specified by:

get in interface Pool<T>

Parameters:

key - the value to look for

Returns:

The object reference in the pool equal to key or null.

chainedGet

private T chainedGet(T key,
 UnifiedSet.ChainedBucket bucket)

put

public T put(T key)

Description copied from interface: Pool

Puts key into the pool. If there is no existing object that is equal to key, key will be added to the pool and the return value will be the same instance. If there is an existing object in the pool that is equal to key, the pool will remain unchanged and the pooled instance will be is returned.

Specified by:

put in interface Pool<T>

Parameters:

key - the value to add if not in the pool

Returns:

the object reference in the pool equal to key (either key itself or the existing reference)

chainedPut

private T chainedPut(T key,
 int index)

removeFromPool

public T removeFromPool(T key)

Description copied from interface: Pool

Locates an object in the pool which is equal to key and removes it.

Specified by:

removeFromPool in interface Pool<T>

Parameters:

key - object to remove

Returns:

The object reference in the pool equal to key or null.

removeFromChainForPool

private T removeFromChainForPool(UnifiedSet.ChainedBucket bucket,
 T key,
 int index)

removeDeepChainForPool

private T removeDeepChainForPool(UnifiedSet.ChainedBucket oldBucket,
 T key)

nonSentinel

private T nonSentinel(Object key)

toSentinelIfNull

private static Object toSentinelIfNull(Object key)

nonNullTableObjectEquals

private boolean nonNullTableObjectEquals(Object cur,
 T key)

asParallel

public ParallelUnsortedSetIterable<T> asParallel(ExecutorService executorService,
 int batchSize)

Description copied from interface: SetIterable

Returns a parallel iterable of this SetIterable.

Specified by:

asParallel in interface SetIterable<T>

Specified by:

asParallel in interface UnsortedSetIterable<T>