org.decimal4j.arithmetic

Class DoubleConversion

java.lang.Object

org.decimal4j.arithmetic.DoubleConversion

final class DoubleConversion
extends Object

Contains methods to convert from and to double.

Method Summary

Modifier and Type	Method and Description
static long	doubleToLong(DecimalRounding rounding, double value) Converts the specified double value to a long rounding the fractional part if necessary using the given rounding mode.
static long	doubleToLong(double value) Converts the specified double value to a long truncating the fractional part if any is present.
static long	doubleToUnscaled(DecimalArithmetic arith, DecimalRounding rounding, double value) Converts the specified double value to an unscaled decimal.
static long	doubleToUnscaled(DecimalArithmetic arith, double value) Converts the specified double value to an unscaled decimal truncating extra fractional digits if necessary.
static double	longToDouble(DecimalArithmetic arith, DecimalRounding rounding, long value) Converts the specified long value to a double rounding extra mantissa digits if necessary.
static double	longToDouble(DecimalArithmetic arith, long value) Converts the specified long value to a double truncating extra mantissa digits if necessary.
static double	unscaledToDouble(DecimalArithmetic arith, DecimalRounding rounding, long unscaled) Converts the specified unscaled decimal value to a double rounding extra precision digits if necessary.
static double	unscaledToDouble(DecimalArithmetic arith, long unscaled) Converts the specified unscaled decimal value to a double truncating extra precision digits if necessary.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

doubleToLong

public static final long doubleToLong(double value)

Converts the specified double value to a long truncating the fractional part if any is present. If the value is NaN, infinite or outside of the valid long range, an exception is thrown.

Parameters:

value - the value to convert

Returns:

roundDOWN(value)

Throws:

IllegalArgumentException - if value is NaN or infinite or if the magnitude is too large for the double to be represented as a long

doubleToLong

public static final long doubleToLong(DecimalRounding rounding,
                                      double value)

Converts the specified double value to a long rounding the fractional part if necessary using the given rounding mode. If the value is NaN, infinite or outside of the valid long range, an exception is thrown.

Parameters:

rounding - the rounding to apply if necessary

value - the value to convert

Returns:

round(value)

Throws:

IllegalArgumentException - if value is NaN or infinite or if the magnitude is too large for the double to be represented as a long

ArithmeticException - if roundingMode==UNNECESSARY and rounding is necessary

doubleToUnscaled

public static final long doubleToUnscaled(DecimalArithmetic arith,
                                          double value)

Converts the specified double value to an unscaled decimal truncating extra fractional digits if necessary. If the value is NaN, infinite or outside of the valid Decimal range, an exception is thrown.

Parameters:

arith - the arithmetic associated with the result value

value - the value to convert

Returns:

round(value)

Throws:

IllegalArgumentException - if value is NaN or infinite or if the magnitude is too large for the double to be represented as a Decimal of the arithmetic's scale

doubleToUnscaled

public static final long doubleToUnscaled(DecimalArithmetic arith,
                                          DecimalRounding rounding,
                                          double value)

Converts the specified double value to an unscaled decimal. The specified rounding mode is used if rounding is necessary. If the value is NaN, infinite or outside of the valid Decimal range, an exception is thrown.

Parameters:

arith - the arithmetic associated with the result value

rounding - the rounding to apply if necessary

value - the value to convert

Returns:

round(value)

Throws:

IllegalArgumentException - if value is NaN or infinite or if the magnitude is too large for the double to be represented as a Decimal of the arithmetic's scale

ArithmeticException - if roundingMode==UNNECESSARY and rounding is necessary

longToDouble

public static final double longToDouble(DecimalArithmetic arith,
                                        long value)

Converts the specified long value to a double truncating extra mantissa digits if necessary.

Parameters:

arith - the arithmetic associated with the value

value - the long value

Returns:

roundDOWN(value)

longToDouble

public static final double longToDouble(DecimalArithmetic arith,
                                        DecimalRounding rounding,
                                        long value)

Converts the specified long value to a double rounding extra mantissa digits if necessary.

Parameters:

arith - the arithmetic associated with the value

rounding - the rounding to apply if necessary

value - the long value

Returns:

round(value)

Throws:

ArithmeticException - if roundingMode==UNNECESSARY and rounding is necessary

unscaledToDouble

public static final double unscaledToDouble(DecimalArithmetic arith,
                                            long unscaled)

Converts the specified unscaled decimal value to a double truncating extra precision digits if necessary.

Parameters:

arith - the arithmetic associated with the value

unscaled - the unscaled decimal value

Returns:

roundDOWN(value)

unscaledToDouble

public static final double unscaledToDouble(DecimalArithmetic arith,
                                            DecimalRounding rounding,
                                            long unscaled)

Converts the specified unscaled decimal value to a double rounding extra precision digits if necessary.

Parameters:

arith - the arithmetic associated with the value

rounding - the rounding to apply if necessary

unscaled - the unscaled decimal value

Returns:

round(value)

Throws:

ArithmeticException - if roundingMode==UNNECESSARY and rounding is necessary