org.decimal4j.exact

Class Multipliable17f

java.lang.Object

org.decimal4j.exact.Multipliable17f

public final class Multipliable17f
extends Object

A Multipliable17f encapsulates a Decimal of scale 17 and facilitates exact typed multiplication. The multipliable object acts as first factor in the multiplication and provides a set of overloaded methods for different scales. Each one of those methods delivers a different result scale which represents the appropriate scale for the product of an exact multiplication.

A Multipliable17f object is returned by Decimal17f.multiplyExact(), hence an exact typed multiplication can be written as:

 Decimal17f value = ... //some value
 Decimal17f product = value.multiplyExact().by(Decimal0f.FIVE);
 

Constructor Summary

Constructors

Constructor and Description
Multipliable17f(Decimal<Scale17f> value) Constructor with Decimal value to be encapsulated.

Method Summary

Modifier and Type	Method and Description
Decimal17f	by(Decimal0f factor) Returns a Decimal whose value is (this * factor).
Decimal18f	by(Decimal1f factor) Returns a Decimal whose value is (this * factor).
Decimal17f	by(MutableDecimal0f factor) Returns a Decimal whose value is (this * factor).
Decimal18f	by(MutableDecimal1f factor) Returns a Decimal whose value is (this * factor).
boolean	equals(Object obj) Compares this Multipliable17f to the specified object.
Decimal<Scale17f>	getValue() Returns the value underlying this Multipliable17f.
int	hashCode() Returns a hash code for this Multipliable17f which happens to be the hash code of the underlying Decimal17f value.
String	toString() Returns a string representation of this Multipliable17f which is simply the string representation of the underlying Decimal value.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Multipliable17f

public Multipliable17f(Decimal<Scale17f> value)

Constructor with Decimal value to be encapsulated.

Parameters:

value - the decimal value to be wrapped as a multipliable object

Method Detail

getValue

public Decimal<Scale17f> getValue()

Returns the value underlying this Multipliable17f.

Returns:

the Decimal value wrapped by this multipliable object

by

public Decimal17f by(Decimal0f factor)

Returns a Decimal whose value is (this * factor). The result is exact and has scale 17 which is the sum of the scales of the Decimal that this multipliable object represents and the scale of the factor argument. An ArithmeticException is thrown if the product is out of the possible range for a Decimal17f.

Note that the result is always a new instance.

Parameters:

factor - the factor to multiply with the Decimal that this multipliable represents

Returns:

(this * factor)

Throws:

ArithmeticException - if an overflow occurs and product is out of the possible range for a Decimal17f

by

public Decimal17f by(MutableDecimal0f factor)

Returns a Decimal whose value is (this * factor). The result is exact and has scale 17 which is the sum of the scales of the Decimal that this multipliable object represents and the scale of the factor argument. An ArithmeticException is thrown if the product is out of the possible range for a Decimal17f.

Note that the result is always a new instance.

Parameters:

factor - the factor to multiply with the Decimal that this multipliable represents

Returns:

(this * factor)

Throws:

ArithmeticException - if an overflow occurs and product is out of the possible range for a Decimal17f

by

public Decimal18f by(Decimal1f factor)

Returns a Decimal whose value is (this * factor). The result is exact and has scale 18 which is the sum of the scales of the Decimal that this multipliable object represents and the scale of the factor argument. An ArithmeticException is thrown if the product is out of the possible range for a Decimal18f.

Note that the result is always a new instance.

Parameters:

factor - the factor to multiply with the Decimal that this multipliable represents

Returns:

(this * factor)

Throws:

ArithmeticException - if an overflow occurs and product is out of the possible range for a Decimal18f

by

public Decimal18f by(MutableDecimal1f factor)

Returns a Decimal whose value is (this * factor). The result is exact and has scale 18 which is the sum of the scales of the Decimal that this multipliable object represents and the scale of the factor argument. An ArithmeticException is thrown if the product is out of the possible range for a Decimal18f.

Note that the result is always a new instance.

Parameters:

factor - the factor to multiply with the Decimal that this multipliable represents

Returns:

(this * factor)

Throws:

ArithmeticException - if an overflow occurs and product is out of the possible range for a Decimal18f

hashCode

public int hashCode()

Returns a hash code for this Multipliable17f which happens to be the hash code of the underlying Decimal17f value.

Overrides:

hashCode in class Object

Returns:

a hash code value for this object

See Also:

Decimal.hashCode()

equals

public boolean equals(Object obj)

Compares this Multipliable17f to the specified object. The result is true if and only if the argument is a Multipliable17f with an equal underlying value.

Overrides:

equals in class Object

Parameters:

obj - the object to compare with

Returns:

true if the argument is a Multipliable17f and if its value is equal to this multipliables's value; false otherwise

See Also:

getValue(), Decimal.equals(Object)

toString

public String toString()

Returns a string representation of this Multipliable17f which is simply the string representation of the underlying Decimal value.

Overrides:

toString in class Object

Returns:

a String Decimal representation of this Multipliable17f's value with all the fraction digits (including trailing zeros)

See Also:

getValue(), Decimal.toString()