Class LongArrayList

java.lang.Object

org.eclipse.collections.impl.primitive.AbstractLongIterable

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

All Implemented Interfaces:

Externalizable, Serializable, MutableLongCollection, LongList, MutableLongList, LongIterable, OrderedLongIterable, ReversibleLongIterable, PrimitiveIterable

public class LongArrayList
extends AbstractLongIterable
implements MutableLongList, Externalizable

LongArrayList is similar to FastList, and is memory-optimized for long 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	LongArrayList.InternalLongIterator

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor	Description
LongArrayList()
LongArrayList(int initialCapacity)
LongArrayList(long... array)

Method Summary

Modifier and Type	Method	Description
boolean	add(long newItem)
boolean	addAll(long... source)
boolean	addAll(LongIterable source)
boolean	addAllAtIndex(int index, long... source)
boolean	addAllAtIndex(int index, LongIterable source)
void	addAtIndex(int index, long element)
private void	addAtIndexLessThanSize(int index, long element)
boolean	allSatisfy(LongPredicate predicate)	Returns true if all of the elements in the LongIterable return true for the specified predicate, otherwise returns false.
boolean	anySatisfy(LongPredicate predicate)	Returns true if any of the elements in the LongIterable 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.
LazyLongIterable	asReversed()
MutableLongList	asSynchronized()
MutableLongList	asUnmodifiable()
int	binarySearch(long value)
MutableList<Long>	boxed()
private void	checkEmpty()
RichIterable<LongIterable>	chunk(int size)	Partitions elements in fixed size chunks.
void	clear()
<V> MutableList<V>	collect(LongToObjectFunction<? 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(LongToObjectFunction<? extends V> function, R target)	Same as LongIterable.collect(LongToObjectFunction) , only the results are added to the target Collection.
boolean	contains(long value)	Returns true if the value is contained in the LongIterable, and false if it is not.
private void	copyItems(int sourceSize, long[] source)
private long[]	copyItemsWithNewCapacity(int newCapacity)
int	count(LongPredicate predicate)	Returns a count of the number of elements in the LongIterable that return true for the specified predicate.
long	detectIfNone(LongPredicate predicate, long ifNone)
MutableLongList	distinct()
long	dotProduct(LongList list)
void	each(LongProcedure 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(LongIntProcedure procedure)
long	get(int index)
long	getFirst()
long	getLast()
int	hashCode()	Follows the same general contract as List.hashCode().
int	indexOf(long value)
<T> T	injectInto(T injectedValue, ObjectLongToObjectFunction<? super T, ? extends T> function)
<T> T	injectIntoWithIndex(T injectedValue, ObjectLongIntToObjectFunction<? super T, ? extends T> function)
int	lastIndexOf(long value)
MutableLongIterator	longIterator()	Returns a primitive iterator that can be used to iterate over the LongIterable in an imperative style.
long	max()
long	min()
LongArrayList	newEmpty()	Creates a new empty LongArrayList.
private IndexOutOfBoundsException	newIndexOutOfBoundsException(int index)
static LongArrayList	newList(LongIterable source)
static LongArrayList	newListWith(long... elements)	Creates a new list using the passed elements argument as the backing store.
static LongArrayList	newWithNValues(int size, long value)
void	readExternal(ObjectInput in)
LongArrayList	reject(LongPredicate predicate)	Returns a new LongIterable with all of the elements in the LongIterable that return false for the specified predicate.
<R extends MutableLongCollection> R	reject(LongPredicate predicate, R target)	Same as LongIterable.reject(LongPredicate) , only the results are added to the target MutableLongCollection.
boolean	remove(long value)
boolean	removeAll(long... source)
boolean	removeAll(LongIterable source)
long	removeAtIndex(int index)
boolean	removeIf(LongPredicate predicate)
boolean	retainAll(long... source)
boolean	retainAll(LongIterable source)
LongArrayList	reverseThis()
LongArrayList	select(LongPredicate predicate)	Returns a new LongIterable with all of the elements in the LongIterable that return true for the specified predicate.
<R extends MutableLongCollection> R	select(LongPredicate predicate, R target)	Same as LongIterable.select(LongPredicate) , only the results are added to the target MutableLongCollection.
long	set(int index, long element)
private void	shiftElementsAtIndex(int index, int sourceSize)
int	size()	Returns the number of items in this iterable.
private int	sizePlusFiftyPercent(int oldSize)
LongArrayList	sortThis()	Sorts this list mutating its contents and returns the same mutable list (this).
LongArrayList	sortThis(LongComparator comparator)	Sorts the internal data structure of this list and returns the list itself as a convenience.
Spliterator.OfLong	spliterator()
MutableLongList	subList(int fromIndex, int toIndex)
long	sum()
void	swap(int index1, int index2)
private void	throwOutOfBounds(int index)
long[]	toArray()	Converts the LongIterable to a primitive long array.
long[]	toArray(long[] target)	Converts the LongIterable to a primitive long array.
ImmutableLongList	toImmutable()	Returns an immutable copy of this list.
LongArrayList	toReversed()
MutableLongStack	toStack()	Converts the collection to a LongStack.
private void	transferItemsToNewArrayWithCapacity(int newCapacity)
void	trimToSize()
private void	wipeAndResetTheEnd(int newCurrentFilledIndex)
LongArrayList	with(long element)
LongArrayList	with(long element1, long element2)
LongArrayList	with(long element1, long element2, long element3)
LongArrayList	with(long element1, long element2, long element3, long... elements)
LongArrayList	withAll(LongIterable elements)
private LongArrayList	withArrayCopy(long[] elements, int begin, int length)
LongArrayList	without(long element)
LongArrayList	withoutAll(LongIterable elements)
static LongArrayList	wrapCopy(long... array)	Creates a new list by first copying the array passed in.
void	writeExternal(ObjectOutput out)
<T> MutableList<LongObjectPair<T>>	zip(Iterable<T> iterable)	Returns a MutableList formed from this MutableLongList and a ListIterable by combining corresponding elements in pairs.
MutableList<LongLongPair>	zipLong(LongIterable iterable)	Returns a MutableList formed from this MutableLongList and another LongList by combining corresponding elements in pairs.

Methods inherited from class AbstractLongIterable

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 LongIterable

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 LongList

forEachInBoth, primitiveParallelStream, primitiveStream

Methods inherited from interface MutableLongList

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

Methods inherited from interface OrderedLongIterable

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 long[] DEFAULT_SIZED_EMPTY_ARRAY

ZERO_SIZED_ARRAY

private static final long[] 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 long[] items

Constructor Details

LongArrayList

public LongArrayList()

LongArrayList

public LongArrayList(int initialCapacity)

LongArrayList

public LongArrayList(long... array)

Method Details

newListWith

public static LongArrayList newListWith(long... 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 LongArrayList newList(LongIterable source)

newWithNValues

public static LongArrayList newWithNValues(int size,
 long value)

wrapCopy

public static LongArrayList wrapCopy(long... 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 MutableLongCollection

contains

public boolean contains(long value)

Description copied from interface: LongIterable

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

Specified by:

contains in interface LongIterable

get

public long get(int index)

Specified by:

get in interface LongList

newIndexOutOfBoundsException

private IndexOutOfBoundsException newIndexOutOfBoundsException(int index)

getFirst

public long getFirst()

Specified by:

getFirst in interface OrderedLongIterable

getLast

public long getLast()

Specified by:

getLast in interface ReversibleLongIterable

checkEmpty

private void checkEmpty()

indexOf

public int indexOf(long value)

Specified by:

indexOf in interface OrderedLongIterable

lastIndexOf

public int lastIndexOf(long value)

Specified by:

lastIndexOf in interface LongList

trimToSize

public void trimToSize()

transferItemsToNewArrayWithCapacity

private void transferItemsToNewArrayWithCapacity(int newCapacity)

copyItemsWithNewCapacity

private long[] copyItemsWithNewCapacity(int newCapacity)

sizePlusFiftyPercent

private int sizePlusFiftyPercent(int oldSize)

ensureCapacity

public void ensureCapacity(int minCapacity)

ensureCapacityForAdd

private void ensureCapacityForAdd()

add

public boolean add(long newItem)

Specified by:

add in interface MutableLongCollection

addAll

public boolean addAll(long... source)

Specified by:

addAll in interface MutableLongCollection

addAll

public boolean addAll(LongIterable source)

Specified by:

addAll in interface MutableLongCollection

copyItems

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

throwOutOfBounds

private void throwOutOfBounds(int index)

addAtIndex

public void addAtIndex(int index,
 long element)

Specified by:

addAtIndex in interface MutableLongList

addAtIndexLessThanSize

private void addAtIndexLessThanSize(int index,
 long element)

addAllAtIndex

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

Specified by:

addAllAtIndex in interface MutableLongList

addAllAtIndex

public boolean addAllAtIndex(int index,
 LongIterable source)

Specified by:

addAllAtIndex in interface MutableLongList

shiftElementsAtIndex

private void shiftElementsAtIndex(int index,
 int sourceSize)

remove

public boolean remove(long value)

Specified by:

remove in interface MutableLongCollection

removeIf

public boolean removeIf(LongPredicate predicate)

Specified by:

removeIf in interface MutableLongCollection

wipeAndResetTheEnd

private void wipeAndResetTheEnd(int newCurrentFilledIndex)

removeAll

public boolean removeAll(LongIterable source)

Specified by:

removeAll in interface MutableLongCollection

removeAll

public boolean removeAll(long... source)

Specified by:

removeAll in interface MutableLongCollection

retainAll

public boolean retainAll(LongIterable source)

Specified by:

retainAll in interface MutableLongCollection

See Also:

• Collection.retainAll(Collection)

retainAll

public boolean retainAll(long... source)

Specified by:

retainAll in interface MutableLongCollection

See Also:

• Collection.retainAll(Collection)

removeAtIndex

public long removeAtIndex(int index)

Specified by:

removeAtIndex in interface MutableLongList

set

public long set(int index,
 long element)

Specified by:

set in interface MutableLongList

swap

public void swap(int index1,
 int index2)

Specified by:

swap in interface MutableLongList

with

public LongArrayList with(long element)

Specified by:

with in interface MutableLongCollection

Specified by:

with in interface MutableLongList

without

public LongArrayList without(long element)

Specified by:

without in interface MutableLongCollection

Specified by:

without in interface MutableLongList

withAll

public LongArrayList withAll(LongIterable elements)

Specified by:

withAll in interface MutableLongCollection

Specified by:

withAll in interface MutableLongList

withoutAll

public LongArrayList withoutAll(LongIterable elements)

Specified by:

withoutAll in interface MutableLongCollection

Specified by:

withoutAll in interface MutableLongList

with

public LongArrayList with(long element1,
 long element2)

with

public LongArrayList with(long element1,
 long element2,
 long element3)

with

public LongArrayList with(long element1,
 long element2,
 long element3,
 long... elements)

withArrayCopy

private LongArrayList withArrayCopy(long[] elements,
 int begin,
 int length)

longIterator

public MutableLongIterator longIterator()

Description copied from interface: LongIterable

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

Specified by:

longIterator in interface LongIterable

Specified by:

longIterator in interface MutableLongCollection

each

public void each(LongProcedure procedure)

Description copied from interface: LongIterable

A synonym for forEach.

Specified by:

each in interface LongIterable

Since:

7.0.

forEachWithIndex

public void forEachWithIndex(LongIntProcedure procedure)

Specified by:

forEachWithIndex in interface OrderedLongIterable

injectInto

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

Specified by:

injectInto in interface LongIterable

injectIntoWithIndex

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

Specified by:

injectIntoWithIndex in interface OrderedLongIterable

Specified by:

injectIntoWithIndex in interface ReversibleLongIterable

chunk

public RichIterable<LongIterable> chunk(int size)

Description copied from interface: LongIterable

Partitions elements in fixed size chunks.

Specified by:

chunk in interface LongIterable

Parameters:

size - the number of elements per chunk

Returns:

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

count

public int count(LongPredicate predicate)

Description copied from interface: LongIterable

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

Specified by:

count in interface LongIterable

anySatisfy

public boolean anySatisfy(LongPredicate predicate)

Description copied from interface: LongIterable

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

Specified by:

anySatisfy in interface LongIterable

allSatisfy

public boolean allSatisfy(LongPredicate predicate)

Description copied from interface: LongIterable

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

Specified by:

allSatisfy in interface LongIterable

select

public LongArrayList select(LongPredicate predicate)

Description copied from interface: LongIterable

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

Specified by:

select in interface LongIterable

Specified by:

select in interface LongList

Specified by:

select in interface MutableLongCollection

Specified by:

select in interface MutableLongList

Specified by:

select in interface OrderedLongIterable

Specified by:

select in interface ReversibleLongIterable

select

public <R extends MutableLongCollection> R select(LongPredicate predicate,
 R target)

Description copied from interface: LongIterable

Same as LongIterable.select(LongPredicate) , only the results are added to the target MutableLongCollection.

Specified by:

select in interface LongIterable

Since:

8.1.

reject

public LongArrayList reject(LongPredicate predicate)

Description copied from interface: LongIterable

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

Specified by:

reject in interface LongIterable

Specified by:

reject in interface LongList

Specified by:

reject in interface MutableLongCollection

Specified by:

reject in interface MutableLongList

Specified by:

reject in interface OrderedLongIterable

Specified by:

reject in interface ReversibleLongIterable

reject

public <R extends MutableLongCollection> R reject(LongPredicate predicate,
 R target)

Description copied from interface: LongIterable

Same as LongIterable.reject(LongPredicate) , only the results are added to the target MutableLongCollection.

Specified by:

reject in interface LongIterable

Since:

8.1.

detectIfNone

public long detectIfNone(LongPredicate predicate,
 long ifNone)

Specified by:

detectIfNone in interface LongIterable

collect

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

Description copied from interface: LongIterable

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 LongIterable

Specified by:

collect in interface LongList

Specified by:

collect in interface MutableLongCollection

Specified by:

collect in interface MutableLongList

Specified by:

collect in interface OrderedLongIterable

Specified by:

collect in interface ReversibleLongIterable

collect

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

Description copied from interface: LongIterable

Same as LongIterable.collect(LongToObjectFunction) , only the results are added to the target Collection.

Specified by:

collect in interface LongIterable

Since:

8.1.

max

public long max()

Specified by:

max in interface LongIterable

min

public long min()

Specified by:

min in interface LongIterable

sum

public long sum()

Specified by:

sum in interface LongIterable

dotProduct

public long dotProduct(LongList list)

Specified by:

dotProduct in interface LongList

toArray

public long[] toArray()

Description copied from interface: LongIterable

Converts the LongIterable to a primitive long array.

Specified by:

toArray in interface LongIterable

toArray

public long[] toArray(long[] target)

Description copied from interface: LongIterable

Converts the LongIterable to a primitive long 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 LongIterable

equals

public boolean equals(Object otherList)

Description copied from interface: LongList

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

Specified by:

equals in interface LongList

Overrides:

equals in class Object

hashCode

public int hashCode()

Description copied from interface: LongList

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

Specified by:

hashCode in interface LongList

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 MutableLongList asUnmodifiable()

Specified by:

asUnmodifiable in interface MutableLongCollection

Specified by:

asUnmodifiable in interface MutableLongList

asSynchronized

public MutableLongList asSynchronized()

Specified by:

asSynchronized in interface MutableLongCollection

Specified by:

asSynchronized in interface MutableLongList

toImmutable

public ImmutableLongList toImmutable()

Description copied from interface: MutableLongList

Returns an immutable copy of this list.

Specified by:

toImmutable in interface LongList

Specified by:

toImmutable in interface MutableLongCollection

Specified by:

toImmutable in interface MutableLongList

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 LazyLongIterable asReversed()

Specified by:

asReversed in interface ReversibleLongIterable

reverseThis

public LongArrayList reverseThis()

Specified by:

reverseThis in interface MutableLongList

sortThis

public LongArrayList sortThis()

Description copied from interface: MutableLongList

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

Specified by:

sortThis in interface MutableLongList

sortThis

public LongArrayList sortThis(LongComparator comparator)

Description copied from interface: MutableLongList

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

Specified by:

sortThis in interface MutableLongList

toReversed

public LongArrayList toReversed()

Specified by:

toReversed in interface LongList

Specified by:

toReversed in interface MutableLongList

Specified by:

toReversed in interface ReversibleLongIterable

binarySearch

public int binarySearch(long value)

Specified by:

binarySearch in interface LongList

distinct

public MutableLongList distinct()

Specified by:

distinct in interface LongList

Specified by:

distinct in interface MutableLongList

Specified by:

distinct in interface ReversibleLongIterable

subList

public MutableLongList subList(int fromIndex,
 int toIndex)

Specified by:

subList in interface LongList

Specified by:

subList in interface MutableLongList

See Also:

• List.subList(int fromIndex, int toIndex)

zipLong

public MutableList<LongLongPair> zipLong(LongIterable iterable)

Description copied from interface: MutableLongList

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

Specified by:

zipLong in interface LongList

Specified by:

zipLong in interface MutableLongList

Since:

9.1.

newEmpty

public LongArrayList newEmpty()

Creates a new empty LongArrayList.

Specified by:

newEmpty in interface MutableLongCollection

Specified by:

newEmpty in interface MutableLongList

Since:

9.2.

zip

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

Description copied from interface: MutableLongList

Returns a MutableList formed from this MutableLongList 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 LongList

Specified by:

zip in interface MutableLongList

Since:

9.1.

boxed

public MutableList<Long> boxed()

Specified by:

boxed in interface MutableLongList

toStack

public MutableLongStack toStack()

Description copied from interface: OrderedLongIterable

Converts the collection to a LongStack.

Specified by:

toStack in interface OrderedLongIterable

spliterator

public Spliterator.OfLong spliterator()

Specified by:

spliterator in interface LongList