Package org.eclipse.collections.impl.list.fixed

Class ArrayAdapter<T>

java.lang.Object

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

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

org.eclipse.collections.impl.list.mutable.AbstractMutableList<T>

org.eclipse.collections.impl.list.fixed.AbstractArrayAdapter<T>

org.eclipse.collections.impl.list.fixed.ArrayAdapter<T>

All Implemented Interfaces:

Serializable, Cloneable, Iterable<T>, Collection<T>, List<T>, RandomAccess, FixedSizeCollection<T>, MutableCollection<T>, InternalIterable<T>, FixedSizeList<T>, ListIterable<T>, MutableList<T>, OrderedIterable<T>, ReversibleIterable<T>, RichIterable<T>

public final class ArrayAdapter<T>
extends AbstractArrayAdapter<T>
implements Serializable, FixedSizeList<T>

This class provides a MutableList wrapper around an array. All the internal iteration methods of the MutableList interface as well as the JDK Collections List interface are provided. However, the pre-determined fixed-sized semantics of an array are maintained and thus mutating List interface methods such as AbstractMutableCollection.add(Object), AbstractArrayAdapter.addAll(Collection), AbstractArrayAdapter.remove(Object), AbstractArrayAdapter.removeAll(Collection), etc. are not supported and will throw an UnsupportedOperationException. In addition, the mutating iteration methods AbstractArrayAdapter.removeIf(org.eclipse.collections.api.block.predicate.Predicate) and AbstractArrayAdapter.removeIfWith(org.eclipse.collections.api.block.predicate.Predicate2, Object) are not supported and will also throw an UnsupportedOperationException.

The with(Object) method is not an exception to the above restrictions, as it will create a new instance of this class with the existing contents plus the new item.

To create a wrapper around an existing array, use the adapt(Object[]) factory method. To wrap the contents of an existing Collection instance, use the newArray(Iterable) or newArrayWithItem(Iterable, Object) factory methods. To wrap existing objects in a new array, use one of the newArrayWith(Object) factory methods.

See Also:

Serialized Form

Method Summary

Modifier and Type	Method	Description
static <E> ArrayAdapter<E>	adapt(E... array)
ArrayAdapter<T>	clone()
static <E> ArrayAdapter<E>	newArray()
static <E> ArrayAdapter<E>	newArray(Iterable<? extends E> source)
static <E> ArrayAdapter<E>	newArrayWith(E one)
static <E> ArrayAdapter<E>	newArrayWith(E... elements)
static <E> ArrayAdapter<E>	newArrayWith(E one, E two)
static <E> ArrayAdapter<E>	newArrayWith(E one, E two, E three)
static <E> ArrayAdapter<E>	newArrayWith(E one, E two, E three, E four)
static <E> ArrayAdapter<E>	newArrayWith(E one, E two, E three, E four, E five)
static <E> ArrayAdapter<E>	newArrayWith(E one, E two, E three, E four, E five, E six)
static <E> ArrayAdapter<E>	newArrayWith(E one, E two, E three, E four, E five, E six, E seven)
static <E> ArrayAdapter<E>	newArrayWithItem(Iterable<? extends E> iterable, E itemToAdd)
T	set(int index, T element)
ArrayAdapter<T>	sortThis(Comparator<? super T> comparator)
Spliterator<T>	spliterator()
FixedSizeList<T>	tap(Procedure<? super T> procedure)
FixedSizeList<T>	toReversed()
ArrayAdapter<T>	with(T value)
ArrayAdapter<T>	withAll(Iterable<? extends T> elements)
ArrayAdapter<T>	without(T element)
ArrayAdapter<T>	withoutAll(Iterable<? extends T> elements)

Methods inherited from class org.eclipse.collections.impl.list.fixed.AbstractArrayAdapter

abstractArrayAdapterEquals, add, addAll, addAll, addAllIterable, allSatisfy, allSatisfyWith, anySatisfy, anySatisfyWith, appendString, clear, collect, collect, collectIf, collectWith, collectWith, contains, corresponds, count, countWith, detect, detectIndex, detectLastIndex, detectOptional, detectWith, detectWithOptional, distinct, distinct, drop, each, equals, flatCollect, flatCollect, forEach, forEachWith, forEachWithIndex, forEachWithIndex, get, getFirst, getLast, hashCode, indexOf, injectInto, injectIntoWith, isEmpty, iterator, lastIndexOf, listIterator, noneSatisfy, noneSatisfyWith, notEmpty, reject, rejectWith, remove, remove, removeAll, removeAllIterable, removeIf, removeIfWith, replaceAll, retainAll, retainAllIterable, select, selectAndRejectWith, selectWith, size, sort, subList, take, toArray, toArray

Methods inherited from class org.eclipse.collections.impl.list.mutable.AbstractMutableList

appendString, asParallel, asReversed, asSynchronized, asUnmodifiable, binarySearch, chunk, containsAll, distinctBy, dropWhile, groupBy, groupByEach, groupByUniqueKey, injectInto, injectInto, injectInto, listIterator, max, max, maxBy, min, min, minBy, newEmpty, partition, partitionWhile, partitionWith, selectInstancesOf, sortThisByBoolean, sortThisByByte, sortThisByChar, sortThisByDouble, sortThisByFloat, sortThisByInt, sortThisByLong, sortThisByShort, sumOfDouble, sumOfFloat, sumOfInt, sumOfLong, takeWhile, toSet, toSortedList, zip, zip, zipWithIndex, zipWithIndex

Methods inherited from class org.eclipse.collections.impl.collection.mutable.AbstractMutableCollection

add, countBy, countByEach, countByWith, reduce, sumByDouble, sumByFloat, sumByInt, sumByLong

Methods inherited from class org.eclipse.collections.impl.AbstractRichIterable

asLazy, containsAllArguments, containsAllIterable, detectWithIfNone, forEach, groupBy, groupByEach, groupByUniqueKey, injectInto, into, toBag, toBiMap, toList, toMap, toSortedBag, toSortedBag, toSortedBagBy, toSortedListBy, toSortedMap, toSortedMap, toSortedMapBy, toSortedSet, toSortedSet, toSortedSetBy, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface org.eclipse.collections.api.collection.FixedSizeCollection

add, addAll, addAllIterable, clear, remove, removeAll, removeAllIterable, removeIf, removeIfWith, retainAll, retainAllIterable

Methods inherited from interface org.eclipse.collections.api.list.FixedSizeList

sortThis

Methods inherited from interface org.eclipse.collections.api.InternalIterable

forEach, forEachWith

Methods inherited from interface java.util.List

add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, size, sort, toArray, toArray

Methods inherited from interface org.eclipse.collections.api.list.ListIterable

asParallel, binarySearch, binarySearch, equals, forEachInBoth, get, hashCode, lastIndexOf, listIterator, listIterator

Methods inherited from interface org.eclipse.collections.api.collection.MutableCollection

aggregateBy, aggregateInPlaceBy, countBy, countByEach, countByWith, groupByUniqueKey, injectIntoWith, selectAndRejectWith, sumByDouble, sumByFloat, sumByInt, sumByLong

Methods inherited from interface org.eclipse.collections.api.list.MutableList

asSynchronized, asUnmodifiable, collect, collectBoolean, collectByte, collectChar, collectDouble, collectFloat, collectIf, collectInt, collectLong, collectShort, collectWith, collectWithIndex, distinct, distinct, distinctBy, drop, dropWhile, flatCollect, flatCollectWith, getFirst, getLast, groupBy, groupByEach, indexOf, newEmpty, partition, partitionWhile, partitionWith, reject, rejectWith, rejectWithIndex, reverseThis, select, selectInstancesOf, selectWith, selectWithIndex, shuffleThis, shuffleThis, sortThisBy, sortThisByBoolean, sortThisByByte, sortThisByChar, sortThisByDouble, sortThisByFloat, sortThisByInt, sortThisByLong, sortThisByShort, subList, take, takeWhile, toImmutable, toImmutableList, zip, zipWithIndex

Methods inherited from interface org.eclipse.collections.api.ordered.OrderedIterable

collectWithIndex, corresponds, detectIndex, forEach, forEachWithIndex, forEachWithIndex, getFirstOptional, getLastOptional, max, min, rejectWithIndex, selectWithIndex, toStack, zip, zipWithIndex

Methods inherited from interface org.eclipse.collections.api.ordered.ReversibleIterable

asReversed, detectLastIndex, reverseForEach, reverseForEachWithIndex

Methods inherited from interface org.eclipse.collections.api.RichIterable

aggregateBy, allSatisfy, allSatisfyWith, anySatisfy, anySatisfyWith, appendString, appendString, appendString, asLazy, chunk, collect, collectBoolean, collectByte, collectChar, collectDouble, collectFloat, collectIf, collectInt, collectLong, collectShort, collectWith, contains, containsAll, containsAllArguments, containsAllIterable, containsAny, containsAnyIterable, containsBy, containsNone, containsNoneIterable, count, countBy, countByEach, countByWith, countWith, detect, detectIfNone, detectOptional, detectWith, detectWithIfNone, detectWithOptional, each, 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, maxBy, maxByOptional, maxOptional, maxOptional, min, minBy, minByOptional, minOptional, minOptional, noneSatisfy, noneSatisfyWith, notEmpty, reduce, reduceInPlace, reduceInPlace, reject, rejectWith, select, selectWith, size, summarizeDouble, summarizeFloat, summarizeInt, summarizeLong, sumOfDouble, sumOfFloat, sumOfInt, sumOfLong, toArray, toArray, toBag, toBiMap, toImmutableBag, toImmutableBiMap, toImmutableMap, toImmutableSet, 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

Method Detail

adapt

public static <E> ArrayAdapter<E> adapt(E... array)

newArray

public static <E> ArrayAdapter<E> newArray()

newArray

public static <E> ArrayAdapter<E> newArray(Iterable<? extends E> source)

spliterator

public Spliterator<T> spliterator()

Specified by:

spliterator in interface Collection<T>

Specified by:

spliterator in interface Iterable<T>

Specified by:

spliterator in interface List<T>

Since:

8.1

newArrayWithItem

public static <E> ArrayAdapter<E> newArrayWithItem(Iterable<? extends E> iterable,
                                                   E itemToAdd)

newArrayWith

public static <E> ArrayAdapter<E> newArrayWith(E one)

newArrayWith

public static <E> ArrayAdapter<E> newArrayWith(E one,
                                               E two)

newArrayWith

public static <E> ArrayAdapter<E> newArrayWith(E one,
                                               E two,
                                               E three)

newArrayWith

public static <E> ArrayAdapter<E> newArrayWith(E one,
                                               E two,
                                               E three,
                                               E four)

newArrayWith

public static <E> ArrayAdapter<E> newArrayWith(E one,
                                               E two,
                                               E three,
                                               E four,
                                               E five)

newArrayWith

public static <E> ArrayAdapter<E> newArrayWith(E one,
                                               E two,
                                               E three,
                                               E four,
                                               E five,
                                               E six)

newArrayWith

public static <E> ArrayAdapter<E> newArrayWith(E one,
                                               E two,
                                               E three,
                                               E four,
                                               E five,
                                               E six,
                                               E seven)

newArrayWith

public static <E> ArrayAdapter<E> newArrayWith(E... elements)

set

public T set(int index,
             T element)

Specified by:

set in interface List<T>

with

public ArrayAdapter<T> with(T value)

Specified by:

with in interface FixedSizeCollection<T>

Specified by:

with in interface FixedSizeList<T>

Specified by:

with in interface MutableCollection<T>

Specified by:

with in interface MutableList<T>

without

public ArrayAdapter<T> without(T element)

Specified by:

without in interface FixedSizeCollection<T>

Specified by:

without in interface FixedSizeList<T>

Specified by:

without in interface MutableCollection<T>

Specified by:

without in interface MutableList<T>

withAll

public ArrayAdapter<T> withAll(Iterable<? extends T> elements)

Specified by:

withAll in interface FixedSizeCollection<T>

Specified by:

withAll in interface FixedSizeList<T>

Specified by:

withAll in interface MutableCollection<T>

Specified by:

withAll in interface MutableList<T>

withoutAll

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

Specified by:

withoutAll in interface FixedSizeCollection<T>

Specified by:

withoutAll in interface FixedSizeList<T>

Specified by:

withoutAll in interface MutableCollection<T>

Specified by:

withoutAll in interface MutableList<T>

clone

public ArrayAdapter<T> clone()

Specified by:

clone in interface MutableList<T>

Overrides:

clone in class AbstractMutableList<T>

sortThis

public ArrayAdapter<T> sortThis(Comparator<? super T> comparator)

Specified by:

sortThis in interface FixedSizeList<T>

Specified by:

sortThis in interface MutableList<T>

tap

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

Specified by:

tap in interface FixedSizeCollection<T>

Specified by:

tap in interface FixedSizeList<T>

Specified by:

tap in interface ListIterable<T>

Specified by:

tap in interface MutableCollection<T>

Specified by:

tap in interface MutableList<T>

Specified by:

tap in interface OrderedIterable<T>

Specified by:

tap in interface ReversibleIterable<T>

Specified by:

tap in interface RichIterable<T>

Overrides:

tap in class AbstractMutableList<T>

toReversed

public FixedSizeList<T> toReversed()

Specified by:

toReversed in interface FixedSizeList<T>

Specified by:

toReversed in interface ListIterable<T>

Specified by:

toReversed in interface MutableList<T>

Specified by:

toReversed in interface ReversibleIterable<T>