/*
 * Copyright (c) 2018 Goldman Sachs and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * and Eclipse Distribution License v. 1.0 which accompany this distribution.
 * The Eclipse Public License is available at http://www.eclipse.org/legal/epl-v10.html
 * and the Eclipse Distribution License is available at
 * http://www.eclipse.org/org/documents/edl-v10.php.
 */

package org.eclipse.collections.impl.set.immutable;

import java.util.Collection;
import java.util.Iterator;
import java.util.Set;
import java.util.concurrent.ExecutorService;

import org.eclipse.collections.api.LazyIterable;
import org.eclipse.collections.api.RichIterable;
import org.eclipse.collections.api.block.function.Function;
import org.eclipse.collections.api.block.function.Function2;
import org.eclipse.collections.api.block.function.primitive.BooleanFunction;
import org.eclipse.collections.api.block.function.primitive.ByteFunction;
import org.eclipse.collections.api.block.function.primitive.CharFunction;
import org.eclipse.collections.api.block.function.primitive.DoubleFunction;
import org.eclipse.collections.api.block.function.primitive.FloatFunction;
import org.eclipse.collections.api.block.function.primitive.IntFunction;
import org.eclipse.collections.api.block.function.primitive.LongFunction;
import org.eclipse.collections.api.block.function.primitive.ShortFunction;
import org.eclipse.collections.api.block.predicate.Predicate;
import org.eclipse.collections.api.block.predicate.Predicate2;
import org.eclipse.collections.api.block.procedure.Procedure;
import org.eclipse.collections.api.collection.MutableCollection;
import org.eclipse.collections.api.factory.Sets;
import org.eclipse.collections.api.list.MutableList;
import org.eclipse.collections.api.multimap.MutableMultimap;
import org.eclipse.collections.api.multimap.set.ImmutableSetMultimap;
import org.eclipse.collections.api.ordered.OrderedIterable;
import org.eclipse.collections.api.partition.set.PartitionImmutableSet;
import org.eclipse.collections.api.partition.set.PartitionMutableSet;
import org.eclipse.collections.api.set.ImmutableSet;
import org.eclipse.collections.api.set.MutableSet;
import org.eclipse.collections.api.set.ParallelUnsortedSetIterable;
import org.eclipse.collections.api.set.SetIterable;
import org.eclipse.collections.api.set.UnsortedSetIterable;
import org.eclipse.collections.api.set.primitive.ImmutableBooleanSet;
import org.eclipse.collections.api.set.primitive.ImmutableByteSet;
import org.eclipse.collections.api.set.primitive.ImmutableCharSet;
import org.eclipse.collections.api.set.primitive.ImmutableDoubleSet;
import org.eclipse.collections.api.set.primitive.ImmutableFloatSet;
import org.eclipse.collections.api.set.primitive.ImmutableIntSet;
import org.eclipse.collections.api.set.primitive.ImmutableLongSet;
import org.eclipse.collections.api.set.primitive.ImmutableShortSet;
import org.eclipse.collections.api.set.primitive.MutableBooleanSet;
import org.eclipse.collections.api.set.primitive.MutableByteSet;
import org.eclipse.collections.api.set.primitive.MutableCharSet;
import org.eclipse.collections.api.set.primitive.MutableDoubleSet;
import org.eclipse.collections.api.set.primitive.MutableFloatSet;
import org.eclipse.collections.api.set.primitive.MutableIntSet;
import org.eclipse.collections.api.set.primitive.MutableLongSet;
import org.eclipse.collections.api.set.primitive.MutableShortSet;
import org.eclipse.collections.api.tuple.Pair;
import org.eclipse.collections.impl.block.factory.Functions;
import org.eclipse.collections.impl.block.factory.Predicates;
import org.eclipse.collections.impl.block.procedure.CollectIfProcedure;
import org.eclipse.collections.impl.block.procedure.CollectProcedure;
import org.eclipse.collections.impl.block.procedure.FlatCollectProcedure;
import org.eclipse.collections.impl.block.procedure.MultimapEachPutProcedure;
import org.eclipse.collections.impl.block.procedure.MultimapPutProcedure;
import org.eclipse.collections.impl.block.procedure.PartitionPredicate2Procedure;
import org.eclipse.collections.impl.block.procedure.PartitionProcedure;
import org.eclipse.collections.impl.block.procedure.RejectProcedure;
import org.eclipse.collections.impl.block.procedure.SelectInstancesOfProcedure;
import org.eclipse.collections.impl.block.procedure.SelectProcedure;
import org.eclipse.collections.impl.block.procedure.primitive.CollectBooleanProcedure;
import org.eclipse.collections.impl.block.procedure.primitive.CollectByteProcedure;
import org.eclipse.collections.impl.block.procedure.primitive.CollectCharProcedure;
import org.eclipse.collections.impl.block.procedure.primitive.CollectDoubleProcedure;
import org.eclipse.collections.impl.block.procedure.primitive.CollectFloatProcedure;
import org.eclipse.collections.impl.block.procedure.primitive.CollectIntProcedure;
import org.eclipse.collections.impl.block.procedure.primitive.CollectLongProcedure;
import org.eclipse.collections.impl.block.procedure.primitive.CollectShortProcedure;
import org.eclipse.collections.impl.collection.immutable.AbstractImmutableCollection;
import org.eclipse.collections.impl.list.mutable.FastList;
import org.eclipse.collections.impl.multimap.set.UnifiedSetMultimap;
import org.eclipse.collections.impl.partition.set.PartitionUnifiedSet;
import org.eclipse.collections.impl.set.mutable.UnifiedSet;
import org.eclipse.collections.impl.set.mutable.primitive.BooleanHashSet;
import org.eclipse.collections.impl.set.mutable.primitive.ByteHashSet;
import org.eclipse.collections.impl.set.mutable.primitive.CharHashSet;
import org.eclipse.collections.impl.set.mutable.primitive.DoubleHashSet;
import org.eclipse.collections.impl.set.mutable.primitive.FloatHashSet;
import org.eclipse.collections.impl.set.mutable.primitive.IntHashSet;
import org.eclipse.collections.impl.set.mutable.primitive.LongHashSet;
import org.eclipse.collections.impl.set.mutable.primitive.ShortHashSet;
import org.eclipse.collections.impl.utility.Iterate;
import org.eclipse.collections.impl.utility.internal.SetIterables;

This class is the parent class for all ImmutableSets. All implementations of ImmutableSet must implement the Set interface so anArraySet.equals(anImmutableSet) can return true when the contents and order are the same.
/** * This class is the parent class for all ImmutableSets. All implementations of ImmutableSet must implement the Set * interface so anArraySet.equals(anImmutableSet) can return true when the contents and order are the same. */
public abstract class AbstractImmutableSet<T> extends AbstractImmutableCollection<T> implements ImmutableSet<T>, Set<T> { @Override public Set<T> castToSet() { return this; } protected int nullSafeHashCode(Object element) { return element == null ? 0 : element.hashCode(); } @Override public ImmutableSet<T> newWith(T element) { if (!this.contains(element)) { MutableSet<T> result = UnifiedSet.newSet(this); result.add(element); return result.toImmutable(); } return this; } @Override public ImmutableSet<T> newWithout(T element) { if (this.contains(element)) { MutableSet<T> result = UnifiedSet.newSet(this); result.remove(element); return result.toImmutable(); } return this; } @Override public ImmutableSet<T> newWithAll(Iterable<? extends T> elements) { MutableSet<T> result = UnifiedSet.newSet(elements); result.addAll(this); return result.toImmutable(); } @Override public ImmutableSet<T> newWithoutAll(Iterable<? extends T> elements) { MutableSet<T> result = UnifiedSet.newSet(this); this.removeAllFrom(elements, result); return result.toImmutable(); } @Override public ImmutableSet<T> tap(Procedure<? super T> procedure) { this.forEach(procedure); return this; } @Override public ImmutableSet<T> select(Predicate<? super T> predicate) { MutableList<T> intermediateResult = FastList.newList(); this.forEach(new SelectProcedure<>(predicate, intermediateResult)); return Sets.immutable.withAll(intermediateResult); } @Override public <P> ImmutableSet<T> selectWith(Predicate2<? super T, ? super P> predicate, P parameter) { return this.select(Predicates.bind(predicate, parameter)); } @Override public ImmutableSet<T> reject(Predicate<? super T> predicate) { MutableList<T> intermediateResult = FastList.newList(); this.forEach(new RejectProcedure<>(predicate, intermediateResult)); return Sets.immutable.withAll(intermediateResult); } @Override public <P> ImmutableSet<T> rejectWith(Predicate2<? super T, ? super P> predicate, P parameter) { return this.reject(Predicates.bind(predicate, parameter)); } @Override public PartitionImmutableSet<T> partition(Predicate<? super T> predicate) { PartitionMutableSet<T> partitionUnifiedSet = new PartitionUnifiedSet<>(); this.forEach(new PartitionProcedure<>(predicate, partitionUnifiedSet)); return partitionUnifiedSet.toImmutable(); } @Override public <P> PartitionImmutableSet<T> partitionWith(Predicate2<? super T, ? super P> predicate, P parameter) { PartitionMutableSet<T> partitionUnifiedSet = new PartitionUnifiedSet<>(); this.forEach(new PartitionPredicate2Procedure<>(predicate, parameter, partitionUnifiedSet)); return partitionUnifiedSet.toImmutable(); } @Override public <S> ImmutableSet<S> selectInstancesOf(Class<S> clazz) { MutableSet<S> result = UnifiedSet.newSet(this.size()); this.forEach(new SelectInstancesOfProcedure<>(clazz, result)); return result.toImmutable(); } @Override public <V> ImmutableSet<V> collect(Function<? super T, ? extends V> function) { MutableSet<V> result = UnifiedSet.newSet(); this.forEach(new CollectProcedure<>(function, result)); return result.toImmutable(); } @Override public ImmutableBooleanSet collectBoolean(BooleanFunction<? super T> booleanFunction) { MutableBooleanSet result = new BooleanHashSet(); this.forEach(new CollectBooleanProcedure<>(booleanFunction, result)); return result.toImmutable(); } @Override public ImmutableByteSet collectByte(ByteFunction<? super T> byteFunction) { MutableByteSet result = new ByteHashSet(); this.forEach(new CollectByteProcedure<>(byteFunction, result)); return result.toImmutable(); } @Override public ImmutableCharSet collectChar(CharFunction<? super T> charFunction) { MutableCharSet result = new CharHashSet(this.size()); this.forEach(new CollectCharProcedure<>(charFunction, result)); return result.toImmutable(); } @Override public ImmutableDoubleSet collectDouble(DoubleFunction<? super T> doubleFunction) { MutableDoubleSet result = new DoubleHashSet(this.size()); this.forEach(new CollectDoubleProcedure<>(doubleFunction, result)); return result.toImmutable(); } @Override public ImmutableFloatSet collectFloat(FloatFunction<? super T> floatFunction) { MutableFloatSet result = new FloatHashSet(this.size()); this.forEach(new CollectFloatProcedure<>(floatFunction, result)); return result.toImmutable(); } @Override public ImmutableIntSet collectInt(IntFunction<? super T> intFunction) { MutableIntSet result = new IntHashSet(this.size()); this.forEach(new CollectIntProcedure<>(intFunction, result)); return result.toImmutable(); } @Override public ImmutableLongSet collectLong(LongFunction<? super T> longFunction) { MutableLongSet result = new LongHashSet(this.size()); this.forEach(new CollectLongProcedure<>(longFunction, result)); return result.toImmutable(); } @Override public ImmutableShortSet collectShort(ShortFunction<? super T> shortFunction) { MutableShortSet result = new ShortHashSet(this.size()); this.forEach(new CollectShortProcedure<>(shortFunction, result)); return result.toImmutable(); } @Override public <P, V> ImmutableSet<V> collectWith(Function2<? super T, ? super P, ? extends V> function, P parameter) { return this.collect(Functions.bind(function, parameter)); } @Override public <V> ImmutableSet<V> collectIf(Predicate<? super T> predicate, Function<? super T, ? extends V> function) { MutableSet<V> result = UnifiedSet.newSet(); this.forEach(new CollectIfProcedure<>(result, function, predicate)); return result.toImmutable(); } @Override public <V> ImmutableSet<V> flatCollect(Function<? super T, ? extends Iterable<V>> function) { MutableSet<V> result = UnifiedSet.newSet(); this.forEach(new FlatCollectProcedure<>(function, result)); return result.toImmutable(); } @Override public ImmutableSet<T> toImmutable() { return this; } protected abstract class ImmutableSetIterator implements Iterator<T> { private int next; // next entry to return, defaults to 0 protected abstract T getElement(int i); @Override public boolean hasNext() { return this.next < AbstractImmutableSet.this.size(); } @Override public T next() { return this.getElement(this.next++); } @Override public void remove() { throw new UnsupportedOperationException("Cannot remove from an ImmutableSet"); } } @Override public <V> ImmutableSetMultimap<V, T> groupBy(Function<? super T, ? extends V> function) { return this.groupBy(function, UnifiedSetMultimap.<V, T>newMultimap()).toImmutable(); } @Override public <V, R extends MutableMultimap<V, T>> R groupBy(Function<? super T, ? extends V> function, R target) { this.forEach(MultimapPutProcedure.on(target, function)); return target; } @Override public <V> ImmutableSetMultimap<V, T> groupByEach(Function<? super T, ? extends Iterable<V>> function) { return this.groupByEach(function, UnifiedSetMultimap.newMultimap()).toImmutable(); } @Override public <V, R extends MutableMultimap<V, T>> R groupByEach(Function<? super T, ? extends Iterable<V>> function, R target) { this.forEach(MultimapEachPutProcedure.on(target, function)); return target; }
Deprecated:in 6.0. Use OrderedIterable.zip(Iterable) instead.
/** * @deprecated in 6.0. Use {@link OrderedIterable#zip(Iterable)} instead. */
@Override @Deprecated public <S> ImmutableSet<Pair<T, S>> zip(Iterable<S> that) { if (that instanceof Collection || that instanceof RichIterable) { int thatSize = Iterate.sizeOf(that); UnifiedSet<Pair<T, S>> target = UnifiedSet.newSet(Math.min(this.size(), thatSize)); return this.zip(that, target).toImmutable(); } return this.zip(that, UnifiedSet.newSet()).toImmutable(); }
Deprecated:in 6.0. Use OrderedIterable.zipWithIndex() instead.
/** * @deprecated in 6.0. Use {@link OrderedIterable#zipWithIndex()} instead. */
@Override @Deprecated public ImmutableSet<Pair<T, Integer>> zipWithIndex() { return this.zipWithIndex(UnifiedSet.newSet(this.size())).toImmutable(); } @Override protected MutableCollection<T> newMutable(int size) { return UnifiedSet.newSet(size); } @Override public ImmutableSet<T> union(SetIterable<? extends T> set) { return SetIterables.union(this, set).toImmutable(); } @Override public <R extends Set<T>> R unionInto(SetIterable<? extends T> set, R targetSet) { return SetIterables.unionInto(this, set, targetSet); } @Override public ImmutableSet<T> intersect(SetIterable<? extends T> set) { return SetIterables.intersect(this, set).toImmutable(); } @Override public <R extends Set<T>> R intersectInto(SetIterable<? extends T> set, R targetSet) { return SetIterables.intersectInto(this, set, targetSet); } @Override public ImmutableSet<T> difference(SetIterable<? extends T> subtrahendSet) { return SetIterables.difference(this, subtrahendSet).toImmutable(); } @Override public <R extends Set<T>> R differenceInto(SetIterable<? extends T> subtrahendSet, R targetSet) { return SetIterables.differenceInto(this, subtrahendSet, targetSet); } @Override public ImmutableSet<T> symmetricDifference(SetIterable<? extends T> setB) { return SetIterables.symmetricDifference(this, setB).toImmutable(); } @Override public <R extends Set<T>> R symmetricDifferenceInto(SetIterable<? extends T> set, R targetSet) { return SetIterables.symmetricDifferenceInto(this, set, targetSet); } @Override public boolean isSubsetOf(SetIterable<? extends T> candidateSuperset) { return SetIterables.isSubsetOf(this, candidateSuperset); } @Override public boolean isProperSubsetOf(SetIterable<? extends T> candidateSuperset) { return SetIterables.isProperSubsetOf(this, candidateSuperset); } @Override public ImmutableSet<UnsortedSetIterable<T>> powerSet() { return (ImmutableSet<UnsortedSetIterable<T>>) (ImmutableSet<?>) SetIterables.immutablePowerSet(this); } @Override public <B> LazyIterable<Pair<T, B>> cartesianProduct(SetIterable<B> set) { return SetIterables.cartesianProduct(this, set); } @Override public ParallelUnsortedSetIterable<T> asParallel(ExecutorService executorService, int batchSize) { return this.toSet().asParallel(executorService, batchSize); } }