Package org.apache.commons.lang3

Class IntegerRange

java.lang.Object

org.apache.commons.lang3.Range<Integer>

org.apache.commons.lang3.NumberRange<Integer>

org.apache.commons.lang3.IntegerRange

All Implemented Interfaces:

Serializable

public final class IntegerRange
extends NumberRange<Integer>

Specializes NumberRange for Integers.

This class is not designed to interoperate with other NumberRanges

Since:

3.13.0

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private static final long	serialVersionUID

Constructor Summary

Constructors

Modifier	Constructor	Description
private	IntegerRange(Integer number1, Integer number2)	Creates a new instance.

Method Summary

Modifier and Type	Method	Description
static IntegerRange	of(int fromInclusive, int toInclusive)	Creates a closed range with the specified minimum and maximum values (both inclusive).
static IntegerRange	of(Integer fromInclusive, Integer toInclusive)	Creates a closed range with the specified minimum and maximum values (both inclusive).
IntStream	toIntStream()	Returns a sequential ordered IntStream from Range.getMinimum() (inclusive) to Range.getMaximum() (inclusive) by an incremental step of 1.

Methods inherited from class org.apache.commons.lang3.Range

between, between, contains, containsRange, elementCompareTo, equals, fit, getComparator, getMaximum, getMinimum, hashCode, intersectionWith, is, is, isAfter, isAfterRange, isBefore, isBeforeRange, isEndedBy, isNaturalOrdering, isOverlappedBy, isStartedBy, of, of, toString, toString

Methods inherited from class java.lang.Object

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

Field Details

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

Constructor Details

IntegerRange

private IntegerRange(Integer number1,
 Integer number2)

Creates a new instance.

Parameters:

number1 - the first element, not null

number2 - the second element, not null

Throws:

NullPointerException - when element1 is null.

NullPointerException - when element2 is null.

Method Details

of

public static IntegerRange of(int fromInclusive,
 int toInclusive)

Creates a closed range with the specified minimum and maximum values (both inclusive).

The range uses the natural ordering of the elements to determine where values lie in the range.

The arguments may be passed in the order (min,max) or (max,min). The getMinimum and getMaximum methods will return the correct values.

Parameters:

fromInclusive - the first value that defines the edge of the range, inclusive.

toInclusive - the second value that defines the edge of the range, inclusive.

Returns:

the range object, not null.

of

public static IntegerRange of(Integer fromInclusive,
 Integer toInclusive)

Creates a closed range with the specified minimum and maximum values (both inclusive).

The range uses the natural ordering of the elements to determine where values lie in the range.

The arguments may be passed in the order (min,max) or (max,min). The getMinimum and getMaximum methods will return the correct values.

Parameters:

fromInclusive - the first value that defines the edge of the range, inclusive.

toInclusive - the second value that defines the edge of the range, inclusive.

Returns:

the range object, not null.

Throws:

IllegalArgumentException - if either element is null.

toIntStream

public IntStream toIntStream()

Returns a sequential ordered IntStream from Range.getMinimum() (inclusive) to Range.getMaximum() (inclusive) by an incremental step of 1.

Returns:

a sequential IntStream for the range of int elements

Since:

3.18.0