org.apache.commons.lang.math

Class DoubleRange

public final class DoubleRange extends Range implements Serializable

DoubleRange represents an inclusive range of doubles.

Since: 2.0

Version: $Id: DoubleRange.java 437554 2006-08-28 06:21:41Z bayard $

Author: Stephen Colebourne

Constructor Summary
DoubleRange(double number)

Constructs a new DoubleRange using the specified number as both the minimum and maximum in this range.

DoubleRange(Number number)

Constructs a new DoubleRange using the specified number as both the minimum and maximum in this range.

DoubleRange(double number1, double number2)

Constructs a new DoubleRange with the specified minimum and maximum numbers (both inclusive).

The arguments may be passed in the order (min,max) or (max,min).

DoubleRange(Number number1, Number number2)

Constructs a new DoubleRange with the specified minimum and maximum numbers (both inclusive).

The arguments may be passed in the order (min,max) or (max,min).

Method Summary
booleancontainsDouble(double value)

Tests whether the specified double occurs within this range using double comparison.

This implementation overrides the superclass for performance as it is the most common case.

booleancontainsNumber(Number number)

Tests whether the specified number occurs within this range using double comparison.

null is handled and returns false.

booleancontainsRange(Range range)

Tests whether the specified range occurs entirely within this range using double comparison.

null is handled and returns false.

booleanequals(Object obj)

Compares this range to another object to test if they are equal.

.
doublegetMaximumDouble()

Gets the maximum number in this range as a double.

floatgetMaximumFloat()

Gets the maximum number in this range as a float.

This conversion can lose information for large values.

intgetMaximumInteger()

Gets the maximum number in this range as a int.

This conversion can lose information for large values or decimals.

longgetMaximumLong()

Gets the maximum number in this range as a long.

This conversion can lose information for large values or decimals.

NumbergetMaximumNumber()

Returns the maximum number in this range.

doublegetMinimumDouble()

Gets the minimum number in this range as a double.

floatgetMinimumFloat()

Gets the minimum number in this range as a float.

This conversion can lose information for large values.

intgetMinimumInteger()

Gets the minimum number in this range as a int.

This conversion can lose information for large values or decimals.

longgetMinimumLong()

Gets the minimum number in this range as a long.

This conversion can lose information for large values or decimals.

NumbergetMinimumNumber()

Returns the minimum number in this range.

inthashCode()

Gets a hashCode for the range.

booleanoverlapsRange(Range range)

Tests whether the specified range overlaps with this range using double comparison.

null is handled and returns false.

StringtoString()

Gets the range as a String.

The format of the String is 'Range[min,max]'.

Constructor Detail

DoubleRange

public DoubleRange(double number)

Constructs a new DoubleRange using the specified number as both the minimum and maximum in this range.

Parameters: number the number to use for this range

Throws: IllegalArgumentException if the number is NaN

DoubleRange

public DoubleRange(Number number)

Constructs a new DoubleRange using the specified number as both the minimum and maximum in this range.

Parameters: number the number to use for this range, must not be null

Throws: IllegalArgumentException if the number is null IllegalArgumentException if the number is NaN

DoubleRange

public DoubleRange(double number1, double number2)

Constructs a new DoubleRange with the specified minimum and maximum numbers (both inclusive).

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

Parameters: number1 first number that defines the edge of the range, inclusive number2 second number that defines the edge of the range, inclusive

Throws: IllegalArgumentException if either number is NaN

DoubleRange

public DoubleRange(Number number1, Number number2)

Constructs a new DoubleRange with the specified minimum and maximum numbers (both inclusive).

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

Parameters: number1 first number that defines the edge of the range, inclusive number2 second number that defines the edge of the range, inclusive

Throws: IllegalArgumentException if either number is null IllegalArgumentException if either number is NaN

Method Detail

containsDouble

public boolean containsDouble(double value)

Tests whether the specified double occurs within this range using double comparison.

This implementation overrides the superclass for performance as it is the most common case.

Parameters: value the double to test

Returns: true if the specified number occurs within this range by double comparison

containsNumber

public boolean containsNumber(Number number)

Tests whether the specified number occurs within this range using double comparison.

null is handled and returns false.

Parameters: number the number to test, may be null

Returns: true if the specified number occurs within this range

containsRange

public boolean containsRange(Range range)

Tests whether the specified range occurs entirely within this range using double comparison.

null is handled and returns false.

Parameters: range the range to test, may be null

Returns: true if the specified range occurs entirely within this range

Throws: IllegalArgumentException if the range is not of this type

equals

public boolean equals(Object obj)

Compares this range to another object to test if they are equal.

.

To be equal, the class, minimum and maximum must be equal.

Parameters: obj the reference object with which to compare

Returns: true if this object is equal

getMaximumDouble

public double getMaximumDouble()

Gets the maximum number in this range as a double.

Returns: the maximum number in this range

getMaximumFloat

public float getMaximumFloat()

Gets the maximum number in this range as a float.

This conversion can lose information for large values.

Returns: the maximum number in this range

getMaximumInteger

public int getMaximumInteger()

Gets the maximum number in this range as a int.

This conversion can lose information for large values or decimals.

Returns: the maximum number in this range

getMaximumLong

public long getMaximumLong()

Gets the maximum number in this range as a long.

This conversion can lose information for large values or decimals.

Returns: the maximum number in this range

getMaximumNumber

public Number getMaximumNumber()

Returns the maximum number in this range.

Returns: the maximum number in this range

getMinimumDouble

public double getMinimumDouble()

Gets the minimum number in this range as a double.

Returns: the minimum number in this range

getMinimumFloat

public float getMinimumFloat()

Gets the minimum number in this range as a float.

This conversion can lose information for large values.

Returns: the minimum number in this range

getMinimumInteger

public int getMinimumInteger()

Gets the minimum number in this range as a int.

This conversion can lose information for large values or decimals.

Returns: the minimum number in this range

getMinimumLong

public long getMinimumLong()

Gets the minimum number in this range as a long.

This conversion can lose information for large values or decimals.

Returns: the minimum number in this range

getMinimumNumber

public Number getMinimumNumber()

Returns the minimum number in this range.

Returns: the minimum number in this range

hashCode

public int hashCode()

Gets a hashCode for the range.

Returns: a hash code value for this object

overlapsRange

public boolean overlapsRange(Range range)

Tests whether the specified range overlaps with this range using double comparison.

null is handled and returns false.

Parameters: range the range to test, may be null

Returns: true if the specified range overlaps with this range

toString

public String toString()

Gets the range as a String.

The format of the String is 'Range[min,max]'.

Returns: the String representation of this range

Copyright © 2001-2010 - Apache Software Foundation