com.io7m.jranges

Class RangeInclusiveL

java.lang.Object

com.io7m.jranges.RangeInclusiveL

public final class RangeInclusiveL
extends Object

Immutable type representing an inclusive range with long components.

Constructor Summary

Constructors

Constructor and Description
RangeInclusiveL(long in_lower, long in_upper) Construct an inclusive range.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object obj)
long	getInterval() Retrieve the number of values in the range [lower, upper].
long	getLower()
long	getUpper()
int	hashCode()
boolean	includesValue(long value) Determine if the given value is included in this range.
boolean	isIncludedIn(RangeInclusiveL other) Determine if the given range is included in this range.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

RangeInclusiveL

public RangeInclusiveL(long in_lower,
               long in_upper)

Construct an inclusive range. The constructor enforces the invariant lower <= upper.

Parameters:

in_lower - The lower bound

in_upper - The upper bound

Method Detail

equals

public boolean equals(@Nullable
             Object obj)

Overrides:

equals in class Object

getInterval

public long getInterval()

Retrieve the number of values in the range [lower, upper]. That is, (upper - lower) + 1.

Returns:

The number of values in the range

getLower

public long getLower()

Returns:

The lower bound of the inclusive range.

getUpper

public long getUpper()

Returns:

The upper bound of the inclusive range.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

includesValue

public boolean includesValue(long value)

Determine if the given value is included in this range.

Parameters:

value - The given value

Returns:

true iff value >= this.getLower() && value <= this.getUpper() .

isIncludedIn

public boolean isIncludedIn(RangeInclusiveL other)

Determine if the given range is included in this range.

Parameters:

other - The given range

Returns:

true iff this.getLower() >= other.getLower() && this.getUpper() <= other.getUpper() .

toString

public String toString()

Overrides:

toString in class Object