Package org.eclipse.collections.impl.list.primitive

Class LongInterval

java.lang.Object

org.eclipse.collections.impl.list.primitive.LongInterval

All Implemented Interfaces:

Serializable, ImmutableLongCollection, ImmutableLongList, LongList, LongIterable, OrderedLongIterable, ReversibleLongIterable, PrimitiveIterable

public final class LongInterval
extends Object
implements ImmutableLongList, Serializable

An LongInterval is a range of longs that may be iterated over using a step value. Note that the size of the interval (the number of elements in the list it represents) is limited by the maximum value of the integer index.

See Also:

• Serialized Form

Method Summary

Modifier and Type	Method	Description
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)	Prints a string representation of this collection onto the given Appendable.
void	appendString(Appendable appendable, String separator)	Prints a string representation of this collection onto the given Appendable.
void	appendString(Appendable appendable, String start, String separator, String end)	Prints a string representation of this collection onto the given Appendable.
LazyLongIterable	asLazy()	Returns a LazyLongIterable adapter wrapping the source LongIterable.
LazyLongIterable	asReversed()
double	average()
int	binarySearch(long value)
LongInterval	by(long newStep)	This instance by method allows LongInterval to act as a fluent builder for itself.
RichIterable<LongIterable>	chunk(int size)	Partitions elements in fixed size chunks.
<V> ImmutableList<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.
boolean	contains(long value)	Returns true if the LongInterval contains the specified long value.
boolean	containsAll(long... values)	Returns true if the LongInterval contains all of the specified long values.
boolean	containsAll(LongIterable source)	Returns true if all of the values specified in the source LongIterable are contained in the LongIterable, and false if they are not.
boolean	containsNone(int... values)	Returns true if the LongInterval contains none of the specified long values.
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)
ImmutableLongList	distinct()
long	dotProduct(LongList list)
void	each(LongProcedure procedure)	A synonym for forEach.
boolean	equals(Object otherList)	Follows the same general contract as List.equals(Object).
static LongInterval	evensFromTo(long from, long to)	Returns an LongInterval representing the even values from the value from to the value to.
void	forEach(LongProcedure procedure)	Applies the LongProcedure to each element in the LongIterable.
void	forEachWithIndex(LongIntProcedure procedure)
void	forEachWithLongIndex(LongLongProcedure procedure)
static LongInterval	from(long newFrom)	This static from method allows LongInterval to act as a fluent builder for itself.
static LongInterval	fromTo(long from, long to)	Returns an LongInterval starting from the value from to the specified value to with a step value of 1.
static LongInterval	fromToBy(long from, long to, long stepBy)	Returns an LongInterval for the range of integers inclusively between from and to with the specified stepBy value.
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)
boolean	isEmpty()	Returns true if this iterable has zero items.
int	lastIndexOf(long value)
LongIterator	longIterator()	Returns a primitive iterator that can be used to iterate over the LongIterable in an imperative style.
String	makeString()	Returns a string representation of this collection by delegating to PrimitiveIterable.makeString(String) and defaulting the separator parameter to the characters ", " (comma and space).
String	makeString(String separator)	Returns a string representation of this collection by delegating to PrimitiveIterable.makeString(String, String, String) and defaulting the start and end parameters to "" (the empty String).
String	makeString(String start, String separator, String end)	Returns a string representation of this collection with the elements separated by the specified separator and enclosed between the start and end strings.
long	max()
long	maxIfEmpty(long defaultValue)
double	median()
long	min()
long	minIfEmpty(long defaultValue)
ImmutableLongList	newWith(long element)
ImmutableLongList	newWithAll(LongIterable elements)
ImmutableLongList	newWithout(long element)
ImmutableLongList	newWithoutAll(LongIterable elements)
boolean	noneSatisfy(LongPredicate predicate)	Returns true if none of the elements in the LongIterable return true for the specified predicate, otherwise returns false.
boolean	notEmpty()	The English equivalent of !this.isEmpty()
static LongInterval	oddsFromTo(long from, long to)	Returns an LongInterval representing the odd values from the value from to the value to.
static LongInterval	oneTo(long count)	Returns an LongInterval starting from 1 to the specified count value with a step value of 1.
static LongInterval	oneToBy(long count, long step)	Returns an LongInterval starting from 1 to the specified count value with a step value of step.
ImmutableLongList	reject(LongPredicate predicate)	Returns a new LongIterable with all of the elements in the LongIterable that return false for the specified predicate.
ImmutableLongList	select(LongPredicate predicate)	Returns a new LongIterable with all of the elements in the LongIterable that return true for the specified predicate.
int	size()	Returns the size of the interval.
Spliterator.OfLong	spliterator()
ImmutableLongList	subList(int fromIndex, int toIndex)
long	sum()
LongInterval	to(long newTo)	This instance to method allows LongInterval to act as a fluent builder for itself.
long[]	toArray()	Converts the LongIterable to a primitive long array.
long[]	toArray(long[] result)	Converts the LongIterable to a primitive long array.
MutableLongBag	toBag()	Converts the LongIterable to a new MutableLongBag.
ImmutableLongList	toImmutable()	Returns an immutable copy of this list.
MutableLongList	toList()	Converts the LongIterable to a new MutableLongList.
LongInterval	toReversed()	Returns a new LongInterval with the from and to values reversed and the step value negated.
MutableLongSet	toSet()	Converts the LongIterable to a new MutableLongSet.
long[]	toSortedArray()
MutableLongList	toSortedList()
String	toString()	Returns a string with the elements of this iterable separated by commas with spaces and enclosed in square brackets.
static LongInterval	zero()	Returns an LongInterval starting at zero.
static LongInterval	zeroTo(long count)	Returns an LongInterval starting from 0 to the specified count value with a step value of 1.
static LongInterval	zeroToBy(long count, long step)	Returns an LongInterval starting from 0 to the specified count value with a step value of step.
<T> ImmutableList<LongObjectPair<T>>	zip(Iterable<T> iterable)	Returns an ImmutableList formed from this ImmutableLongList and a ListIterable by combining corresponding elements in pairs.
ImmutableList<LongLongPair>	zipLong(LongIterable iterable)	Returns an ImmutableList formed from this ImmutableLongList and another LongList by combining corresponding elements in pairs.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.eclipse.collections.api.list.primitive.ImmutableLongList

collectWithIndex, tap

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

averageIfEmpty, collect, collectBoolean, collectByte, collectChar, collectDouble, collectFloat, collectInt, collectLong, collectShort, containsAny, containsAny, containsNone, containsNone, flatCollect, medianIfEmpty, reduce, reduceIfEmpty, reject, select, summaryStatistics, toSortedList, toSortedListBy, toSortedListBy

Methods inherited from interface org.eclipse.collections.api.list.primitive.LongList

primitiveParallelStream, primitiveStream

Methods inherited from interface org.eclipse.collections.api.ordered.primitive.OrderedLongIterable

collectWithIndex

Method Details

from

public static LongInterval from(long newFrom)

This static from method allows LongInterval to act as a fluent builder for itself. It works in conjunction with the instance methods to(long) and by(long).

Usage Example:

 LongInterval interval1 = LongInterval.from(1).to(5);         // results in: 1, 2, 3, 4, 5.
 LongInterval interval2 = LongInterval.from(1).to(10).by(2);  // results in: 1, 3, 5, 7, 9.
 

to

public LongInterval to(long newTo)

This instance to method allows LongInterval to act as a fluent builder for itself. It works in conjunction with the static method from(long) and instance method by(long).

Usage Example:

 LongInterval interval1 = LongInterval.from(1).to(5);         // results in: 1, 2, 3, 4, 5.
 LongInterval interval2 = LongInterval.from(1).to(10).by(2);  // results in: 1, 3, 5, 7, 9.
 

by

public LongInterval by(long newStep)

This instance by method allows LongInterval to act as a fluent builder for itself. It works in conjunction with the static method from(long) and instance method to(long).

Usage Example:

 LongInterval interval1 = LongInterval.from(1).to(5);         // results in: 1, 2, 3, 4, 5.
 LongInterval interval2 = LongInterval.from(1).to(10).by(2);  // results in: 1, 3, 5, 7, 9.
 

zero

public static LongInterval zero()

Returns an LongInterval starting at zero.

Usage Example:

 LongInterval interval1 = LongInterval.zero().to(5);         // results in: 0, 1, 2, 3, 4, 5.
 LongInterval interval2 = LongInterval.zero().to(10).by(2);  // results in: 0, 2, 4, 6, 8, 10.
 

oneTo

public static LongInterval oneTo(long count)

Returns an LongInterval starting from 1 to the specified count value with a step value of 1.

oneToBy

public static LongInterval oneToBy(long count,
 long step)

Returns an LongInterval starting from 1 to the specified count value with a step value of step.

zeroTo

public static LongInterval zeroTo(long count)

Returns an LongInterval starting from 0 to the specified count value with a step value of 1.

zeroToBy

public static LongInterval zeroToBy(long count,
 long step)

Returns an LongInterval starting from 0 to the specified count value with a step value of step.

fromTo

public static LongInterval fromTo(long from,
 long to)

Returns an LongInterval starting from the value from to the specified value to with a step value of 1.

evensFromTo

public static LongInterval evensFromTo(long from,
 long to)

Returns an LongInterval representing the even values from the value from to the value to.

oddsFromTo

public static LongInterval oddsFromTo(long from,
 long to)

Returns an LongInterval representing the odd values from the value from to the value to.

fromToBy

public static LongInterval fromToBy(long from,
 long to,
 long stepBy)

Returns an LongInterval for the range of integers inclusively between from and to with the specified stepBy value.

containsAll

public boolean containsAll(long... values)

Returns true if the LongInterval contains all of the specified long values.

Specified by:

containsAll in interface LongIterable

containsAll

public boolean containsAll(LongIterable source)

Description copied from interface: LongIterable

Returns true if all of the values specified in the source LongIterable are contained in the LongIterable, and false if they are not.

Specified by:

containsAll in interface LongIterable

containsNone

public boolean containsNone(int... values)

Returns true if the LongInterval contains none of the specified long values.

contains

public boolean contains(long value)

Returns true if the LongInterval contains the specified long value.

Specified by:

contains in interface LongIterable

forEachWithIndex

public void forEachWithIndex(LongIntProcedure procedure)

Specified by:

forEachWithIndex in interface OrderedLongIterable

forEachWithLongIndex

public void forEachWithLongIndex(LongLongProcedure procedure)

forEach

public void forEach(LongProcedure procedure)

Description copied from interface: LongIterable

Applies the LongProcedure to each element in the LongIterable.

Specified by:

forEach in interface LongIterable

each

public void each(LongProcedure procedure)

Description copied from interface: LongIterable

A synonym for forEach.

Specified by:

each in interface LongIterable

Since:

7.0.

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

noneSatisfy

public boolean noneSatisfy(LongPredicate predicate)

Description copied from interface: LongIterable

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

Specified by:

noneSatisfy 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

toReversed

public LongInterval toReversed()

Returns a new LongInterval with the from and to values reversed and the step value negated.

Specified by:

toReversed in interface ImmutableLongList

Specified by:

toReversed in interface LongList

Specified by:

toReversed in interface ReversibleLongIterable

distinct

public ImmutableLongList distinct()

Specified by:

distinct in interface ImmutableLongList

Specified by:

distinct in interface LongList

Specified by:

distinct in interface ReversibleLongIterable

Since:

6.0

subList

public ImmutableLongList subList(int fromIndex,
 int toIndex)

Specified by:

subList in interface ImmutableLongList

Specified by:

subList in interface LongList

See Also:

• List.subList(int fromIndex, int toIndex)

size

public int size()

Returns the size of the interval.

Specified by:

size in interface PrimitiveIterable

dotProduct

public long dotProduct(LongList list)

Specified by:

dotProduct in interface LongList

isEmpty

public boolean isEmpty()

Description copied from interface: PrimitiveIterable

Returns true if this iterable has zero items.

Specified by:

isEmpty in interface PrimitiveIterable

notEmpty

public boolean notEmpty()

Description copied from interface: PrimitiveIterable

The English equivalent of !this.isEmpty()

Specified by:

notEmpty in interface PrimitiveIterable

makeString

public String makeString()

Description copied from interface: PrimitiveIterable

Returns a string representation of this collection by delegating to PrimitiveIterable.makeString(String) and defaulting the separator parameter to the characters ", " (comma and space).

Specified by:

makeString in interface PrimitiveIterable

Returns:

a string representation of this collection.

makeString

public String makeString(String separator)

Description copied from interface: PrimitiveIterable

Returns a string representation of this collection by delegating to PrimitiveIterable.makeString(String, String, String) and defaulting the start and end parameters to "" (the empty String).

Specified by:

makeString in interface PrimitiveIterable

Returns:

a string representation of this collection.

makeString

public String makeString(String start,
 String separator,
 String end)

Description copied from interface: PrimitiveIterable

Returns a string representation of this collection with the elements separated by the specified separator and enclosed between the start and end strings.

Specified by:

makeString in interface PrimitiveIterable

Returns:

a string representation of this collection.

appendString

public void appendString(Appendable appendable)

Description copied from interface: PrimitiveIterable

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

Specified by:

appendString in interface PrimitiveIterable

appendString

public void appendString(Appendable appendable,
 String separator)

Description copied from interface: PrimitiveIterable

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

Specified by:

appendString in interface PrimitiveIterable

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

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[] result)

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

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.

toString

public String toString()

Description copied from interface: PrimitiveIterable

Returns a string with the elements of this iterable separated by commas with spaces and enclosed in square brackets.

 Assert.assertEquals("[]", IntLists.mutable.empty().toString());
 Assert.assertEquals("[1]", IntLists.mutable.with(1).toString());
 Assert.assertEquals("[1, 2, 3]", IntLists.mutable.with(1, 2, 3).toString());
 

Specified by:

toString in interface PrimitiveIterable

Overrides:

toString in class Object

Returns:

a string representation of this PrimitiveIterable

See Also:

• AbstractCollection.toString()

longIterator

public LongIterator 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

getFirst

public long getFirst()

Specified by:

getFirst in interface OrderedLongIterable

getLast

public long getLast()

Specified by:

getLast in interface ReversibleLongIterable

get

public long get(int index)

Specified by:

get in interface LongList

indexOf

public int indexOf(long value)

Specified by:

indexOf in interface OrderedLongIterable

lastIndexOf

public int lastIndexOf(long value)

Specified by:

lastIndexOf in interface LongList

select

public ImmutableLongList 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 ImmutableLongCollection

Specified by:

select in interface ImmutableLongList

Specified by:

select in interface LongIterable

Specified by:

select in interface LongList

Specified by:

select in interface OrderedLongIterable

Specified by:

select in interface ReversibleLongIterable

reject

public ImmutableLongList 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 ImmutableLongCollection

Specified by:

reject in interface ImmutableLongList

Specified by:

reject in interface LongIterable

Specified by:

reject in interface LongList

Specified by:

reject in interface OrderedLongIterable

Specified by:

reject in interface ReversibleLongIterable

detectIfNone

public long detectIfNone(LongPredicate predicate,
 long ifNone)

Specified by:

detectIfNone in interface LongIterable

collect

public <V> ImmutableList<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 ImmutableLongCollection

Specified by:

collect in interface ImmutableLongList

Specified by:

collect in interface LongIterable

Specified by:

collect in interface LongList

Specified by:

collect in interface OrderedLongIterable

Specified by:

collect in interface ReversibleLongIterable

asReversed

public LazyLongIterable asReversed()

Specified by:

asReversed in interface ReversibleLongIterable

sum

public long sum()

Specified by:

sum in interface LongIterable

max

public long max()

Specified by:

max in interface LongIterable

min

public long min()

Specified by:

min in interface LongIterable

minIfEmpty

public long minIfEmpty(long defaultValue)

Specified by:

minIfEmpty in interface LongIterable

maxIfEmpty

public long maxIfEmpty(long defaultValue)

Specified by:

maxIfEmpty in interface LongIterable

average

public double average()

Specified by:

average in interface LongIterable

median

public double median()

Specified by:

median in interface LongIterable

binarySearch

public int binarySearch(long value)

Specified by:

binarySearch in interface LongList

toSortedArray

public long[] toSortedArray()

Specified by:

toSortedArray in interface LongIterable

toList

public MutableLongList toList()

Description copied from interface: LongIterable

Converts the LongIterable to a new MutableLongList.

Specified by:

toList in interface LongIterable

toSortedList

public MutableLongList toSortedList()

Specified by:

toSortedList in interface LongIterable

toSet

public MutableLongSet toSet()

Description copied from interface: LongIterable

Converts the LongIterable to a new MutableLongSet.

Specified by:

toSet in interface LongIterable

toBag

public MutableLongBag toBag()

Description copied from interface: LongIterable

Converts the LongIterable to a new MutableLongBag.

Specified by:

toBag in interface LongIterable

asLazy

public LazyLongIterable asLazy()

Description copied from interface: LongIterable

Returns a LazyLongIterable adapter wrapping the source LongIterable.

Specified by:

asLazy in interface LongIterable

toImmutable

public ImmutableLongList toImmutable()

Description copied from interface: LongList

Returns an immutable copy of this list. If the list is immutable, it returns itself.

Specified by:

toImmutable in interface LongList

newWith

public ImmutableLongList newWith(long element)

Specified by:

newWith in interface ImmutableLongCollection

Specified by:

newWith in interface ImmutableLongList

newWithout

public ImmutableLongList newWithout(long element)

Specified by:

newWithout in interface ImmutableLongCollection

Specified by:

newWithout in interface ImmutableLongList

newWithAll

public ImmutableLongList newWithAll(LongIterable elements)

Specified by:

newWithAll in interface ImmutableLongCollection

Specified by:

newWithAll in interface ImmutableLongList

newWithoutAll

public ImmutableLongList newWithoutAll(LongIterable elements)

Specified by:

newWithoutAll in interface ImmutableLongCollection

Specified by:

newWithoutAll in interface ImmutableLongList

zipLong

public ImmutableList<LongLongPair> zipLong(LongIterable iterable)

Description copied from interface: ImmutableLongList

Returns an ImmutableList formed from this ImmutableLongList 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 ImmutableLongList

Specified by:

zipLong in interface LongList

zip

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

Description copied from interface: ImmutableLongList

Returns an ImmutableList formed from this ImmutableLongList 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 ImmutableLongList

Specified by:

zip in interface LongList

spliterator

public Spliterator.OfLong spliterator()

Specified by:

spliterator in interface LongList