org.decimal4j.arithmetic

Class Invert

java.lang.Object

org.decimal4j.arithmetic.Invert

final class Invert
extends Object

Provides static methods to invert a Decimal number, that is, to calculate 1/x.

Method Summary

Modifier and Type	Method and Description
static long	invert(DecimalArithmetic arith, DecimalRounding rounding, long uDecimal) Inverts the specified unscaled decimal value rounding the result if necessary.
static long	invert(DecimalArithmetic arith, long uDecimal) Inverts the specified unscaled decimal value truncating the result if necessary.
static long	invertLong(DecimalRounding rounding, long lValue) Inverts the specified long value rounding the result if necessary.
static long	invertLong(long lValue) Inverts the specified long value truncating the result if necessary.

Methods inherited from class java.lang.Object

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

Method Detail

invertLong

public static final long invertLong(long lValue)

Inverts the specified long value truncating the result if necessary.

Parameters:

lValue - the long value to invert

Returns:

roundDOWN(1/lValue)

Throws:

ArithmeticException - if lValue == 0

invertLong

public static final long invertLong(DecimalRounding rounding,
                                    long lValue)

Inverts the specified long value rounding the result if necessary.

Parameters:

rounding - the rounding to apply if necessary

lValue - the long value to invert

Returns:

round(1/lValue)

Throws:

ArithmeticException - if lValue == 0 or if roundingMode==UNNECESSARY and rounding is necessary

invert

public static final long invert(DecimalArithmetic arith,
                                long uDecimal)

Inverts the specified unscaled decimal value truncating the result if necessary.

Parameters:

arith - the arithmetic associated with the given value

uDecimal - the unscaled decimal value to invert

Returns:

roundDOWN(1/uDecimal)

Throws:

ArithmeticException - if uDecimalDividend is zero or if an overflow occurs and the arithmetics OverflowMode is set to throw an exception

See Also:

DecimalArithmetic.divide(long, long)

invert

public static final long invert(DecimalArithmetic arith,
                                DecimalRounding rounding,
                                long uDecimal)

Inverts the specified unscaled decimal value rounding the result if necessary.

Parameters:

arith - the arithmetic associated with the given value

rounding - the rounding to apply if necessary

uDecimal - the unscaled decimal value to invert

Returns:

round(1/uDecimal)

Throws:

ArithmeticException - if uDecimalDividend is zero, if roundingMode is UNNECESSARY and rounding is necessary or if an overflow occurs and the arithmetics OverflowMode is set to throw an exception

See Also:

DecimalArithmetic.divide(long, long)