org.apache.commons.lang
public final class NumberRange extends Object
Deprecated: Use one of the Range classes in org.apache.commons.lang.math. Class will be removed in Commons Lang 3.0.
Represents a range of Number objects.
This class uses double
comparisons. This means that it
is unsuitable for dealing with large Long
, BigDecimal
or BigInteger
numbers.
Since: 1.0
Version: $Revision: 437554 $ $Date: 2006-08-27 23:21:41 -0700 (Sun, 27 Aug 2006) $
Constructor Summary | |
---|---|
NumberRange(Number num) Constructs a new | |
NumberRange(Number min, Number max) Constructs a new If the maximum is less than the minimum, the range will be constructed from the minimum value to the minimum value, not what you would expect! |
Method Summary | |
---|---|
boolean | equals(Object obj) Indicates whether some other |
Number | getMaximum() Returns the maximum number in this range. |
Number | getMinimum() Returns the minimum number in this range. |
int | hashCode() Returns a hash code value for this object. |
boolean | includesNumber(Number number) Tests whether the specified |
boolean | includesRange(NumberRange range) Tests whether the specified range occurs entirely within this
range using |
boolean | overlaps(NumberRange range) Tests whether the specified range overlaps with this range
using |
String | toString() Returns the string representation of this range. This string is the string representation of the minimum and maximum numbers in the range, separated by a hyphen. |
Constructs a new NumberRange
using
number
as both the minimum and maximum in
this range.
Parameters: num the number to use for this range
Throws: NullPointerException if the number is null
Constructs a new NumberRange
with the specified
minimum and maximum numbers.
If the maximum is less than the minimum, the range will be constructed from the minimum value to the minimum value, not what you would expect!.
Parameters: min the minimum number in this range max the maximum number in this range
Throws: NullPointerException if either the minimum or maximum number is
null
Indicates whether some other Object
is
"equal" to this one.
Parameters: obj the reference object with which to compare
Returns: true
if this object is the same as the obj
argument; false
otherwise
Returns the maximum number in this range.
Returns: the maximum number in this range
Returns the minimum number in this range.
Returns: the minimum number in this range
Returns a hash code value for this object.
Returns: a hash code value for this object
Tests whether the specified number
occurs within
this range using double
comparison.
Parameters: number the number to test
Returns: true
if the specified number occurs within this
range; otherwise, false
Tests whether the specified range occurs entirely within this
range using double
comparison.
Parameters: range the range to test
Returns: true
if the specified range occurs entirely within
this range; otherwise, false
Tests whether the specified range overlaps with this range
using double
comparison.
Parameters: range the range to test
Returns: true
if the specified range overlaps with this
range; otherwise, false
Returns the string representation of this range.
This string is the string representation of the minimum and maximum numbers in the range, separated by a hyphen. If a number is negative, then it is enclosed in parentheses.
Returns: the string representation of this range