org.decimal4j.exact

Class Multipliable16f

java.lang.Object

org.decimal4j.exact.Multipliable16f

public final class Multipliable16f
extends Object

A Multipliable16f encapsulates a Decimal of scale 16 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 Multipliable16f object is returned by Decimal16f.multiplyExact(), hence an exact typed multiplication can be written as:

 Decimal16f value = ... //some value
 Decimal18f product = value.multiplyExact().by(Decimal2f.FIVE);
 

Constructor Summary

Constructors

Constructor and Description
Multipliable16f(Decimal<Scale16f> value) Constructor with Decimal value to be encapsulated.

Method Summary

Modifier and Type	Method and Description
Decimal16f	by(Decimal0f factor) Returns a Decimal whose value is (this * factor).
Decimal17f	by(Decimal1f factor) Returns a Decimal whose value is (this * factor).
Decimal18f	by(Decimal2f factor) Returns a Decimal whose value is (this * factor).
Decimal16f	by(MutableDecimal0f factor) Returns a Decimal whose value is (this * factor).
Decimal17f	by(MutableDecimal1f factor) Returns a Decimal whose value is (this * factor).
Decimal18f	by(MutableDecimal2f factor) Returns a Decimal whose value is (this * factor).
boolean	equals(Object obj) Compares this Multipliable16f to the specified object.
Decimal<Scale16f>	getValue() Returns the value underlying this Multipliable16f.
int	hashCode() Returns a hash code for this Multipliable16f which happens to be the hash code of the underlying Decimal16f value.
String	toString() Returns a string representation of this Multipliable16f 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

Multipliable16f

public Multipliable16f(Decimal<Scale16f> 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<Scale16f> getValue()

Returns the value underlying this Multipliable16f.

Returns:

the Decimal value wrapped by this multipliable object

by

public Decimal16f by(Decimal0f factor)

Returns a Decimal whose value is (this * factor). The result is exact and has scale 16 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 Decimal16f.

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 Decimal16f

by

public Decimal16f by(MutableDecimal0f factor)

Returns a Decimal whose value is (this * factor). The result is exact and has scale 16 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 Decimal16f.

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 Decimal16f

by

public Decimal17f by(Decimal1f 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(MutableDecimal1f 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(Decimal2f 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(MutableDecimal2f 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 Multipliable16f which happens to be the hash code of the underlying Decimal16f 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 Multipliable16f to the specified object. The result is true if and only if the argument is a Multipliable16f with an equal underlying value.

Overrides:

equals in class Object

Parameters:

obj - the object to compare with

Returns:

true if the argument is a Multipliable16f 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 Multipliable16f which is simply the string representation of the underlying Decimal value.

Overrides:

toString in class Object

Returns:

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

See Also:

getValue(), Decimal.toString()