BigFraction (sellcom-java 1.6.0)

java.lang.Object
- java.lang.Number
- - org.sellcom.core.math.BigFraction

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<BigFraction>
```
public class BigFraction
extends java.lang.Number
implements java.lang.Comparable<BigFraction>
```
Fraction of two BigIntegers.
The value of the fraction is always kept reduced to the lowest possible terms.

Since:

1.6

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field	Description
`static BigFraction`	`ONE`	Fraction of `1/1`.
`static BigFraction`	`ONE_HALF`	Fraction of `1/2`.
`static BigFraction`	`ONE_QUARTER`	Fraction of `1/4`.
`static BigFraction`	`ONE_THIRD`	Fraction of `1/3`.
`static BigFraction`	`THREE_QUARTERS`	Fraction of `3/4`.
`static BigFraction`	`TWO_THIRDS`	Fraction of `2/3`.
`static BigFraction`	`ZERO`	Fraction of `0/1`.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`BigFraction`	`abs()`	Returns the absolute value of this fraction.
`BigFraction`	`add(long value)`	Returns the sum of this fraction and the given number.
`BigFraction`	`add(java.math.BigInteger value)`	Returns the sum of this fraction and the given number.
`BigFraction`	`add(BigFraction other)`	Returns the sum of this fraction and the given fraction.
`int`	`compareTo(BigFraction other)`
`BigFraction`	`divide(long value)`	Returns the quotient of this fraction and the given number.
`BigFraction`	`divide(java.math.BigInteger value)`	Returns the quotient of this fraction and the given number.
`BigFraction`	`divide(BigFraction other)`	Returns the quotient of this fraction and the given fraction.
`double`	`doubleValue()`
`boolean`	`equals(java.lang.Object other)`
`float`	`floatValue()`
`java.math.BigInteger`	`getDenominator()`	Returns the denominator of this fraction.
`java.math.BigInteger`	`getNumerator()`	Returns the numerator of this fraction.
`int`	`hashCode()`
`int`	`intValue()`
`int`	`intValueExact()`	Returns the `int` value of this fraction.
`boolean`	`isInteger()`	Checks whether the value of this fraction is an integer.
`long`	`longValue()`
`long`	`longValueExact()`	Returns the `long` value of this fraction.
`BigFraction`	`multiply(long value)`	Returns the product of this fraction and the given number.
`BigFraction`	`multiply(java.math.BigInteger value)`	Returns the product of this fraction and the given number.
`BigFraction`	`multiply(BigFraction other)`	Returns the product of this fraction and the given fraction.
`BigFraction`	`negate()`	Returns the opposite of this fraction.
`static BigFraction`	`parse(java.lang.String text)`	Returns a fraction obtained from the given text string.
`BigFraction`	`pow(int exponent)`	Returns this fraction raised to the power of the given exponent.
`BigFraction`	`reciprocal()`	Return the reciprocal of this fraction.
`long`	`round(java.math.RoundingMode roundingMode)`	Returns the integer value nearest to the value of this fraction.
`int`	`signum()`	Returns the signum of this value.
`BigFraction`	`subtract(long value)`	Returns the difference of this fraction and the given number.
`BigFraction`	`subtract(java.math.BigInteger value)`	Returns the difference of this fraction and the given number.
`BigFraction`	`subtract(BigFraction other)`	Returns the difference of this fraction and the given fraction.
`java.math.BigDecimal`	`toBigDecimal()`	Returns the `BigDecimal` value of this fraction.
`java.math.BigDecimal`	`toBigDecimal(int scale, java.math.RoundingMode roundingMode)`	Returns the `BigDecimal` value of this fraction.
`java.lang.String`	`toString()`
`static BigFraction`	`valueOf(long value)`	Returns a fraction with the given value.
`static BigFraction`	`valueOf(long numerator, long denominator)`	Returns a fraction with the given numerator and denominator.
`static BigFraction`	`valueOf(java.math.BigInteger value)`	Returns a fraction with the given value.
`static BigFraction`	`valueOf(java.math.BigInteger numerator, java.math.BigInteger denominator)`	Returns a fraction with the given numerator and denominator.

Methods inherited from class java.lang.Number
byteValue, shortValue

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - ONE
```
public static final BigFraction ONE
```
    Fraction of 1/1.
    
    Since:
    
    1.6
  - ONE_HALF
```
public static final BigFraction ONE_HALF
```
    Fraction of 1/2.
    
    Since:
    
    1.6
  - ONE_QUARTER
```
public static final BigFraction ONE_QUARTER
```
    Fraction of 1/4.
    
    Since:
    
    1.6
  - ONE_THIRD
```
public static final BigFraction ONE_THIRD
```
    Fraction of 1/3.
    
    Since:
    
    1.6
  - THREE_QUARTERS
```
public static final BigFraction THREE_QUARTERS
```
    Fraction of 3/4.
    
    Since:
    
    1.6
  - TWO_THIRDS
```
public static final BigFraction TWO_THIRDS
```
    Fraction of 2/3.
    
    Since:
    
    1.6
  - ZERO
```
public static final BigFraction ZERO
```
    Fraction of 0/1.
    
    Since:
    
    1.6
- Method Detail
  - abs
```
public BigFraction abs()
```
    Returns the absolute value of this fraction.
    
    Throws:
    
    java.lang.ArithmeticException - if numerator is equal to Integer.MIN_VALUE
    
    Since:
    
    1.6
  - add
```
public BigFraction add(BigFraction other)
```
    Returns the sum of this fraction and the given fraction.
    
    Throws:
    
    java.lang.IllegalArgumentException - if other is null
    
    Since:
    
    1.6
  - add
```
public BigFraction add(java.math.BigInteger value)
```
    Returns the sum of this fraction and the given number.
    
    Throws:
    
    java.lang.IllegalArgumentException - if value is null
    
    Since:
    
    1.6
  - add
```
public BigFraction add(long value)
```
    Returns the sum of this fraction and the given number.
    
    Since:
    
    1.6
  - compareTo
```
public int compareTo(BigFraction other)
```
    Specified by:
    
    compareTo in interface java.lang.Comparable<BigFraction>
  - divide
```
public BigFraction divide(BigFraction other)
```
    Returns the quotient of this fraction and the given fraction.
    
    Throws:
    
    java.lang.ArithmeticException - if other is equal to 0
    
    Since:
    
    1.6
  - divide
```
public BigFraction divide(java.math.BigInteger value)
```
    Returns the quotient of this fraction and the given number.
    
    Throws:
    
    java.lang.ArithmeticException - if value is equal to 0
    
    java.lang.IllegalArgumentException - if value is null
    
    Since:
    
    1.6
  - divide
```
public BigFraction divide(long value)
```
    Returns the quotient of this fraction and the given number.
    
    Throws:
    
    java.lang.ArithmeticException - if value is equal to 0
    
    Since:
    
    1.6
  - doubleValue
```
public double doubleValue()
```
    Specified by:
    
    doubleValue in class java.lang.Number
  - equals
```
public boolean equals(java.lang.Object other)
```
    Overrides:
    
    equals in class java.lang.Object
  - floatValue
```
public float floatValue()
```
    Specified by:
    
    floatValue in class java.lang.Number
  - getDenominator
```
public java.math.BigInteger getDenominator()
```
    Returns the denominator of this fraction.
    
    Since:
    
    1.6
  - getNumerator
```
public java.math.BigInteger getNumerator()
```
    Returns the numerator of this fraction.
    
    Since:
    
    1.6
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - intValue
```
public int intValue()
```
    Specified by:
    
    intValue in class java.lang.Number
  - isInteger
```
public boolean isInteger()
```
    Checks whether the value of this fraction is an integer.
    
    Since:
    
    1.6
  - intValueExact
```
public int intValueExact()
```
    Returns the int value of this fraction.
    
    Throws:
    
    java.lang.IllegalArgumentException - if the value of this fraction does not exactly fit an int
    
    Since:
    
    1.6
  - longValue
```
public long longValue()
```
    Specified by:
    
    longValue in class java.lang.Number
  - longValueExact
```
public long longValueExact()
```
    Returns the long value of this fraction.
    
    Throws:
    
    java.lang.IllegalArgumentException - if the value of this fraction does not exactly fit a long
    
    Since:
    
    1.6
  - multiply
```
public BigFraction multiply(BigFraction other)
```
    Returns the product of this fraction and the given fraction.
    
    Throws:
    
    java.lang.IllegalArgumentException - if other is null
    
    Since:
    
    1.6
  - multiply
```
public BigFraction multiply(java.math.BigInteger value)
```
    Returns the product of this fraction and the given number.
    
    Throws:
    
    java.lang.IllegalArgumentException - if value is null
    
    Since:
    
    1.6
  - multiply
```
public BigFraction multiply(long value)
```
    Returns the product of this fraction and the given number.
    
    Since:
    
    1.6
  - negate
```
public BigFraction negate()
```
    Returns the opposite of this fraction.
    
    Throws:
    
    java.lang.ArithmeticException - if numerator is equal to Integer.MIN_VALUE
    
    Since:
    
    1.6
  - parse
```
public static BigFraction parse(java.lang.String text)
```
    Returns a fraction obtained from the given text string.
    
    Throws:
    
    java.lang.IllegalArgumentException - if text is null
    
    java.lang.NumberFormatException - if text is not a valid fraction
    
    Since:
    
    1.6
  - pow
```
public BigFraction pow(int exponent)
```
    Returns this fraction raised to the power of the given exponent.
    
    Since:
    
    1.6
  - reciprocal
```
public BigFraction reciprocal()
```
    Return the reciprocal of this fraction.
    
    Throws:
    
    java.lang.ArithmeticException - if the value of this fraction is equal to 0
    
    Since:
    
    1.6
  - round
```
public long round(java.math.RoundingMode roundingMode)
```
    Returns the integer value nearest to the value of this fraction.
    
    Throws:
    
    java.lang.IllegalArgumentException - if roundingMode is null
    
    Since:
    
    1.6
  - signum
```
public int signum()
```
    Returns the signum of this value.
    
    Since:
    
    1.6
  - subtract
```
public BigFraction subtract(BigFraction other)
```
    Returns the difference of this fraction and the given fraction.
    
    Throws:
    
    java.lang.IllegalArgumentException - if other is null
    
    Since:
    
    1.6
  - subtract
```
public BigFraction subtract(java.math.BigInteger value)
```
    Returns the difference of this fraction and the given number.
    
    Throws:
    
    java.lang.IllegalArgumentException - if value is null
    
    Since:
    
    1.6
  - subtract
```
public BigFraction subtract(long value)
```
    Returns the difference of this fraction and the given number.
    
    Since:
    
    1.6
  - toBigDecimal
```
public java.math.BigDecimal toBigDecimal()
```
    Returns the BigDecimal value of this fraction.
    
    Throws:
    
    java.lang.IllegalArgumentException - if the value of this fraction does not have a terminating decimal expansion
    
    Since:
    
    1.6
  - toBigDecimal
```
public java.math.BigDecimal toBigDecimal(int scale,
                                         java.math.RoundingMode roundingMode)
```
    Returns the BigDecimal value of this fraction.
    
    Throws:
    
    java.lang.IllegalArgumentException - if roundingMode is null
    
    Since:
    
    1.6
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - valueOf
```
public static BigFraction valueOf(java.math.BigInteger value)
```
    Returns a fraction with the given value.
    
    Throws:
    
    java.lang.IllegalArgumentException - if value is null
    
    Since:
    
    1.6
  - valueOf
```
public static BigFraction valueOf(java.math.BigInteger numerator,
                                  java.math.BigInteger denominator)
```
    Returns a fraction with the given numerator and denominator.
    
    Throws:
    
    java.lang.IllegalArgumentException - if denominator is null
    
    java.lang.IllegalArgumentException - if denominator is 0
    
    java.lang.IllegalArgumentException - if numerator is null
    
    Since:
    
    1.6
  - valueOf
```
public static BigFraction valueOf(long value)
```
    Returns a fraction with the given value.
    
    Since:
    
    1.6
  - valueOf
```
public static BigFraction valueOf(long numerator,
                                  long denominator)
```
    Returns a fraction with the given numerator and denominator.
    
    Throws:
    
    java.lang.IllegalArgumentException - if denominator is 0
    
    Since:
    
    1.6

Class BigFraction

Field Summary

Method Summary

Methods inherited from class java.lang.Number

Methods inherited from class java.lang.Object

Field Detail

ONE

ONE_HALF

ONE_QUARTER

ONE_THIRD

THREE_QUARTERS

TWO_THIRDS

ZERO

Method Detail

abs

add

add

add

compareTo

divide

divide

divide

doubleValue

equals

floatValue

getDenominator

getNumerator

hashCode

intValue

isInteger

intValueExact

longValue

longValueExact

multiply

multiply

multiply

negate

parse

pow

reciprocal

round

signum

subtract

subtract

subtract

toBigDecimal

toBigDecimal

toString

valueOf

valueOf

valueOf

valueOf