com.gs.collections.impl.utility.ListIterate Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of gs-collections Show documentation
Show all versions of gs-collections Show documentation
GS Collections is a collections framework for Java. It has JDK-compatible List, Set and Map
implementations with a rich API and set of utility classes that work with any JDK compatible Collections,
Arrays, Maps or Strings. The iteration protocol was inspired by the Smalltalk collection framework.
/*
* Copyright 2013 Goldman Sachs.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.gs.collections.impl.utility;
import java.util.Collection;
import java.util.Collections;
import java.util.Comparator;
import java.util.Iterator;
import java.util.List;
import java.util.ListIterator;
import java.util.RandomAccess;
import com.gs.collections.api.RichIterable;
import com.gs.collections.api.block.function.Function;
import com.gs.collections.api.block.function.Function2;
import com.gs.collections.api.block.function.Function3;
import com.gs.collections.api.block.function.primitive.BooleanFunction;
import com.gs.collections.api.block.function.primitive.ByteFunction;
import com.gs.collections.api.block.function.primitive.CharFunction;
import com.gs.collections.api.block.function.primitive.DoubleFunction;
import com.gs.collections.api.block.function.primitive.DoubleObjectToDoubleFunction;
import com.gs.collections.api.block.function.primitive.FloatFunction;
import com.gs.collections.api.block.function.primitive.FloatObjectToFloatFunction;
import com.gs.collections.api.block.function.primitive.IntFunction;
import com.gs.collections.api.block.function.primitive.IntObjectToIntFunction;
import com.gs.collections.api.block.function.primitive.LongFunction;
import com.gs.collections.api.block.function.primitive.LongObjectToLongFunction;
import com.gs.collections.api.block.function.primitive.ShortFunction;
import com.gs.collections.api.block.predicate.Predicate;
import com.gs.collections.api.block.predicate.Predicate2;
import com.gs.collections.api.block.procedure.Procedure;
import com.gs.collections.api.block.procedure.Procedure2;
import com.gs.collections.api.block.procedure.primitive.ObjectIntProcedure;
import com.gs.collections.api.collection.MutableCollection;
import com.gs.collections.api.collection.primitive.MutableBooleanCollection;
import com.gs.collections.api.collection.primitive.MutableByteCollection;
import com.gs.collections.api.collection.primitive.MutableCharCollection;
import com.gs.collections.api.collection.primitive.MutableDoubleCollection;
import com.gs.collections.api.collection.primitive.MutableFloatCollection;
import com.gs.collections.api.collection.primitive.MutableIntCollection;
import com.gs.collections.api.collection.primitive.MutableLongCollection;
import com.gs.collections.api.collection.primitive.MutableShortCollection;
import com.gs.collections.api.list.ListIterable;
import com.gs.collections.api.list.MutableList;
import com.gs.collections.api.list.primitive.MutableBooleanList;
import com.gs.collections.api.list.primitive.MutableByteList;
import com.gs.collections.api.list.primitive.MutableCharList;
import com.gs.collections.api.list.primitive.MutableDoubleList;
import com.gs.collections.api.list.primitive.MutableFloatList;
import com.gs.collections.api.list.primitive.MutableIntList;
import com.gs.collections.api.list.primitive.MutableLongList;
import com.gs.collections.api.list.primitive.MutableShortList;
import com.gs.collections.api.multimap.MutableMultimap;
import com.gs.collections.api.partition.list.PartitionMutableList;
import com.gs.collections.api.tuple.Pair;
import com.gs.collections.api.tuple.Twin;
import com.gs.collections.impl.factory.Lists;
import com.gs.collections.impl.list.mutable.FastList;
import com.gs.collections.impl.multimap.list.FastListMultimap;
import com.gs.collections.impl.partition.list.PartitionFastList;
import com.gs.collections.impl.utility.internal.IterableIterate;
import com.gs.collections.impl.utility.internal.RandomAccessListIterate;
/**
* The ListIterate utility class can be useful for iterating over lists, especially if there
* is a desire to return a MutableList from any of the iteration methods.
*
* @since 1.0
*/
public final class ListIterate
{
private ListIterate()
{
throw new AssertionError("Suppress default constructor for noninstantiability");
}
public static void toArray(List list, T[] target, int startIndex, int sourceSize)
{
if (list instanceof RandomAccess)
{
RandomAccessListIterate.toArray(list, target, startIndex, sourceSize);
}
else
{
for (int i = 0; i < sourceSize; i++)
{
target[startIndex + i] = list.get(i);
}
}
}
/**
* @see Iterate#select(Iterable, Predicate)
*/
public static MutableList select(List list, Predicate predicate)
{
return ListIterate.select(list, predicate, FastList.newList());
}
/**
* @see Iterate#selectWith(Iterable, Predicate2, Object)
*/
public static MutableList selectWith(
List list,
Predicate2 predicate,
IV injectedValue)
{
return ListIterate.selectWith(list, predicate, injectedValue, FastList.newList());
}
/**
* @see Iterate#select(Iterable, Predicate, Collection)
*/
public static > R select(
List list,
Predicate predicate,
R targetCollection)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.select(list, predicate, targetCollection);
}
return IterableIterate.select(list, predicate, targetCollection);
}
/**
* @see Iterate#selectWith(Iterable, Predicate2, Object, Collection)
*/
public static > R selectWith(
List list,
Predicate2 predicate,
P parameter,
R targetCollection)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.selectWith(list, predicate, parameter, targetCollection);
}
return IterableIterate.selectWith(list, predicate, parameter, targetCollection);
}
/**
* @see Iterate#selectInstancesOf(Iterable, Class)
*/
public static MutableList selectInstancesOf(
List list,
Class clazz)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.selectInstancesOf(list, clazz);
}
return IterableIterate.selectInstancesOf(list, clazz);
}
/**
* @see Iterate#count(Iterable, Predicate)
*/
public static int count(List list, Predicate predicate)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.count(list, predicate);
}
return IterableIterate.count(list, predicate);
}
/**
* @see Iterate#countWith(Iterable, Predicate2, Object)
*/
public static int countWith(
List list,
Predicate2 predicate,
IV injectedValue)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.countWith(list, predicate, injectedValue);
}
return IterableIterate.countWith(list, predicate, injectedValue);
}
/**
* @see Iterate#collectIf(Iterable, Predicate, Function)
*/
public static MutableList collectIf(
List list,
Predicate predicate,
Function function)
{
return ListIterate.collectIf(list, predicate, function, FastList.newList());
}
/**
* @see Iterate#collectIf(Iterable, Predicate, Function, Collection)
*/
public static > R collectIf(
List list,
Predicate predicate,
Function function,
R targetCollection)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectIf(list, predicate, function, targetCollection);
}
return IterableIterate.collectIf(list, predicate, function, targetCollection);
}
/**
* @see Iterate#reject(Iterable, Predicate)
*/
public static MutableList reject(List list, Predicate predicate)
{
return ListIterate.reject(list, predicate, FastList.newList());
}
/**
* @see Iterate#rejectWith(Iterable, Predicate2, Object)
*/
public static MutableList rejectWith(
List list,
Predicate2 predicate,
IV injectedValue)
{
return ListIterate.rejectWith(list, predicate, injectedValue, FastList.newList());
}
/**
* @see Iterate#reject(Iterable, Predicate, Collection)
*/
public static > R reject(
List list,
Predicate predicate,
R targetCollection)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.reject(list, predicate, targetCollection);
}
return IterableIterate.reject(list, predicate, targetCollection);
}
/**
* @see Iterate#reject(Iterable, Predicate, Collection)
*/
public static > R rejectWith(
List list,
Predicate2 predicate,
P parameter,
R targetCollection)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.rejectWith(list, predicate, parameter, targetCollection);
}
return IterableIterate.rejectWith(list, predicate, parameter, targetCollection);
}
/**
* @see Iterate#collect(Iterable, Function)
*/
public static MutableList collect(
List list,
Function function)
{
return ListIterate.collect(list, function, FastList.newList(list.size()));
}
/**
* @see Iterate#collect(Iterable, Function, Collection)
*/
public static > R collect(
List list,
Function function,
R targetCollection)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collect(list, function, targetCollection);
}
return IterableIterate.collect(list, function, targetCollection);
}
/**
* @see Iterate#collectBoolean(Iterable, BooleanFunction)
*/
public static MutableBooleanList collectBoolean(
List list,
BooleanFunction booleanFunction)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectBoolean(list, booleanFunction);
}
return (MutableBooleanList) IterableIterate.collectBoolean(list, booleanFunction);
}
/**
* @see Iterate#collectBoolean(Iterable, BooleanFunction, MutableBooleanCollection)
*/
public static R collectBoolean(
List list,
BooleanFunction booleanFunction,
R target)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectBoolean(list, booleanFunction, target);
}
return IterableIterate.collectBoolean(list, booleanFunction, target);
}
/**
* @see Iterate#collectByte(Iterable, ByteFunction)
*/
public static MutableByteList collectByte(
List list,
ByteFunction byteFunction)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectByte(list, byteFunction);
}
return (MutableByteList) IterableIterate.collectByte(list, byteFunction);
}
/**
* @see Iterate#collectByte(Iterable, ByteFunction, MutableByteCollection)
*/
public static R collectByte(
List list,
ByteFunction byteFunction,
R target)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectByte(list, byteFunction, target);
}
return IterableIterate.collectByte(list, byteFunction, target);
}
/**
* @see Iterate#collectChar(Iterable, CharFunction)
*/
public static MutableCharList collectChar(
List list,
CharFunction charFunction)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectChar(list, charFunction);
}
return (MutableCharList) IterableIterate.collectChar(list, charFunction);
}
/**
* @see Iterate#collectChar(Iterable, CharFunction, MutableCharCollection)
*/
public static R collectChar(
List list,
CharFunction charFunction,
R target)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectChar(list, charFunction, target);
}
return IterableIterate.collectChar(list, charFunction, target);
}
/**
* @see Iterate#collectDouble(Iterable, DoubleFunction)
*/
public static MutableDoubleList collectDouble(
List list,
DoubleFunction doubleFunction)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectDouble(list, doubleFunction);
}
return (MutableDoubleList) IterableIterate.collectDouble(list, doubleFunction);
}
/**
* @see Iterate#collectDouble(Iterable, DoubleFunction, MutableDoubleCollection)
*/
public static R collectDouble(
List list,
DoubleFunction doubleFunction,
R target)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectDouble(list, doubleFunction, target);
}
return IterableIterate.collectDouble(list, doubleFunction, target);
}
/**
* @see Iterate#collectFloat(Iterable, FloatFunction)
*/
public static MutableFloatList collectFloat(
List list,
FloatFunction floatFunction)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectFloat(list, floatFunction);
}
return (MutableFloatList) IterableIterate.collectFloat(list, floatFunction);
}
/**
* @see Iterate#collectFloat(Iterable, FloatFunction, MutableFloatCollection)
*/
public static R collectFloat(
List list,
FloatFunction floatFunction,
R target)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectFloat(list, floatFunction, target);
}
return IterableIterate.collectFloat(list, floatFunction, target);
}
/**
* @see Iterate#collectInt(Iterable, IntFunction)
*/
public static MutableIntList collectInt(
List list,
IntFunction intFunction)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectInt(list, intFunction);
}
return (MutableIntList) IterableIterate.collectInt(list, intFunction);
}
/**
* @see Iterate#collectInt(Iterable, IntFunction, MutableIntCollection)
*/
public static R collectInt(
List list,
IntFunction intFunction,
R target)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectInt(list, intFunction, target);
}
return IterableIterate.collectInt(list, intFunction, target);
}
/**
* @see Iterate#collectLong(Iterable, LongFunction)
*/
public static MutableLongList collectLong(
List list,
LongFunction longFunction)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectLong(list, longFunction);
}
return (MutableLongList) IterableIterate.collectLong(list, longFunction);
}
/**
* @see Iterate#collectLong(Iterable, LongFunction, MutableLongCollection)
*/
public static R collectLong(
List list,
LongFunction longFunction,
R target)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectLong(list, longFunction, target);
}
return IterableIterate.collectLong(list, longFunction, target);
}
/**
* @see Iterate#collectShort(Iterable, ShortFunction)
*/
public static MutableShortList collectShort(
List list,
ShortFunction shortFunction)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectShort(list, shortFunction);
}
return (MutableShortList) IterableIterate.collectShort(list, shortFunction);
}
/**
* @see Iterate#collectShort(Iterable, ShortFunction, MutableShortCollection)
*/
public static R collectShort(
List list,
ShortFunction shortFunction,
R target)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectShort(list, shortFunction, target);
}
return IterableIterate.collectShort(list, shortFunction, target);
}
/**
* @see Iterate#flatCollect(Iterable, Function)
*/
public static MutableList flatCollect(
List list,
Function> function)
{
return flatCollect(list, function, FastList.newList(list.size()));
}
/**
* @see Iterate#flatCollect(Iterable, Function, Collection)
*/
public static > R flatCollect(
List list,
Function> function,
R targetCollection)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.flatCollect(list, function, targetCollection);
}
return IterableIterate.flatCollect(list, function, targetCollection);
}
/**
* Returns the first element of a list.
*/
public static T getFirst(List collection)
{
return Iterate.isEmpty(collection) ? null : collection.get(0);
}
/**
* Returns the last element of a list.
*/
public static T getLast(List collection)
{
return Iterate.isEmpty(collection) ? null : collection.get(collection.size() - 1);
}
/**
* @see Iterate#forEach(Iterable, Procedure)
*/
public static void forEach(List list, Procedure procedure)
{
if (list instanceof RandomAccess)
{
RandomAccessListIterate.forEach(list, procedure);
}
else
{
IterableIterate.forEach(list, procedure);
}
}
/**
* Iterates over the List in reverse order executing the Procedure for each element
*/
public static void reverseForEach(List list, Procedure procedure)
{
if (!list.isEmpty())
{
ListIterate.forEach(list, list.size() - 1, 0, procedure);
}
}
/**
* Iterates over the List in reverse order executing the Procedure for each element. The index passed into the ObjectIntProcedure is the actual index of the
* range.
*/
public static void reverseForEachWithIndex(List list, ObjectIntProcedure objectIntProcedure)
{
if (!list.isEmpty())
{
ListIterate.forEachWithIndex(list, list.size() - 1, 0, objectIntProcedure);
}
}
/**
* Iterates over the section of the list covered by the specified indexes. The indexes are both inclusive. If the
* from is less than the to, the list is iterated in forward order. If the from is greater than the to, then the
* list is iterated in the reverse order.
*
*
* e.g.
* MutableList people = FastList.newListWith(ted, mary, bob, sally);
* ListIterate.forEach(people, 0, 1, new Procedure()
* {
* public void value(Person person)
* {
* LOGGER.info(person.getName());
* }
* });
*
*
* This code would output ted and mary's names.
*/
public static void forEach(List list, int from, int to, Procedure procedure)
{
ListIterate.rangeCheck(from, to, list.size());
if (list instanceof RandomAccess)
{
RandomAccessListIterate.forEach(list, from, to, procedure);
}
else
{
if (from <= to)
{
ListIterator iterator = list.listIterator(from);
for (int i = from; i <= to; i++)
{
procedure.value(iterator.next());
}
}
else
{
ListIterator iterator = list.listIterator(from + 1);
for (int i = from; i >= to; i--)
{
procedure.value(iterator.previous());
}
}
}
}
/**
* Iterates over the section of the list covered by the specified indexes. The indexes are both inclusive. If the
* from is less than the to, the list is iterated in forward order. If the from is greater than the to, then the
* list is iterated in the reverse order. The index passed into the ObjectIntProcedure is the actual index of the
* range.
*
*
* e.g.
* MutableList people = FastList.newListWith(ted, mary, bob, sally);
* ListIterate.forEachWithIndex(people, 0, 1, new ObjectIntProcedure()
* {
* public void value(Person person, int index)
* {
* LOGGER.info(person.getName() + " at index: " + index);
* }
* });
*
*
* This code would output ted and mary's names.
*/
public static void forEachWithIndex(List list, int from, int to, ObjectIntProcedure objectIntProcedure)
{
ListIterate.rangeCheck(from, to, list.size());
if (list instanceof RandomAccess)
{
RandomAccessListIterate.forEachWithIndex(list, from, to, objectIntProcedure);
}
else
{
if (from <= to)
{
ListIterator iterator = list.listIterator(from);
for (int i = from; i <= to; i++)
{
objectIntProcedure.value(iterator.next(), i);
}
}
else
{
ListIterator iterator = list.listIterator(from + 1);
for (int i = from; i >= to; i--)
{
objectIntProcedure.value(iterator.previous(), i);
}
}
}
}
public static void rangeCheck(int from, int to, int size)
{
if (from < 0)
{
throw new IndexOutOfBoundsException("From index: " + from);
}
if (to < 0)
{
throw new IndexOutOfBoundsException("To index: " + to);
}
if (from >= size)
{
throw new IndexOutOfBoundsException("From index: " + from + " Size: " + size);
}
if (to >= size)
{
throw new IndexOutOfBoundsException("To index: " + to + " Size: " + size);
}
}
/**
* Iterates over both lists together, evaluating Procedure2 with the current element from each list.
*/
public static void forEachInBoth(List list1, List list2, Procedure2 procedure)
{
if (list1 != null && list2 != null)
{
if (list1.size() == list2.size())
{
if (list1 instanceof RandomAccess && list2 instanceof RandomAccess)
{
RandomAccessListIterate.forEachInBoth(list1, list2, procedure);
}
else
{
Iterator iterator1 = list1.iterator();
Iterator iterator2 = list2.iterator();
int size = list2.size();
for (int i = 0; i < size; i++)
{
procedure.value(iterator1.next(), iterator2.next());
}
}
}
else
{
throw new RuntimeException("Attempt to call forEachInBoth with two Lists of different sizes :"
+ list1.size()
+ ':'
+ list2.size());
}
}
}
/**
* @see Iterate#forEachWithIndex(Iterable, ObjectIntProcedure)
*/
public static void forEachWithIndex(List list, ObjectIntProcedure objectIntProcedure)
{
if (list instanceof RandomAccess)
{
RandomAccessListIterate.forEachWithIndex(list, objectIntProcedure);
}
else
{
IterableIterate.forEachWithIndex(list, objectIntProcedure);
}
}
/**
* @see Iterate#detect(Iterable, Predicate)
*/
public static T detect(List list, Predicate predicate)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.detect(list, predicate);
}
return IterableIterate.detect(list, predicate);
}
/**
* @see Iterate#detectWith(Iterable, Predicate2, Object)
*/
public static T detectWith(
List list,
Predicate2 predicate,
IV injectedValue)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.detectWith(list, predicate, injectedValue);
}
return IterableIterate.detectWith(list, predicate, injectedValue);
}
/**
* @see Iterate#detectIfNone(Iterable, Predicate, Object)
*/
public static T detectIfNone(List list, Predicate predicate, T ifNone)
{
T result = ListIterate.detect(list, predicate);
return result == null ? ifNone : result;
}
/**
* @see Iterate#detectWithIfNone(Iterable, Predicate2, Object, Object)
*/
public static T detectWithIfNone(List list, Predicate2 predicate, IV injectedValue, T ifNone)
{
T result = ListIterate.detectWith(list, predicate, injectedValue);
return result == null ? ifNone : result;
}
/**
* @see Iterate#injectInto(Object, Iterable, Function2)
*/
public static IV injectInto(IV injectValue, List list, Function2 function)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.injectInto(injectValue, list, function);
}
return IterableIterate.injectInto(injectValue, list, function);
}
/**
* @see Iterate#injectInto(int, Iterable, IntObjectToIntFunction)
*/
public static int injectInto(int injectValue, List list, IntObjectToIntFunction function)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.injectInto(injectValue, list, function);
}
return IterableIterate.injectInto(injectValue, list, function);
}
/**
* @see Iterate#injectInto(long, Iterable, LongObjectToLongFunction)
*/
public static long injectInto(long injectValue, List list, LongObjectToLongFunction function)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.injectInto(injectValue, list, function);
}
return IterableIterate.injectInto(injectValue, list, function);
}
/**
* @see Iterate#injectInto(double, Iterable, DoubleObjectToDoubleFunction)
*/
public static double injectInto(double injectValue, List list, DoubleObjectToDoubleFunction function)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.injectInto(injectValue, list, function);
}
return IterableIterate.injectInto(injectValue, list, function);
}
/**
* @see Iterate#injectInto(float, Iterable, FloatObjectToFloatFunction)
*/
public static float injectInto(float injectValue, List list, FloatObjectToFloatFunction function)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.injectInto(injectValue, list, function);
}
return IterableIterate.injectInto(injectValue, list, function);
}
public static long sumOfInt(List list, IntFunction function)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.sumOfInt(list, function);
}
return IterableIterate.sumOfInt(list, function);
}
public static long sumOfLong(List list, LongFunction function)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.sumOfLong(list, function);
}
return IterableIterate.sumOfLong(list, function);
}
public static double sumOfFloat(List list, FloatFunction function)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.sumOfFloat(list, function);
}
return IterableIterate.sumOfFloat(list, function);
}
public static double sumOfDouble(List list, DoubleFunction function)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.sumOfDouble(list, function);
}
return IterableIterate.sumOfDouble(list, function);
}
/**
* @see Iterate#anySatisfy(Iterable, Predicate)
*/
public static boolean anySatisfy(List list, Predicate predicate)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.anySatisfy(list, predicate);
}
return IterableIterate.anySatisfy(list, predicate);
}
/**
* @see Iterate#anySatisfyWith(Iterable, Predicate2, Object)
*/
public static boolean anySatisfyWith(List list, Predicate2 predicate, IV injectedValue)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.anySatisfyWith(list, predicate, injectedValue);
}
return IterableIterate.anySatisfyWith(list, predicate, injectedValue);
}
/**
* @see Iterate#allSatisfy(Iterable, Predicate)
*/
public static boolean allSatisfy(List list, Predicate predicate)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.allSatisfy(list, predicate);
}
return IterableIterate.allSatisfy(list, predicate);
}
/**
* @see Iterate#allSatisfyWith(Iterable, Predicate2, Object)
*/
public static boolean allSatisfyWith(List list, Predicate2 predicate, IV injectedValue)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.allSatisfyWith(list, predicate, injectedValue);
}
return IterableIterate.allSatisfyWith(list, predicate, injectedValue);
}
/**
* @see Iterate#noneSatisfy(Iterable, Predicate)
*/
public static boolean noneSatisfy(List list, Predicate predicate)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.noneSatisfy(list, predicate);
}
return IterableIterate.noneSatisfy(list, predicate);
}
/**
* @see Iterate#noneSatisfyWith(Iterable, Predicate2, Object)
*/
public static boolean noneSatisfyWith(List list, Predicate2 predicate, P injectedValue)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.noneSatisfyWith(list, predicate, injectedValue);
}
return IterableIterate.noneSatisfyWith(list, predicate, injectedValue);
}
/**
* @see Iterate#selectAndRejectWith(Iterable, Predicate2, Object)
*/
public static Twin> selectAndRejectWith(
List list,
Predicate2 predicate,
IV injectedValue)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.selectAndRejectWith(list, predicate, injectedValue);
}
return IterableIterate.selectAndRejectWith(list, predicate, injectedValue);
}
/**
* @see Iterate#partition(Iterable, Predicate)
*/
public static PartitionMutableList partition(List list, Predicate predicate)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.partition(list, predicate);
}
return IterableIterate.partition(list, predicate);
}
public static PartitionMutableList partitionWith(List list, Predicate2 predicate, P parameter)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.partitionWith(list, predicate, parameter);
}
return IterableIterate.partitionWith(list, predicate, parameter);
}
/**
* @see Iterate#removeIf(Iterable, Predicate)
*/
public static List removeIf(List list, Predicate predicate)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.removeIf(list, predicate);
}
return (List) IterableIterate.removeIf(list, predicate);
}
/**
* @see Iterate#removeIfWith(Iterable, Predicate2, Object)
*/
public static List removeIfWith(List list, Predicate2 predicate, P parameter)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.removeIfWith(list, predicate, parameter);
}
return (List) IterableIterate.removeIfWith(list, predicate, parameter);
}
public static List removeIf(List list, Predicate predicate, Procedure procedure)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.removeIf(list, predicate, procedure);
}
return (List) IterableIterate.removeIf(list, predicate, procedure);
}
/**
* Searches for the first index where the predicate evaluates to true.
*/
public static int detectIndex(List list, Predicate predicate)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.detectIndex(list, predicate);
}
return IterableIterate.detectIndex(list, predicate);
}
/**
* Searches for the first index where the predicate2 and parameter evaluates to true.
*/
public static int detectIndexWith(List list, Predicate2 predicate, P parameter)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.detectIndexWith(list, predicate, parameter);
}
return IterableIterate.detectIndexWith(list, predicate, parameter);
}
public static IV injectIntoWith(IV injectedValue, List list, Function3 function, P parameter)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.injectIntoWith(injectedValue, list, function, parameter);
}
return IterableIterate.injectIntoWith(injectedValue, list, function, parameter);
}
/**
* @see Iterate#forEachWith(Iterable, Procedure2, Object)
*/
public static void forEachWith(List list, Procedure2 procedure, P parameter)
{
if (list instanceof RandomAccess)
{
RandomAccessListIterate.forEachWith(list, procedure, parameter);
}
else
{
IterableIterate.forEachWith(list, procedure, parameter);
}
}
/**
* @see Iterate#collectWith(Iterable, Function2, Object)
*/
public static MutableList collectWith(
List list,
Function2 function,
P parameter)
{
return ListIterate.collectWith(list, function, parameter, FastList.newList(list.size()));
}
/**
* @see Iterate#collectWith(Iterable, Function2, Object, Collection)
*/
public static > R collectWith(
List list,
Function2 function,
P parameter,
R targetCollection)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.collectWith(list, function, parameter, targetCollection);
}
return IterableIterate.collectWith(list, function, parameter, targetCollection);
}
public static > R distinct(List list, R targetCollection)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.distinct(list, targetCollection);
}
return IterableIterate.distinct(list, targetCollection);
}
/**
* Reverses the order of the items in the list.
*
* List integers = Lists.fixedSize.of(1, 3, 2);
* Verify.assertListsEqual(FastList.newListWith(2, 3, 1), ListIterate.reverse(integers));
*
*
* @return the reversed list
*/
public static List reverseThis(List list)
{
Collections.reverse(list);
return list;
}
/**
* @see Iterate#take(Iterable, int)
*/
public static MutableList take(List list, int count)
{
if (count < 0)
{
throw new IllegalArgumentException("Count must be greater than zero, but was: " + count);
}
return ListIterate.take(list, count, FastList.newList(count));
}
/**
* @see Iterate#take(Iterable, int)
*/
public static > R take(List list, int count, R targetList)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.take(list, count, targetList);
}
return IterableIterate.take(list, count, targetList);
}
/**
* @see Iterate#drop(Iterable, int)
*/
public static MutableList drop(List list, int count)
{
if (count < 0)
{
throw new IllegalArgumentException("Count must be greater than zero, but was: " + count);
}
return ListIterate.drop(list, count, FastList.newList(list.size() - Math.min(list.size(), count)));
}
/**
* @see Iterate#drop(Iterable, int)
*/
public static > R drop(List list, int count, R targetList)
{
if (count < 0)
{
throw new IllegalArgumentException("Count must be greater than zero, but was: " + count);
}
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.drop(list, count, targetList);
}
return IterableIterate.drop(list, count, targetList);
}
/**
* @see RichIterable#appendString(Appendable, String, String, String)
*/
public static void appendString(
List list,
Appendable appendable,
String start,
String separator,
String end)
{
if (list instanceof RandomAccess)
{
RandomAccessListIterate.appendString(list, appendable, start, separator, end);
}
else
{
IterableIterate.appendString(list, appendable, start, separator, end);
}
}
/**
* @see Iterate#groupBy(Iterable, Function)
*/
public static FastListMultimap groupBy(
List list,
Function function)
{
return ListIterate.groupBy(list, function, FastListMultimap.newMultimap());
}
/**
* @see Iterate#groupBy(Iterable, Function, MutableMultimap)
*/
public static > R groupBy(
List list,
Function function,
R target)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.groupBy(list, function, target);
}
return IterableIterate.groupBy(list, function, target);
}
/**
* @see Iterate#groupByEach(Iterable, Function)
*/
public static FastListMultimap groupByEach(
List list,
Function> function)
{
return ListIterate.groupByEach(list, function, FastListMultimap.newMultimap());
}
/**
* @see Iterate#groupByEach(Iterable, Function, MutableMultimap)
*/
public static > R groupByEach(
List list,
Function> function,
R target)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.groupByEach(list, function, target);
}
return IterableIterate.groupByEach(list, function, target);
}
/**
* @see Iterate#min(Iterable, Comparator)
*/
public static T min(List list, Comparator comparator)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.min(list, comparator);
}
return IterableIterate.min(list, comparator);
}
public static > T minBy(List list, Function function)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.minBy(list, function);
}
return IterableIterate.minBy(list, function);
}
public static > T maxBy(List list, Function function)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.maxBy(list, function);
}
return IterableIterate.maxBy(list, function);
}
/**
* @see Iterate#max(Iterable, Comparator)
*/
public static T max(List list, Comparator comparator)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.max(list, comparator);
}
return IterableIterate.max(list, comparator);
}
/**
* @see Iterate#min(Iterable)
*/
public static T min(List list)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.min(list);
}
return IterableIterate.min(list);
}
/**
* @see Iterate#max(Iterable)
*/
public static T max(List list)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.max(list);
}
return IterableIterate.max(list);
}
/**
* @see Iterate#chunk(Iterable, int)
*/
public static RichIterable> chunk(List list, int size)
{
if (size <= 0)
{
throw new IllegalArgumentException("Size for groups must be positive but was: " + size);
}
Iterator iterator = list.iterator();
MutableList> result = Lists.mutable.of();
while (iterator.hasNext())
{
MutableCollection batch = Lists.mutable.of();
for (int i = 0; i < size && iterator.hasNext(); i++)
{
batch.add(iterator.next());
}
result.add(batch);
}
return result;
}
/**
* @see Iterate#zip(Iterable, Iterable)
*/
public static MutableList> zip(
List list,
Iterable iterable)
{
return ListIterate.zip(list, iterable, FastList.>newList());
}
/**
* @see Iterate#zip(Iterable, Iterable, Collection)
*/
public static >> R zip(
List list,
Iterable iterable,
R target)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.zip(list, iterable, target);
}
return IterableIterate.zip(list, iterable, target);
}
/**
* @see Iterate#zipWithIndex(Iterable)
*/
public static MutableList> zipWithIndex(List list)
{
return ListIterate.zipWithIndex(list, FastList.>newList(list.size()));
}
/**
* @see Iterate#zipWithIndex(Iterable, Collection)
*/
public static >> R zipWithIndex(
List list,
R target)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.zipWithIndex(list, target);
}
return IterableIterate.zipWithIndex(list, target);
}
/**
* @see ListIterable#takeWhile(Predicate)
*/
public static MutableList takeWhile(List list, Predicate predicate)
{
if (list instanceof RandomAccess)
{
return RandomAccessListIterate.takeWhile(list, predicate);
}
MutableList result = FastList.newList();
for (T t : list)
{
if (predicate.accept(t))
{
result.add(t);
}
else
{
return result;
}
}
return result;
}
/**
* @see ListIterable#dropWhile(Predicate)
*/
public static