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 givenAppendable
.void
appendString(Appendable appendable, String separator)
Prints a string representation of this collection onto the givenAppendable
.void
appendString(Appendable appendable, String start, String separator, String end)
Prints a string representation of this collection onto the givenAppendable
.LazyLongIterable
asLazy()
Returns a LazyLongIterable adapter wrapping the source LongIterable.LazyLongIterable
asReversed()
double
average()
int
binarySearch(long value)
LongInterval
by(long newStep)
This instanceby
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 the 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 asList.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 staticfrom
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 asList.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 toPrimitiveIterable.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 toPrimitiveIterable.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 instanceto
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 anImmutableList
formed from thisImmutableLongList
and aListIterable
by combining corresponding elements in pairs.ImmutableList<LongLongPair>
zipLong(LongIterable iterable)
Returns anImmutableList
formed from thisImmutableLongList
and anotherLongList
by combining corresponding elements in pairs.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, flatCollect, medianIfEmpty, reduce, reduceIfEmpty, reject, select, summaryStatistics
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
This staticfrom
method allows LongInterval to act as a fluent builder for itself. It works in conjunction with the instance methodsto(long)
andby(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
This instanceto
method allows LongInterval to act as a fluent builder for itself. It works in conjunction with the static methodfrom(long)
and instance methodby(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
This instanceby
method allows LongInterval to act as a fluent builder for itself. It works in conjunction with the static methodfrom(long)
and instance methodto(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
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
Returns an LongInterval starting from 1 to the specified count value with a step value of 1. -
oneToBy
Returns an LongInterval starting from 1 to the specified count value with a step value of step. -
zeroTo
Returns an LongInterval starting from 0 to the specified count value with a step value of 1. -
zeroToBy
Returns an LongInterval starting from 0 to the specified count value with a step value of step. -
fromTo
Returns an LongInterval starting from the value from to the specified value to with a step value of 1. -
evensFromTo
Returns an LongInterval representing the even values from the value from to the value to. -
oddsFromTo
Returns an LongInterval representing the odd values from the value from to the value to. -
fromToBy
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 interfaceLongIterable
-
containsAll
Description copied from interface:LongIterable
Returns true if the all of the values specified in the source LongIterable are contained in the LongIterable, and false if they are not.- Specified by:
containsAll
in interfaceLongIterable
-
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 interfaceLongIterable
-
forEachWithIndex
- Specified by:
forEachWithIndex
in interfaceOrderedLongIterable
-
forEachWithLongIndex
-
forEach
Description copied from interface:LongIterable
Applies the LongProcedure to each element in the LongIterable.- Specified by:
forEach
in interfaceLongIterable
-
each
Description copied from interface:LongIterable
A synonym for forEach.- Specified by:
each
in interfaceLongIterable
- Since:
- 7.0.
-
count
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 interfaceLongIterable
-
anySatisfy
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 interfaceLongIterable
-
allSatisfy
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 interfaceLongIterable
-
noneSatisfy
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 interfaceLongIterable
-
equals
Description copied from interface:LongList
Follows the same general contract asList.equals(Object)
. -
hashCode
public int hashCode()Description copied from interface:LongList
Follows the same general contract asList.hashCode()
. -
toReversed
Returns a new LongInterval with the from and to values reversed and the step value negated.- Specified by:
toReversed
in interfaceImmutableLongList
- Specified by:
toReversed
in interfaceLongList
- Specified by:
toReversed
in interfaceReversibleLongIterable
-
distinct
- Specified by:
distinct
in interfaceImmutableLongList
- Specified by:
distinct
in interfaceLongList
- Specified by:
distinct
in interfaceReversibleLongIterable
- Since:
- 6.0
-
subList
- Specified by:
subList
in interfaceImmutableLongList
- Specified by:
subList
in interfaceLongList
- See Also:
List.subList(int fromIndex, int toIndex)
-
size
public int size()Returns the size of the interval.- Specified by:
size
in interfacePrimitiveIterable
-
dotProduct
- Specified by:
dotProduct
in interfaceLongList
-
isEmpty
public boolean isEmpty()Description copied from interface:PrimitiveIterable
Returns true if this iterable has zero items.- Specified by:
isEmpty
in interfacePrimitiveIterable
-
notEmpty
public boolean notEmpty()Description copied from interface:PrimitiveIterable
The English equivalent of !this.isEmpty()- Specified by:
notEmpty
in interfacePrimitiveIterable
-
makeString
Description copied from interface:PrimitiveIterable
Returns a string representation of this collection by delegating toPrimitiveIterable.makeString(String)
and defaulting the separator parameter to the characters", "
(comma and space).- Specified by:
makeString
in interfacePrimitiveIterable
- Returns:
- a string representation of this collection.
-
makeString
Description copied from interface:PrimitiveIterable
Returns a string representation of this collection by delegating toPrimitiveIterable.makeString(String, String, String)
and defaulting the start and end parameters to""
(the empty String).- Specified by:
makeString
in interfacePrimitiveIterable
- Returns:
- a string representation of this collection.
-
makeString
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 interfacePrimitiveIterable
- Returns:
- a string representation of this collection.
-
appendString
Description copied from interface:PrimitiveIterable
Prints a string representation of this collection onto the givenAppendable
. Prints the string returned byPrimitiveIterable.makeString()
.- Specified by:
appendString
in interfacePrimitiveIterable
-
appendString
Description copied from interface:PrimitiveIterable
Prints a string representation of this collection onto the givenAppendable
. Prints the string returned byPrimitiveIterable.makeString(String)
.- Specified by:
appendString
in interfacePrimitiveIterable
-
appendString
Description copied from interface:PrimitiveIterable
Prints a string representation of this collection onto the givenAppendable
. Prints the string returned byPrimitiveIterable.makeString(String, String, String)
.- Specified by:
appendString
in interfacePrimitiveIterable
-
toArray
public long[] toArray()Description copied from interface:LongIterable
Converts the LongIterable to a primitive long array.- Specified by:
toArray
in interfaceLongIterable
-
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 interfaceLongIterable
-
injectInto
public <T> T injectInto(T injectedValue, ObjectLongToObjectFunction<? super T,? extends T> function)- Specified by:
injectInto
in interfaceLongIterable
-
injectIntoWithIndex
public <T> T injectIntoWithIndex(T injectedValue, ObjectLongIntToObjectFunction<? super T,? extends T> function)- Specified by:
injectIntoWithIndex
in interfaceOrderedLongIterable
- Specified by:
injectIntoWithIndex
in interfaceReversibleLongIterable
-
chunk
Description copied from interface:LongIterable
Partitions elements in fixed size chunks.- Specified by:
chunk
in interfaceLongIterable
- Parameters:
size
- the number of elements per chunk- Returns:
- A
RichIterable
containingLongIterable
s of sizesize
, except the last will be truncated if the elements don't divide evenly.
-
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 interfacePrimitiveIterable
- Overrides:
toString
in classObject
- Returns:
- a string representation of this PrimitiveIterable
- See Also:
AbstractCollection.toString()
-
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 interfaceLongIterable
-
getFirst
public long getFirst()- Specified by:
getFirst
in interfaceOrderedLongIterable
-
getLast
public long getLast()- Specified by:
getLast
in interfaceReversibleLongIterable
-
get
public long get(int index) -
indexOf
public int indexOf(long value)- Specified by:
indexOf
in interfaceOrderedLongIterable
-
lastIndexOf
public int lastIndexOf(long value)- Specified by:
lastIndexOf
in interfaceLongList
-
select
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 interfaceImmutableLongCollection
- Specified by:
select
in interfaceImmutableLongList
- Specified by:
select
in interfaceLongIterable
- Specified by:
select
in interfaceLongList
- Specified by:
select
in interfaceOrderedLongIterable
- Specified by:
select
in interfaceReversibleLongIterable
-
reject
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 interfaceImmutableLongCollection
- Specified by:
reject
in interfaceImmutableLongList
- Specified by:
reject
in interfaceLongIterable
- Specified by:
reject
in interfaceLongList
- Specified by:
reject
in interfaceOrderedLongIterable
- Specified by:
reject
in interfaceReversibleLongIterable
-
detectIfNone
- Specified by:
detectIfNone
in interfaceLongIterable
-
collect
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 interfaceImmutableLongCollection
- Specified by:
collect
in interfaceImmutableLongList
- Specified by:
collect
in interfaceLongIterable
- Specified by:
collect
in interfaceLongList
- Specified by:
collect
in interfaceOrderedLongIterable
- Specified by:
collect
in interfaceReversibleLongIterable
-
asReversed
- Specified by:
asReversed
in interfaceReversibleLongIterable
-
sum
public long sum()- Specified by:
sum
in interfaceLongIterable
-
max
public long max()- Specified by:
max
in interfaceLongIterable
-
min
public long min()- Specified by:
min
in interfaceLongIterable
-
minIfEmpty
public long minIfEmpty(long defaultValue)- Specified by:
minIfEmpty
in interfaceLongIterable
-
maxIfEmpty
public long maxIfEmpty(long defaultValue)- Specified by:
maxIfEmpty
in interfaceLongIterable
-
average
public double average()- Specified by:
average
in interfaceLongIterable
-
median
public double median()- Specified by:
median
in interfaceLongIterable
-
binarySearch
public int binarySearch(long value)- Specified by:
binarySearch
in interfaceLongList
-
toSortedArray
public long[] toSortedArray()- Specified by:
toSortedArray
in interfaceLongIterable
-
toList
Description copied from interface:LongIterable
Converts the LongIterable to a new MutableLongList.- Specified by:
toList
in interfaceLongIterable
-
toSortedList
- Specified by:
toSortedList
in interfaceLongIterable
-
toSet
Description copied from interface:LongIterable
Converts the LongIterable to a new MutableLongSet.- Specified by:
toSet
in interfaceLongIterable
-
toBag
Description copied from interface:LongIterable
Converts the LongIterable to a new MutableLongBag.- Specified by:
toBag
in interfaceLongIterable
-
asLazy
Description copied from interface:LongIterable
Returns a LazyLongIterable adapter wrapping the source LongIterable.- Specified by:
asLazy
in interfaceLongIterable
-
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 interfaceLongList
-
newWith
- Specified by:
newWith
in interfaceImmutableLongCollection
- Specified by:
newWith
in interfaceImmutableLongList
-
newWithout
- Specified by:
newWithout
in interfaceImmutableLongCollection
- Specified by:
newWithout
in interfaceImmutableLongList
-
newWithAll
- Specified by:
newWithAll
in interfaceImmutableLongCollection
- Specified by:
newWithAll
in interfaceImmutableLongList
-
newWithoutAll
- Specified by:
newWithoutAll
in interfaceImmutableLongCollection
- Specified by:
newWithoutAll
in interfaceImmutableLongList
-
zipLong
Description copied from interface:ImmutableLongList
Returns anImmutableList
formed from thisImmutableLongList
and anotherLongList
by combining corresponding elements in pairs. If one of the twoLongList
s is longer than the other, its remaining elements are ignored.- Specified by:
zipLong
in interfaceImmutableLongList
- Specified by:
zipLong
in interfaceLongList
-
zip
Description copied from interface:ImmutableLongList
Returns anImmutableList
formed from thisImmutableLongList
and aListIterable
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 interfaceImmutableLongList
- Specified by:
zip
in interfaceLongList
-
spliterator
- Specified by:
spliterator
in interfaceLongList
-