Class IntArrayList

java.lang.Object

org.eclipse.collections.impl.primitive.AbstractIntIterable

org.eclipse.collections.impl.list.mutable.primitive.IntArrayList

All Implemented Interfaces:

Externalizable, Serializable, MutableIntCollection, IntIterable, IntList, MutableIntList, OrderedIntIterable, ReversibleIntIterable, PrimitiveIterable

public class IntArrayList
extends AbstractIntIterable
implements MutableIntList, Externalizable

IntArrayList is similar to FastList, and is memory-optimized for int primitives. This file was automatically generated from template file primitiveArrayList.stg.

Since:

3.0.

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private class	IntArrayList.InternalIntIterator

Field Summary

Fields

Modifier and Type	Field	Description
private static final int[]	DEFAULT_SIZED_EMPTY_ARRAY
protected int[]	items
private static final int	MAXIMUM_ARRAY_SIZE
private static final long	serialVersionUID
protected int	size
private static final int[]	ZERO_SIZED_ARRAY

Constructor Summary

Constructors

Constructor	Description
IntArrayList()
IntArrayList(int initialCapacity)
IntArrayList(int... array)

Method Summary

Modifier and Type	Method	Description
boolean	add(int newItem)
boolean	addAll(int... source)
boolean	addAll(IntIterable source)
boolean	addAllAtIndex(int index, int... source)
boolean	addAllAtIndex(int index, IntIterable source)
void	addAtIndex(int index, int element)
private void	addAtIndexLessThanSize(int index, int element)
boolean	allSatisfy(IntPredicate predicate)	Returns true if all of the elements in the IntIterable return true for the specified predicate, otherwise returns false.
boolean	anySatisfy(IntPredicate predicate)	Returns true if any of the elements in the IntIterable return true for the specified predicate, otherwise returns false.
void	appendString(Appendable appendable, String start, String separator, String end)	Prints a string representation of this collection onto the given Appendable.
LazyIntIterable	asReversed()
MutableIntList	asSynchronized()
MutableIntList	asUnmodifiable()
int	binarySearch(int value)
MutableList<Integer>	boxed()
private void	checkEmpty()
RichIterable<IntIterable>	chunk(int size)	Partitions elements in fixed size chunks.
void	clear()
<V> MutableList<V>	collect(IntToObjectFunction<? extends V> function)	Returns a new collection with the results of applying the specified function on each element of the source collection.
<V, R extends Collection<V>> R	collect(IntToObjectFunction<? extends V> function, R target)	Same as IntIterable.collect(IntToObjectFunction) , only the results are added to the target Collection.
boolean	contains(int value)	Returns true if the value is contained in the IntIterable, and false if it is not.
private void	copyItems(int sourceSize, int[] source)
private int[]	copyItemsWithNewCapacity(int newCapacity)
int	count(IntPredicate predicate)	Returns a count of the number of elements in the IntIterable that return true for the specified predicate.
int	detectIfNone(IntPredicate predicate, int ifNone)
MutableIntList	distinct()
long	dotProduct(IntList list)
void	each(IntProcedure procedure)	A synonym for forEach.
void	ensureCapacity(int minCapacity)
private void	ensureCapacityForAdd()
boolean	equals(Object otherList)	Follows the same general contract as List.equals(Object).
void	forEachWithIndex(IntIntProcedure procedure)
int	get(int index)
int	getFirst()
int	getLast()
int	hashCode()	Follows the same general contract as List.hashCode().
int	indexOf(int value)
<T> T	injectInto(T injectedValue, ObjectIntToObjectFunction<? super T, ? extends T> function)
<T> T	injectIntoWithIndex(T injectedValue, ObjectIntIntToObjectFunction<? super T, ? extends T> function)
MutableIntIterator	intIterator()	Returns a primitive iterator that can be used to iterate over the IntIterable in an imperative style.
int	lastIndexOf(int value)
int	max()
int	min()
IntArrayList	newEmpty()	Creates a new empty IntArrayList.
private IndexOutOfBoundsException	newIndexOutOfBoundsException(int index)
static IntArrayList	newList(IntIterable source)
static IntArrayList	newListWith(int... elements)	Creates a new list using the passed elements argument as the backing store.
static IntArrayList	newWithNValues(int size, int value)
void	readExternal(ObjectInput in)
IntArrayList	reject(IntPredicate predicate)	Returns a new IntIterable with all of the elements in the IntIterable that return false for the specified predicate.
<R extends MutableIntCollection> R	reject(IntPredicate predicate, R target)	Same as IntIterable.reject(IntPredicate) , only the results are added to the target MutableIntCollection.
boolean	remove(int value)
boolean	removeAll(int... source)
boolean	removeAll(IntIterable source)
int	removeAtIndex(int index)
boolean	removeIf(IntPredicate predicate)
boolean	retainAll(int... source)
boolean	retainAll(IntIterable source)
IntArrayList	reverseThis()
IntArrayList	select(IntPredicate predicate)	Returns a new IntIterable with all of the elements in the IntIterable that return true for the specified predicate.
<R extends MutableIntCollection> R	select(IntPredicate predicate, R target)	Same as IntIterable.select(IntPredicate) , only the results are added to the target MutableIntCollection.
int	set(int index, int element)
private void	shiftElementsAtIndex(int index, int sourceSize)
int	size()	Returns the number of items in this iterable.
private int	sizePlusFiftyPercent(int oldSize)
IntArrayList	sortThis()	Sorts this list mutating its contents and returns the same mutable list (this).
IntArrayList	sortThis(IntComparator comparator)	Sorts the internal data structure of this list and returns the list itself as a convenience.
Spliterator.OfInt	spliterator()
MutableIntList	subList(int fromIndex, int toIndex)
long	sum()
void	swap(int index1, int index2)
private void	throwOutOfBounds(int index)
int[]	toArray()	Converts the IntIterable to a primitive int array.
int[]	toArray(int[] target)	Converts the IntIterable to a primitive int array.
ImmutableIntList	toImmutable()	Returns an immutable copy of this list.
IntArrayList	toReversed()
MutableIntStack	toStack()	Converts the collection to a IntStack.
private void	transferItemsToNewArrayWithCapacity(int newCapacity)
void	trimToSize()
private void	wipeAndResetTheEnd(int newCurrentFilledIndex)
IntArrayList	with(int element)
IntArrayList	with(int element1, int element2)
IntArrayList	with(int element1, int element2, int element3)
IntArrayList	with(int element1, int element2, int element3, int... elements)
IntArrayList	withAll(IntIterable elements)
private IntArrayList	withArrayCopy(int[] elements, int begin, int length)
IntArrayList	without(int element)
IntArrayList	withoutAll(IntIterable elements)
static IntArrayList	wrapCopy(int... array)	Creates a new list by first copying the array passed in.
void	writeExternal(ObjectOutput out)
<T> MutableList<IntObjectPair<T>>	zip(Iterable<T> iterable)	Returns a MutableList formed from this MutableIntList and a ListIterable by combining corresponding elements in pairs.
MutableList<IntIntPair>	zipInt(IntIterable iterable)	Returns a MutableList formed from this MutableIntList and another IntList by combining corresponding elements in pairs.

Methods inherited from class AbstractIntIterable

asLazy, average, maxIfEmpty, median, minIfEmpty, toBag, toList, toSet, toSortedArray, toSortedList, toString

Methods inherited from class Object

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

Methods inherited from interface IntIterable

asLazy, average, averageIfEmpty, collectBoolean, collectByte, collectChar, collectDouble, collectFloat, collectInt, collectLong, collectShort, containsAll, containsAll, containsAny, containsAny, containsNone, containsNone, flatCollect, forEach, injectIntoBoolean, injectIntoByte, injectIntoChar, injectIntoDouble, injectIntoFloat, injectIntoInt, injectIntoLong, injectIntoShort, maxIfEmpty, median, medianIfEmpty, minIfEmpty, noneSatisfy, reduce, reduceIfEmpty, summaryStatistics, toBag, toList, toSet, toSortedArray, toSortedList, toSortedList, toSortedListBy, toSortedListBy

Methods inherited from interface IntList

forEachInBoth, primitiveParallelStream, primitiveStream

Methods inherited from interface MutableIntList

collectWithIndex, rejectWithIndex, selectWithIndex, shuffleThis, shuffleThis, sortThisBy, sortThisBy, tap

Methods inherited from interface OrderedIntIterable

collectWithIndex, rejectWithIndex, selectWithIndex

Methods inherited from interface PrimitiveIterable

appendString, appendString, isEmpty, makeString, makeString, makeString, notEmpty, toString

Field Details

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

DEFAULT_SIZED_EMPTY_ARRAY

private static final int[] DEFAULT_SIZED_EMPTY_ARRAY

ZERO_SIZED_ARRAY

private static final int[] ZERO_SIZED_ARRAY

MAXIMUM_ARRAY_SIZE

private static final int MAXIMUM_ARRAY_SIZE

See Also:

• Constant Field Values

size

protected int size

items

protected transient int[] items

Constructor Details

IntArrayList

public IntArrayList()

IntArrayList

public IntArrayList(int initialCapacity)

IntArrayList

public IntArrayList(int... array)

Method Details

newListWith

public static IntArrayList newListWith(int... elements)

Creates a new list using the passed elements argument as the backing store.

!!! WARNING: This method uses the passed in array, so can be very unsafe if the original array is held onto anywhere else. !!!

newList

public static IntArrayList newList(IntIterable source)

newWithNValues

public static IntArrayList newWithNValues(int size,
 int value)

wrapCopy

public static IntArrayList wrapCopy(int... array)

Creates a new list by first copying the array passed in.

size

public int size()

Description copied from interface: PrimitiveIterable

Returns the number of items in this iterable.

Specified by:

size in interface PrimitiveIterable

clear

public void clear()

Specified by:

clear in interface MutableIntCollection

contains

public boolean contains(int value)

Description copied from interface: IntIterable

Returns true if the value is contained in the IntIterable, and false if it is not.

Specified by:

contains in interface IntIterable

get

public int get(int index)

Specified by:

get in interface IntList

newIndexOutOfBoundsException

private IndexOutOfBoundsException newIndexOutOfBoundsException(int index)

getFirst

public int getFirst()

Specified by:

getFirst in interface OrderedIntIterable

getLast

public int getLast()

Specified by:

getLast in interface ReversibleIntIterable

checkEmpty

private void checkEmpty()

indexOf

public int indexOf(int value)

Specified by:

indexOf in interface OrderedIntIterable

lastIndexOf

public int lastIndexOf(int value)

Specified by:

lastIndexOf in interface IntList

trimToSize

public void trimToSize()

transferItemsToNewArrayWithCapacity

private void transferItemsToNewArrayWithCapacity(int newCapacity)

copyItemsWithNewCapacity

private int[] copyItemsWithNewCapacity(int newCapacity)

sizePlusFiftyPercent

private int sizePlusFiftyPercent(int oldSize)

ensureCapacity

public void ensureCapacity(int minCapacity)

ensureCapacityForAdd

private void ensureCapacityForAdd()

add

public boolean add(int newItem)

Specified by:

add in interface MutableIntCollection

addAll

public boolean addAll(int... source)

Specified by:

addAll in interface MutableIntCollection

addAll

public boolean addAll(IntIterable source)

Specified by:

addAll in interface MutableIntCollection

copyItems

private void copyItems(int sourceSize,
 int[] source)

throwOutOfBounds

private void throwOutOfBounds(int index)

addAtIndex

public void addAtIndex(int index,
 int element)

Specified by:

addAtIndex in interface MutableIntList

addAtIndexLessThanSize

private void addAtIndexLessThanSize(int index,
 int element)

addAllAtIndex

public boolean addAllAtIndex(int index,
 int... source)

Specified by:

addAllAtIndex in interface MutableIntList

addAllAtIndex

public boolean addAllAtIndex(int index,
 IntIterable source)

Specified by:

addAllAtIndex in interface MutableIntList

shiftElementsAtIndex

private void shiftElementsAtIndex(int index,
 int sourceSize)

remove

public boolean remove(int value)

Specified by:

remove in interface MutableIntCollection

removeIf

public boolean removeIf(IntPredicate predicate)

Specified by:

removeIf in interface MutableIntCollection

wipeAndResetTheEnd

private void wipeAndResetTheEnd(int newCurrentFilledIndex)

removeAll

public boolean removeAll(IntIterable source)

Specified by:

removeAll in interface MutableIntCollection

removeAll

public boolean removeAll(int... source)

Specified by:

removeAll in interface MutableIntCollection

retainAll

public boolean retainAll(IntIterable source)

Specified by:

retainAll in interface MutableIntCollection

See Also:

• Collection.retainAll(Collection)

retainAll

public boolean retainAll(int... source)

Specified by:

retainAll in interface MutableIntCollection

See Also:

• Collection.retainAll(Collection)

removeAtIndex

public int removeAtIndex(int index)

Specified by:

removeAtIndex in interface MutableIntList

set

public int set(int index,
 int element)

Specified by:

set in interface MutableIntList

swap

public void swap(int index1,
 int index2)

Specified by:

swap in interface MutableIntList

with

public IntArrayList with(int element)

Specified by:

with in interface MutableIntCollection

Specified by:

with in interface MutableIntList

without

public IntArrayList without(int element)

Specified by:

without in interface MutableIntCollection

Specified by:

without in interface MutableIntList

withAll

public IntArrayList withAll(IntIterable elements)

Specified by:

withAll in interface MutableIntCollection

Specified by:

withAll in interface MutableIntList

withoutAll

public IntArrayList withoutAll(IntIterable elements)

Specified by:

withoutAll in interface MutableIntCollection

Specified by:

withoutAll in interface MutableIntList

with

public IntArrayList with(int element1,
 int element2)

with

public IntArrayList with(int element1,
 int element2,
 int element3)

with

public IntArrayList with(int element1,
 int element2,
 int element3,
 int... elements)

withArrayCopy

private IntArrayList withArrayCopy(int[] elements,
 int begin,
 int length)

intIterator

public MutableIntIterator intIterator()

Description copied from interface: IntIterable

Returns a primitive iterator that can be used to iterate over the IntIterable in an imperative style.

Specified by:

intIterator in interface IntIterable

Specified by:

intIterator in interface MutableIntCollection

each

public void each(IntProcedure procedure)

Description copied from interface: IntIterable

A synonym for forEach.

Specified by:

each in interface IntIterable

Since:

7.0.

forEachWithIndex

public void forEachWithIndex(IntIntProcedure procedure)

Specified by:

forEachWithIndex in interface OrderedIntIterable

injectInto

public <T> T injectInto(T injectedValue,
 ObjectIntToObjectFunction<? super T, ? extends T> function)

Specified by:

injectInto in interface IntIterable

injectIntoWithIndex

public <T> T injectIntoWithIndex(T injectedValue,
 ObjectIntIntToObjectFunction<? super T, ? extends T> function)

Specified by:

injectIntoWithIndex in interface OrderedIntIterable

Specified by:

injectIntoWithIndex in interface ReversibleIntIterable

chunk

public RichIterable<IntIterable> chunk(int size)

Description copied from interface: IntIterable

Partitions elements in fixed size chunks.

Specified by:

chunk in interface IntIterable

Parameters:

size - the number of elements per chunk

Returns:

A RichIterable containing IntIterables of size size, except the last will be truncated if the elements don't divide evenly.

count

public int count(IntPredicate predicate)

Description copied from interface: IntIterable

Returns a count of the number of elements in the IntIterable that return true for the specified predicate.

Specified by:

count in interface IntIterable

anySatisfy

public boolean anySatisfy(IntPredicate predicate)

Description copied from interface: IntIterable

Returns true if any of the elements in the IntIterable return true for the specified predicate, otherwise returns false.

Specified by:

anySatisfy in interface IntIterable

allSatisfy

public boolean allSatisfy(IntPredicate predicate)

Description copied from interface: IntIterable

Returns true if all of the elements in the IntIterable return true for the specified predicate, otherwise returns false.

Specified by:

allSatisfy in interface IntIterable

select

public IntArrayList select(IntPredicate predicate)

Description copied from interface: IntIterable

Returns a new IntIterable with all of the elements in the IntIterable that return true for the specified predicate.

Specified by:

select in interface IntIterable

Specified by:

select in interface IntList

Specified by:

select in interface MutableIntCollection

Specified by:

select in interface MutableIntList

Specified by:

select in interface OrderedIntIterable

Specified by:

select in interface ReversibleIntIterable

select

public <R extends MutableIntCollection> R select(IntPredicate predicate,
 R target)

Description copied from interface: IntIterable

Same as IntIterable.select(IntPredicate) , only the results are added to the target MutableIntCollection.

Specified by:

select in interface IntIterable

Since:

8.1.

reject

public IntArrayList reject(IntPredicate predicate)

Description copied from interface: IntIterable

Returns a new IntIterable with all of the elements in the IntIterable that return false for the specified predicate.

Specified by:

reject in interface IntIterable

Specified by:

reject in interface IntList

Specified by:

reject in interface MutableIntCollection

Specified by:

reject in interface MutableIntList

Specified by:

reject in interface OrderedIntIterable

Specified by:

reject in interface ReversibleIntIterable

reject

public <R extends MutableIntCollection> R reject(IntPredicate predicate,
 R target)

Description copied from interface: IntIterable

Same as IntIterable.reject(IntPredicate) , only the results are added to the target MutableIntCollection.

Specified by:

reject in interface IntIterable

Since:

8.1.

detectIfNone

public int detectIfNone(IntPredicate predicate,
 int ifNone)

Specified by:

detectIfNone in interface IntIterable

collect

public <V> MutableList<V> collect(IntToObjectFunction<? extends V> function)

Description copied from interface: IntIterable

Returns a new collection with the results of applying the specified function on each element of the source collection. This method is also commonly called transform or map.

Specified by:

collect in interface IntIterable

Specified by:

collect in interface IntList

Specified by:

collect in interface MutableIntCollection

Specified by:

collect in interface MutableIntList

Specified by:

collect in interface OrderedIntIterable

Specified by:

collect in interface ReversibleIntIterable

collect

public <V, R extends Collection<V>> R collect(IntToObjectFunction<? extends V> function,
 R target)

Description copied from interface: IntIterable

Same as IntIterable.collect(IntToObjectFunction) , only the results are added to the target Collection.

Specified by:

collect in interface IntIterable

Since:

8.1.

max

public int max()

Specified by:

max in interface IntIterable

min

public int min()

Specified by:

min in interface IntIterable

sum

public long sum()

Specified by:

sum in interface IntIterable

dotProduct

public long dotProduct(IntList list)

Specified by:

dotProduct in interface IntList

toArray

public int[] toArray()

Description copied from interface: IntIterable

Converts the IntIterable to a primitive int array.

Specified by:

toArray in interface IntIterable

toArray

public int[] toArray(int[] target)

Description copied from interface: IntIterable

Converts the IntIterable to a primitive int array. If the collection fits into the provided array it is used to store its elements and is returned from the method, otherwise a new array of the appropriate size is allocated and returned. If the iterable is empty, the target array is returned unchanged.

Specified by:

toArray in interface IntIterable

equals

public boolean equals(Object otherList)

Description copied from interface: IntList

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

Specified by:

equals in interface IntList

Overrides:

equals in class Object

hashCode

public int hashCode()

Description copied from interface: IntList

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

Specified by:

hashCode in interface IntList

Overrides:

hashCode in class Object

appendString

public void appendString(Appendable appendable,
 String start,
 String separator,
 String end)

Description copied from interface: PrimitiveIterable

Prints a string representation of this collection onto the given Appendable. Prints the string returned by PrimitiveIterable.makeString(String, String, String).

Specified by:

appendString in interface PrimitiveIterable

asUnmodifiable

public MutableIntList asUnmodifiable()

Specified by:

asUnmodifiable in interface MutableIntCollection

Specified by:

asUnmodifiable in interface MutableIntList

asSynchronized

public MutableIntList asSynchronized()

Specified by:

asSynchronized in interface MutableIntCollection

Specified by:

asSynchronized in interface MutableIntList

toImmutable

public ImmutableIntList toImmutable()

Description copied from interface: MutableIntList

Returns an immutable copy of this list.

Specified by:

toImmutable in interface IntList

Specified by:

toImmutable in interface MutableIntCollection

Specified by:

toImmutable in interface MutableIntList

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException

Specified by:

readExternal in interface Externalizable

Throws:

IOException

asReversed

public LazyIntIterable asReversed()

Specified by:

asReversed in interface ReversibleIntIterable

reverseThis

public IntArrayList reverseThis()

Specified by:

reverseThis in interface MutableIntList

sortThis

public IntArrayList sortThis()

Description copied from interface: MutableIntList

Sorts this list mutating its contents and returns the same mutable list (this).

Specified by:

sortThis in interface MutableIntList

sortThis

public IntArrayList sortThis(IntComparator comparator)

Description copied from interface: MutableIntList

Sorts the internal data structure of this list and returns the list itself as a convenience.

Specified by:

sortThis in interface MutableIntList

toReversed

public IntArrayList toReversed()

Specified by:

toReversed in interface IntList

Specified by:

toReversed in interface MutableIntList

Specified by:

toReversed in interface ReversibleIntIterable

binarySearch

public int binarySearch(int value)

Specified by:

binarySearch in interface IntList

distinct

public MutableIntList distinct()

Specified by:

distinct in interface IntList

Specified by:

distinct in interface MutableIntList

Specified by:

distinct in interface ReversibleIntIterable

subList

public MutableIntList subList(int fromIndex,
 int toIndex)

Specified by:

subList in interface IntList

Specified by:

subList in interface MutableIntList

See Also:

• List.subList(int fromIndex, int toIndex)

zipInt

public MutableList<IntIntPair> zipInt(IntIterable iterable)

Description copied from interface: MutableIntList

Returns a MutableList formed from this MutableIntList and another IntList by combining corresponding elements in pairs. If one of the two IntLists is longer than the other, its remaining elements are ignored.

Specified by:

zipInt in interface IntList

Specified by:

zipInt in interface MutableIntList

Since:

9.1.

newEmpty

public IntArrayList newEmpty()

Creates a new empty IntArrayList.

Specified by:

newEmpty in interface MutableIntCollection

Specified by:

newEmpty in interface MutableIntList

Since:

9.2.

zip

public <T> MutableList<IntObjectPair<T>> zip(Iterable<T> iterable)

Description copied from interface: MutableIntList

Returns a MutableList formed from this MutableIntList and a ListIterable by combining corresponding elements in pairs. If one of the two Lists is longer than the other, its remaining elements are ignored.

Specified by:

zip in interface IntList

Specified by:

zip in interface MutableIntList

Since:

9.1.

boxed

public MutableList<Integer> boxed()

Specified by:

boxed in interface MutableIntList

toStack

public MutableIntStack toStack()

Description copied from interface: OrderedIntIterable

Converts the collection to a IntStack.

Specified by:

toStack in interface OrderedIntIterable

spliterator

public Spliterator.OfInt spliterator()

Specified by:

spliterator in interface IntList