com.gs.collections.impl.list.mutable

Class CompositeFastList<E>

java.lang.Object

com.gs.collections.impl.AbstractRichIterable<T>

com.gs.collections.impl.collection.mutable.AbstractMutableCollection<T>

com.gs.collections.impl.list.mutable.AbstractMutableList<E>

com.gs.collections.impl.list.mutable.CompositeFastList<E>

All Implemented Interfaces:

com.gs.collections.api.collection.MutableCollection<E>, com.gs.collections.api.InternalIterable<E>, com.gs.collections.api.list.ListIterable<E>, com.gs.collections.api.list.MutableList<E>, com.gs.collections.api.ordered.OrderedIterable<E>, com.gs.collections.api.ordered.ReversibleIterable<E>, com.gs.collections.api.RichIterable<E>, BatchIterable<E>, java.io.Serializable, java.lang.Cloneable, java.lang.Iterable<E>, java.util.Collection<E>, java.util.List<E>

public final class CompositeFastList<E>
extends AbstractMutableList<E>
implements BatchIterable<E>, java.io.Serializable

CompositeFastList behaves like a list, but is composed of at least one list. It is useful where you don't want the additional expense of appending several lists or allocating memory for a super list to add multiple sublists to.

Note: mutation operations (e.g. add and remove, sorting) will change the underlying lists - so be sure to only use a composite list where it will be the only reference to the sublists (for example, a composite list which contains multiple query results is OK as long as it is the only thing that references the lists)

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.gs.collections.impl.list.mutable.AbstractMutableList

AbstractMutableList.SubList<T>

Constructor Summary

Constructors

Constructor and Description
CompositeFastList()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	add(E object)
void	add(int index, E element)
boolean	addAll(java.util.Collection<? extends E> collection)
boolean	addAll(int index, java.util.Collection<? extends E> collection)
void	addComposited(java.util.Collection<? extends E> collection)
boolean	allSatisfy(com.gs.collections.api.block.predicate.Predicate<? super E> predicate) Returns true if the predicate evaluates to true for every element of the iterable or if the iterable is empty.
<P> boolean	allSatisfyWith(com.gs.collections.api.block.predicate.Predicate2<? super E,? super P> predicate, P parameter) Returns true if the predicate evaluates to true for every element of the collection, or returns false.
boolean	anySatisfy(com.gs.collections.api.block.predicate.Predicate<? super E> predicate) Returns true if the predicate evaluates to true for any element of the iterable.
<P> boolean	anySatisfyWith(com.gs.collections.api.block.predicate.Predicate2<? super E,? super P> predicate, P parameter) Returns true if the predicate evaluates to true for any element of the collection, or return false.
com.gs.collections.api.list.ParallelListIterable<E>	asParallel(java.util.concurrent.ExecutorService executorService, int batchSize) Returns a parallel iterable of this ListIterable.
void	batchForEach(com.gs.collections.api.block.procedure.Procedure<? super E> procedure, int sectionIndex, int sectionCount)
void	clear()
com.gs.collections.api.list.MutableList<E>	clone()
<V,R extends java.util.Collection<V>> R	collect(com.gs.collections.api.block.function.Function<? super E,? extends V> function, R target) Same as RichIterable.collect(Function), except that the results are gathered into the specified target collection.
<P,A,R extends java.util.Collection<A>> R	collectWith(com.gs.collections.api.block.function.Function2<? super E,? super P,? extends A> function, P parameter, R target) Same as collectWith but with a targetCollection parameter to gather the results.
boolean	contains(java.lang.Object object) Returns true if the iterable has an element which responds true to element.equals(object).
boolean	containsAll(java.util.Collection<?> collection) Returns true if all elements in source are contained in this collection.
int	count(com.gs.collections.api.block.predicate.Predicate<? super E> predicate) Return the total number of elements that answer true to the specified predicate.
<P> int	countWith(com.gs.collections.api.block.predicate.Predicate2<? super E,? super P> predicate, P parameter) Returns the total number of elements that evaluate to true for the specified predicate.
protected void	defaultSort(java.util.Comparator<? super E> comparator) Override in subclasses where it can be optimized.
void	each(com.gs.collections.api.block.procedure.Procedure<? super E> procedure) The procedure is executed for each element in the iterable.
<P> void	forEachWith(com.gs.collections.api.block.procedure.Procedure2<? super E,? super P> procedure2, P parameter) The procedure2 is evaluated for each element in the iterable with the specified parameter provided as the second argument.
void	forEachWithIndex(com.gs.collections.api.block.procedure.primitive.ObjectIntProcedure<? super E> objectIntProcedure) Iterates over the iterable passing each element and the current relative int index to the specified instance of ObjectIntProcedure.
E	get(int index) Returns the item at the specified position in this list iterable.
int	getBatchCount(int batchSize)
int	indexOf(java.lang.Object o) Returns the index of the first occurrence of the specified item in this iterable, or -1 if this iterable does not contain the item.
double	injectInto(double injectedValue, com.gs.collections.api.block.function.primitive.DoubleObjectToDoubleFunction<? super E> function) Returns the final double result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.
float	injectInto(float injectedValue, com.gs.collections.api.block.function.primitive.FloatObjectToFloatFunction<? super E> function) Returns the final float result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.
int	injectInto(int injectedValue, com.gs.collections.api.block.function.primitive.IntObjectToIntFunction<? super E> function) Returns the final int result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.
<IV> IV	injectInto(IV injectedValue, com.gs.collections.api.block.function.Function2<? super IV,? super E,? extends IV> function) Returns the final result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.
long	injectInto(long injectedValue, com.gs.collections.api.block.function.primitive.LongObjectToLongFunction<? super E> function) Returns the final long result of evaluating function using each element of the iterable and the previous evaluation result as the parameters.
boolean	isEmpty() Returns true if this iterable has zero items.
java.util.Iterator<E>	iterator()
int	lastIndexOf(java.lang.Object o) Returns the index of the last occurrence of the specified item in this list, or -1 if this list does not contain the item.
java.util.ListIterator<E>	listIterator() a list iterator is a problem for a composite list as going back in the order of the list is an issue, as are the other methods like set() and add() (and especially, remove).
java.util.ListIterator<E>	listIterator(int index) a list iterator is a problem for a composite list as going back in the order of the list is an issue, as are the other methods like set() and add() (and especially, remove).
boolean	noneSatisfy(com.gs.collections.api.block.predicate.Predicate<? super E> predicate) Returns true if the predicate evaluates to false for every element of the iterable or if the iterable is empty.
<P> boolean	noneSatisfyWith(com.gs.collections.api.block.predicate.Predicate2<? super E,? super P> predicate, P parameter) Returns true if the predicate evaluates to false for every element of the collection, or return false.
<R extends java.util.Collection<E>> R	reject(com.gs.collections.api.block.predicate.Predicate<? super E> predicate, R target) Same as the reject method with one parameter but uses the specified target collection for the results.
<P,R extends java.util.Collection<E>> R	rejectWith(com.gs.collections.api.block.predicate.Predicate2<? super E,? super P> predicate, P parameter, R target) Similar to RichIterable.reject(Predicate, Collection), except with an evaluation parameter for the second generic argument in Predicate2.
E	remove(int index)
boolean	remove(java.lang.Object object)
boolean	removeAll(java.util.Collection<?> collection)
void	resetSize()
boolean	retainAll(java.util.Collection<?> collection)
void	reverseForEach(com.gs.collections.api.block.procedure.Procedure<? super E> procedure) Evaluates the procedure for each element of the list iterating in reverse order.
CompositeFastList<E>	reverseThis() Mutates the current list by reversing its order and returns the current list as a result
<R extends java.util.Collection<E>> R	select(com.gs.collections.api.block.predicate.Predicate<? super E> predicate, R target) Same as the select method with one parameter but uses the specified target collection for the results.
<P,R extends java.util.Collection<E>> R	selectWith(com.gs.collections.api.block.predicate.Predicate2<? super E,? super P> predicate, P parameter, R target) Similar to RichIterable.select(Predicate, Collection), except with an evaluation parameter for the second generic argument in Predicate2.
E	set(int index, E element)
int	size() Returns the number of items in this iterable.
java.lang.Object[]	toArray() Converts this iterable to an array.
java.lang.Object[]	toArray(java.lang.Object[] array) Converts this iterable to an array using the specified target array, assuming the target array is as long or longer than the iterable.

Methods inherited from class com.gs.collections.impl.list.mutable.AbstractMutableList

appendString, appendString, asReversed, asSynchronized, asUnmodifiable, binarySearch, binarySearch, collect, collectBoolean, collectByte, collectChar, collectDouble, collectFloat, collectIf, collectIf, collectInt, collectLong, collectShort, collectWith, corresponds, detect, detectIfNone, detectIndex, detectLastIndex, detectWith, detectWithIfNone, distinct, distinct, drop, dropWhile, equals, flatCollect, flatCollect, forEach, forEachWithIndex, getFirst, getLast, groupBy, groupByEach, groupByUniqueKey, hashCode, injectIntoWith, max, max, maxBy, min, min, minBy, newEmpty, partition, partitionWhile, partitionWith, reject, rejectWith, removeIf, removeIfWith, select, selectAndRejectWith, selectInstancesOf, selectWith, shuffleThis, shuffleThis, sortThis, sortThis, sortThisBy, sortThisByBoolean, sortThisByByte, sortThisByChar, sortThisByDouble, sortThisByFloat, sortThisByInt, sortThisByLong, sortThisByShort, subList, sumOfDouble, sumOfFloat, sumOfInt, sumOfLong, take, takeWhile, tap, toImmutable, toList, toReversed, toSet, toSortedList, toSortedList, toStack, with, withAll, without, withoutAll, zip, zip, zipWithIndex, zipWithIndex

Methods inherited from class com.gs.collections.impl.collection.mutable.AbstractMutableCollection

addAllIterable, aggregateBy, aggregateInPlaceBy, chunk, removeAllIterable, retainAllIterable

Methods inherited from class com.gs.collections.impl.AbstractRichIterable

appendString, asLazy, collectBoolean, collectByte, collectChar, collectDouble, collectFloat, collectInt, collectLong, collectShort, containsAllArguments, containsAllIterable, forEach, groupBy, groupByEach, groupByUniqueKey, makeString, makeString, makeString, notEmpty, sumByDouble, sumByFloat, sumByInt, sumByLong, toBag, toMap, toSortedBag, toSortedBag, toSortedBagBy, toSortedListBy, toSortedMap, toSortedMap, toSortedSet, toSortedSet, toSortedSetBy, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.gs.collections.impl.parallel.BatchIterable

forEach

Methods inherited from interface com.gs.collections.api.collection.MutableCollection

addAllIterable, aggregateBy, aggregateInPlaceBy, removeAllIterable, retainAllIterable

Methods inherited from interface com.gs.collections.api.RichIterable

appendString, asLazy, chunk, collectBoolean, collectByte, collectChar, collectDouble, collectFloat, collectInt, collectLong, collectShort, containsAllArguments, containsAllIterable, groupBy, groupByEach, groupByUniqueKey, makeString, makeString, makeString, notEmpty, sumByDouble, sumByFloat, sumByInt, sumByLong, toBag, toMap, toSortedBag, toSortedBag, toSortedBagBy, toSortedListBy, toSortedMap, toSortedMap, toSortedSet, toSortedSet, toSortedSetBy, toString

Methods inherited from interface com.gs.collections.api.InternalIterable

forEach

Constructor Detail

CompositeFastList

public CompositeFastList()

Method Detail

clone

public com.gs.collections.api.list.MutableList<E> clone()

Specified by:

clone in interface com.gs.collections.api.list.MutableList<E>

Overrides:

clone in class AbstractMutableList<E>

size

public int size()

Description copied from interface: com.gs.collections.api.RichIterable

Returns the number of items in this iterable.

Specified by:

size in interface com.gs.collections.api.RichIterable<E>

Specified by:

size in interface BatchIterable<E>

Specified by:

size in interface java.util.Collection<E>

Specified by:

size in interface java.util.List<E>

resetSize

public void resetSize()

batchForEach

public void batchForEach(com.gs.collections.api.block.procedure.Procedure<? super E> procedure,
                int sectionIndex,
                int sectionCount)

Specified by:

batchForEach in interface BatchIterable<E>

getBatchCount

public int getBatchCount(int batchSize)

Specified by:

getBatchCount in interface BatchIterable<E>

reverseThis

public CompositeFastList<E> reverseThis()

Description copied from interface: com.gs.collections.api.list.MutableList

Mutates the current list by reversing its order and returns the current list as a result

Specified by:

reverseThis in interface com.gs.collections.api.list.MutableList<E>

Overrides:

reverseThis in class AbstractMutableList<E>

each

public void each(com.gs.collections.api.block.procedure.Procedure<? super E> procedure)

Description copied from interface: com.gs.collections.api.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()));
 

Example using an anonymous inner class:

 people.each(new Procedure()
 {
     public void value(Person 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 com.gs.collections.api.RichIterable<E>

Overrides:

each in class AbstractMutableList<E>

See Also:

InternalIterable.forEach(Procedure), Iterable#forEach(java.util.function.Consumer)

injectInto

public <IV> IV injectInto(IV injectedValue,
                 com.gs.collections.api.block.function.Function2<? super IV,? super E,? extends IV> function)

Description copied from interface: com.gs.collections.api.RichIterable

Returns the final result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter. This method is commonly called fold or sometimes reduce.

Specified by:

injectInto in interface com.gs.collections.api.RichIterable<E>

Overrides:

injectInto in class AbstractMutableList<E>

injectInto

public int injectInto(int injectedValue,
             com.gs.collections.api.block.function.primitive.IntObjectToIntFunction<? super E> function)

Description copied from interface: com.gs.collections.api.RichIterable

Returns the final int result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter.

Specified by:

injectInto in interface com.gs.collections.api.RichIterable<E>

Overrides:

injectInto in class AbstractMutableList<E>

injectInto

public float injectInto(float injectedValue,
               com.gs.collections.api.block.function.primitive.FloatObjectToFloatFunction<? super E> function)

Description copied from interface: com.gs.collections.api.RichIterable

Returns the final float result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter.

Specified by:

injectInto in interface com.gs.collections.api.RichIterable<E>

Overrides:

injectInto in class AbstractMutableList<E>

injectInto

public long injectInto(long injectedValue,
              com.gs.collections.api.block.function.primitive.LongObjectToLongFunction<? super E> function)

Description copied from interface: com.gs.collections.api.RichIterable

Returns the final long result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter.

Specified by:

injectInto in interface com.gs.collections.api.RichIterable<E>

Overrides:

injectInto in class AbstractMutableList<E>

injectInto

public double injectInto(double injectedValue,
                com.gs.collections.api.block.function.primitive.DoubleObjectToDoubleFunction<? super E> function)

Description copied from interface: com.gs.collections.api.RichIterable

Returns the final double result of evaluating function using each element of the iterable and the previous evaluation result as the parameters. The injected value is used for the first parameter of the first evaluation, and the current item in the iterable is used as the second parameter.

Specified by:

injectInto in interface com.gs.collections.api.RichIterable<E>

Overrides:

injectInto in class AbstractRichIterable<E>

forEachWithIndex

public void forEachWithIndex(com.gs.collections.api.block.procedure.primitive.ObjectIntProcedure<? super E> objectIntProcedure)

Description copied from interface: com.gs.collections.api.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()
 {
     public void value(Person person, int index)
     {
         LOGGER.info("Index: " + index + " person: " + person.getName());
     }
 });
 

Specified by:

forEachWithIndex in interface com.gs.collections.api.InternalIterable<E>

Specified by:

forEachWithIndex in interface com.gs.collections.api.ordered.OrderedIterable<E>

Overrides:

forEachWithIndex in class AbstractMutableList<E>

reverseForEach

public void reverseForEach(com.gs.collections.api.block.procedure.Procedure<? super E> procedure)

Description copied from interface: com.gs.collections.api.ordered.ReversibleIterable

Evaluates the procedure for each element of the list iterating in reverse order.

e.g.
 people.reverseForEach(new Procedure()
 {
     public void value(Person person)
     {
         LOGGER.info(person.getName());
     }
 });
 

Specified by:

reverseForEach in interface com.gs.collections.api.ordered.ReversibleIterable<E>

Overrides:

reverseForEach in class AbstractMutableList<E>

forEachWith

public <P> void forEachWith(com.gs.collections.api.block.procedure.Procedure2<? super E,? super P> procedure2,
                   P parameter)

Description copied from interface: com.gs.collections.api.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()
 {
     public void value(Person person, Person other)
     {
         if (person.isRelatedTo(other))
         {
              LOGGER.info(person.getName());
         }
     }
 }, fred);
 

Specified by:

forEachWith in interface com.gs.collections.api.InternalIterable<E>

Overrides:

forEachWith in class AbstractMutableList<E>

isEmpty

public boolean isEmpty()

Description copied from interface: com.gs.collections.api.RichIterable

Returns true if this iterable has zero items.

Specified by:

isEmpty in interface com.gs.collections.api.RichIterable<E>

Specified by:

isEmpty in interface java.util.Collection<E>

Specified by:

isEmpty in interface java.util.List<E>

Overrides:

isEmpty in class AbstractRichIterable<E>

contains

public boolean contains(java.lang.Object object)

Description copied from interface: com.gs.collections.api.RichIterable

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

Specified by:

contains in interface com.gs.collections.api.RichIterable<E>

Specified by:

contains in interface java.util.Collection<E>

Specified by:

contains in interface java.util.List<E>

Overrides:

contains in class AbstractMutableList<E>

iterator

public java.util.Iterator<E> iterator()

Specified by:

iterator in interface java.lang.Iterable<E>

Specified by:

iterator in interface java.util.Collection<E>

Specified by:

iterator in interface java.util.List<E>

Overrides:

iterator in class AbstractMutableList<E>

toArray

public java.lang.Object[] toArray()

Description copied from interface: com.gs.collections.api.RichIterable

Converts this iterable to an array.

Specified by:

toArray in interface com.gs.collections.api.RichIterable<E>

Specified by:

toArray in interface java.util.Collection<E>

Specified by:

toArray in interface java.util.List<E>

Overrides:

toArray in class AbstractRichIterable<E>

See Also:

Collection.toArray()

add

public boolean add(E object)

Specified by:

add in interface java.util.Collection<E>

Specified by:

add in interface java.util.List<E>

Overrides:

add in class AbstractMutableCollection<E>

remove

public boolean remove(java.lang.Object object)

Specified by:

remove in interface java.util.Collection<E>

Specified by:

remove in interface java.util.List<E>

Overrides:

remove in class AbstractMutableCollection<E>

addAll

public boolean addAll(java.util.Collection<? extends E> collection)

Specified by:

addAll in interface java.util.Collection<E>

Specified by:

addAll in interface java.util.List<E>

Overrides:

addAll in class AbstractMutableCollection<E>

containsAll

public boolean containsAll(java.util.Collection<?> collection)

Description copied from interface: com.gs.collections.api.RichIterable

Returns true if all elements in source are contained in this collection.

Specified by:

containsAll in interface com.gs.collections.api.RichIterable<E>

Specified by:

containsAll in interface java.util.Collection<E>

Specified by:

containsAll in interface java.util.List<E>

Overrides:

containsAll in class AbstractMutableList<E>

See Also:

Collection.containsAll(Collection)

toArray

public java.lang.Object[] toArray(java.lang.Object[] array)

Description copied from interface: com.gs.collections.api.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 com.gs.collections.api.RichIterable<E>

Specified by:

toArray in interface java.util.Collection<E>

Specified by:

toArray in interface java.util.List<E>

Overrides:

toArray in class AbstractRichIterable<E>

See Also:

Collection.toArray(Object[])

addComposited

public void addComposited(java.util.Collection<? extends E> collection)

addAll

public boolean addAll(int index,
             java.util.Collection<? extends E> collection)

Specified by:

addAll in interface java.util.List<E>

clear

public void clear()

Specified by:

clear in interface java.util.Collection<E>

Specified by:

clear in interface java.util.List<E>

retainAll

public boolean retainAll(java.util.Collection<?> collection)

Specified by:

retainAll in interface java.util.Collection<E>

Specified by:

retainAll in interface java.util.List<E>

Overrides:

retainAll in class AbstractMutableList<E>

removeAll

public boolean removeAll(java.util.Collection<?> collection)

Specified by:

removeAll in interface java.util.Collection<E>

Specified by:

removeAll in interface java.util.List<E>

Overrides:

removeAll in class AbstractMutableList<E>

get

public E get(int index)

Description copied from interface: com.gs.collections.api.list.ListIterable

Returns the item at the specified position in this list iterable.

Specified by:

get in interface com.gs.collections.api.list.ListIterable<E>

Specified by:

get in interface java.util.List<E>

set

public E set(int index,
    E element)

Specified by:

set in interface java.util.List<E>

add

public void add(int index,
       E element)

Specified by:

add in interface java.util.List<E>

remove

public E remove(int index)

Specified by:

remove in interface java.util.List<E>

indexOf

public int indexOf(java.lang.Object o)

Description copied from interface: com.gs.collections.api.ordered.OrderedIterable

Returns the index of the first occurrence of the specified item in this iterable, or -1 if this iterable does not contain the item.

Specified by:

indexOf in interface com.gs.collections.api.ordered.OrderedIterable<E>

Specified by:

indexOf in interface java.util.List<E>

Overrides:

indexOf in class AbstractMutableList<E>

See Also:

List.indexOf(Object)

lastIndexOf

public int lastIndexOf(java.lang.Object o)

Description copied from interface: com.gs.collections.api.list.ListIterable

Returns the index of the last occurrence of the specified item in this list, or -1 if this list does not contain the item.

Specified by:

lastIndexOf in interface com.gs.collections.api.list.ListIterable<E>

Specified by:

lastIndexOf in interface java.util.List<E>

Overrides:

lastIndexOf in class AbstractMutableList<E>

listIterator

public java.util.ListIterator<E> listIterator()

a list iterator is a problem for a composite list as going back in the order of the list is an issue, as are the other methods like set() and add() (and especially, remove). Convert the internal lists to one list (if not already just one list) and return that list's list iterator.

AFAIK list iterator is only commonly used in sorting.

Specified by:

listIterator in interface com.gs.collections.api.list.ListIterable<E>

Specified by:

listIterator in interface java.util.List<E>

Overrides:

listIterator in class AbstractMutableList<E>

Returns:

a ListIterator for this, with internal state convertedto one list if needed.

See Also:

List.listIterator()

listIterator

public java.util.ListIterator<E> listIterator(int index)

a list iterator is a problem for a composite list as going back in the order of the list is an issue, as are the other methods like set() and add() (and especially, remove). Convert the internal lists to one list (if not already just one list) and return that list's list iterator.

AFAIK list iterator is only commonly used in sorting.

Specified by:

listIterator in interface com.gs.collections.api.list.ListIterable<E>

Specified by:

listIterator in interface java.util.List<E>

Overrides:

listIterator in class AbstractMutableList<E>

Returns:

a ListIterator for this, with internal state convertedto one list if needed.

See Also:

List.listIterator(int)

count

public int count(com.gs.collections.api.block.predicate.Predicate<? super E> predicate)

Description copied from interface: com.gs.collections.api.RichIterable

Return the total number of elements that answer true to the specified predicate.

Example using a Java 8 lambda expression:

 int count =
     people.count(person -> person.getAddress().getState().getName().equals("New York"));
 

Example using an anonymous inner class:

 int count =
     people.count(new Predicate<Person>()
     {
         public boolean accept(Person person)
         {
             return person.getAddress().getState().getName().equals("New York");
         }
     });
 

Specified by:

count in interface com.gs.collections.api.RichIterable<E>

Overrides:

count in class AbstractMutableList<E>

countWith

public <P> int countWith(com.gs.collections.api.block.predicate.Predicate2<? super E,? super P> predicate,
                P parameter)

Description copied from interface: com.gs.collections.api.RichIterable

Returns the total number of elements that evaluate to true for the specified predicate.

e.g.
 return lastNames.countWith(PredicatesLite.equal(), "Smith");
 

Specified by:

countWith in interface com.gs.collections.api.RichIterable<E>

Overrides:

countWith in class AbstractMutableList<E>

anySatisfy

public boolean anySatisfy(com.gs.collections.api.block.predicate.Predicate<? super E> predicate)

Description copied from interface: com.gs.collections.api.RichIterable

Returns true if the predicate evaluates to true for any element of the iterable. Returns false if the iterable is empty, or if no element returned true when evaluating the predicate.

Specified by:

anySatisfy in interface com.gs.collections.api.RichIterable<E>

Overrides:

anySatisfy in class AbstractMutableList<E>

select

public <R extends java.util.Collection<E>> R select(com.gs.collections.api.block.predicate.Predicate<? super E> predicate,
                                           R target)

Description copied from interface: com.gs.collections.api.RichIterable

Same as the select method with one parameter but uses the specified target collection for the results.

Example using a Java 8 lambda expression:

 MutableList<Person> selected =
     people.select(person -> person.person.getLastName().equals("Smith"), Lists.mutable.empty());
 

Example using an anonymous inner class:

 MutableList<Person> selected =
     people.select(new Predicate<Person>()
     {
         public boolean accept(Person person)
         {
             return person.person.getLastName().equals("Smith");
         }
     }, Lists.mutable.empty());
 

Specified by:

select in interface com.gs.collections.api.RichIterable<E>

Overrides:

select in class AbstractMutableList<E>

Parameters:

predicate - a Predicate to use as the select criteria

target - the Collection to append to for all elements in this RichIterable that meet select criteria predicate

Returns:

target, which contains appended elements as a result of the select criteria

See Also:

RichIterable.select(Predicate)

selectWith

public <P,R extends java.util.Collection<E>> R selectWith(com.gs.collections.api.block.predicate.Predicate2<? super E,? super P> predicate,
                                                 P parameter,
                                                 R target)

Description copied from interface: com.gs.collections.api.RichIterable

Similar to RichIterable.select(Predicate, Collection), 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:

 MutableList<Person> selected =
     people.selectWith((Person person, Integer age) -> person.getAge() >= age, Integer.valueOf(18), Lists.mutable.empty());
 

Example using an anonymous inner class:

 MutableList<Person> selected =
     people.selectWith(new Predicate2<Person, Integer>()
     {
         public boolean accept(Person person, Integer age)
         {
             return person.getAge() >= age;
         }
     }, Integer.valueOf(18), Lists.mutable.empty());
 

Specified by:

selectWith in interface com.gs.collections.api.RichIterable<E>

Overrides:

selectWith in class AbstractMutableList<E>

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

target - the Collection to append to for all elements in this RichIterable that meet select criteria predicate

Returns:

targetCollection, which contains appended elements as a result of the select criteria

See Also:

RichIterable.select(Predicate), RichIterable.select(Predicate, Collection)

reject

public <R extends java.util.Collection<E>> R reject(com.gs.collections.api.block.predicate.Predicate<? super E> predicate,
                                           R target)

Description copied from interface: com.gs.collections.api.RichIterable

Same as the reject method with one parameter but uses the specified target collection for the results.

Example using a Java 8 lambda expression:

 MutableList<Person> rejected =
     people.reject(person -> person.person.getLastName().equals("Smith"), Lists.mutable.empty());
 

Example using an anonymous inner class:

 MutableList<Person> rejected =
     people.reject(new Predicate<Person>()
     {
         public boolean accept(Person person)
         {
             return person.person.getLastName().equals("Smith");
         }
     }, Lists.mutable.empty());
 

Specified by:

reject in interface com.gs.collections.api.RichIterable<E>

Overrides:

reject in class AbstractMutableList<E>

Parameters:

predicate - a Predicate to use as the reject criteria

target - the Collection to append to for all elements in this RichIterable that cause Predicate#accept(Object) method to evaluate to false

Returns:

target, which contains appended elements as a result of the reject criteria

rejectWith

public <P,R extends java.util.Collection<E>> R rejectWith(com.gs.collections.api.block.predicate.Predicate2<? super E,? super P> predicate,
                                                 P parameter,
                                                 R target)

Description copied from interface: com.gs.collections.api.RichIterable

Similar to RichIterable.reject(Predicate, Collection), 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:

 MutableList<Person> rejected =
     people.rejectWith((Person person, Integer age) -> person.getAge() < age, Integer.valueOf(18), Lists.mutable.empty());
 

Example using an anonymous inner class:

 MutableList<Person> rejected =
     people.rejectWith(new Predicate2<Person, Integer>()
     {
         public boolean accept(Person person, Integer age)
         {
             return person.getAge() < age;
         }
     }, Integer.valueOf(18), Lists.mutable.empty());
 

Specified by:

rejectWith in interface com.gs.collections.api.RichIterable<E>

Overrides:

rejectWith in class AbstractMutableList<E>

Parameters:

predicate - a Predicate2 to use as the reject criteria

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

target - the Collection to append to for all elements in this RichIterable that cause Predicate#accept(Object) method to evaluate to false

Returns:

targetCollection, which contains appended elements as a result of the reject criteria

See Also:

RichIterable.reject(Predicate), RichIterable.reject(Predicate, Collection)

collect

public <V,R extends java.util.Collection<V>> R collect(com.gs.collections.api.block.function.Function<? super E,? extends V> function,
                                              R target)

Description copied from interface: com.gs.collections.api.RichIterable

Same as RichIterable.collect(Function), except that the results are gathered into the specified target collection.

Example using a Java 8 lambda expression:

 MutableList<String> names =
     people.collect(person -> person.getFirstName() + " " + person.getLastName(), Lists.mutable.empty());
 

Example using an anonymous inner class:

 MutableList<String> names =
     people.collect(new Function<Person, String>()
     {
         public String valueOf(Person person)
         {
             return person.getFirstName() + " " + person.getLastName();
         }
     }, Lists.mutable.empty());
 

Specified by:

collect in interface com.gs.collections.api.RichIterable<E>

Overrides:

collect in class AbstractMutableList<E>

Parameters:

function - a Function to use as the collect transformation function

target - the Collection to append to for all elements in this RichIterable that meet select criteria function

Returns:

target, which contains appended elements as a result of the collect transformation

See Also:

RichIterable.collect(Function)

collectWith

public <P,A,R extends java.util.Collection<A>> R collectWith(com.gs.collections.api.block.function.Function2<? super E,? super P,? extends A> function,
                                                    P parameter,
                                                    R target)

Description copied from interface: com.gs.collections.api.RichIterable

Same as collectWith but with a targetCollection parameter to gather the results.

Example using a Java 8 lambda expression:

 MutableSet<Integer> integers =
     Lists.mutable.with(1, 2, 3).collectWith((each, parameter) -> each + parameter, Integer.valueOf(1), Sets.mutable.empty());
 

Example using an anonymous inner class:

 Function2 addParameterFunction =
     new Function2()
     {
         public Integer value(final Integer each, final Integer parameter)
         {
             return each + parameter;
         }
     };
 MutableSet<Integer> integers =
     Lists.mutable.with(1, 2, 3).collectWith(addParameterFunction, Integer.valueOf(1), Sets.mutable.empty());
 

Specified by:

collectWith in interface com.gs.collections.api.RichIterable<E>

Overrides:

collectWith in class AbstractMutableList<E>

Parameters:

function - a Function2 to use as the collect transformation function

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

target - the Collection to append to for all elements in this RichIterable that meet select criteria function

Returns:

targetCollection, which contains appended elements as a result of the collect transformation

anySatisfyWith

public <P> boolean anySatisfyWith(com.gs.collections.api.block.predicate.Predicate2<? super E,? super P> predicate,
                         P parameter)

Description copied from interface: com.gs.collections.api.RichIterable

Returns true if the predicate evaluates to true for any element of the collection, or return false. Returns false if the collection is empty.

Specified by:

anySatisfyWith in interface com.gs.collections.api.RichIterable<E>

Overrides:

anySatisfyWith in class AbstractMutableList<E>

allSatisfy

public boolean allSatisfy(com.gs.collections.api.block.predicate.Predicate<? super E> predicate)

Description copied from interface: com.gs.collections.api.RichIterable

Returns true if the predicate evaluates to true for every element of the iterable or if the iterable is empty. Otherwise, returns false.

Specified by:

allSatisfy in interface com.gs.collections.api.RichIterable<E>

Overrides:

allSatisfy in class AbstractMutableList<E>

allSatisfyWith

public <P> boolean allSatisfyWith(com.gs.collections.api.block.predicate.Predicate2<? super E,? super P> predicate,
                         P parameter)

Description copied from interface: com.gs.collections.api.RichIterable

Returns true if the predicate evaluates to true for every element of the collection, or returns false.

Specified by:

allSatisfyWith in interface com.gs.collections.api.RichIterable<E>

Overrides:

allSatisfyWith in class AbstractMutableList<E>

noneSatisfy

public boolean noneSatisfy(com.gs.collections.api.block.predicate.Predicate<? super E> predicate)

Description copied from interface: com.gs.collections.api.RichIterable

Returns true if the predicate evaluates to false for every element of the iterable or if the iterable is empty. Otherwise, returns false.

Specified by:

noneSatisfy in interface com.gs.collections.api.RichIterable<E>

Overrides:

noneSatisfy in class AbstractMutableList<E>

noneSatisfyWith

public <P> boolean noneSatisfyWith(com.gs.collections.api.block.predicate.Predicate2<? super E,? super P> predicate,
                          P parameter)

Description copied from interface: com.gs.collections.api.RichIterable

Returns true if the predicate evaluates to false for every element of the collection, or return false. Returns true if the collection is empty.

Specified by:

noneSatisfyWith in interface com.gs.collections.api.RichIterable<E>

Overrides:

noneSatisfyWith in class AbstractMutableList<E>

defaultSort

protected void defaultSort(java.util.Comparator<? super E> comparator)

Override in subclasses where it can be optimized.

Overrides:

defaultSort in class AbstractMutableList<E>

asParallel

public com.gs.collections.api.list.ParallelListIterable<E> asParallel(java.util.concurrent.ExecutorService executorService,
                                                             int batchSize)

Description copied from interface: com.gs.collections.api.list.ListIterable

Returns a parallel iterable of this ListIterable.

Specified by:

asParallel in interface com.gs.collections.api.list.ListIterable<E>

Overrides:

asParallel in class AbstractMutableList<E>