public final class Multipliable13f extends Object
Multipliable13f
encapsulates a Decimal of scale 13 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 Multipliable13f
object is returned by Decimal13f.multiplyExact()
,
hence an exact typed multiplication can be written as:
Decimal13f value = ... //some value Decimal15f product = value.multiplyExact().by(Decimal2f.FIVE);
Constructor and Description |
---|
Multipliable13f(Decimal<Scale13f> value)
Constructor with Decimal value to be encapsulated.
|
Modifier and Type | Method and Description |
---|---|
Decimal13f |
by(Decimal0f factor)
Returns a
Decimal whose value is (this * factor) . |
Decimal14f |
by(Decimal1f factor)
Returns a
Decimal whose value is (this * factor) . |
Decimal15f |
by(Decimal2f factor)
Returns a
Decimal whose value is (this * factor) . |
Decimal16f |
by(Decimal3f factor)
Returns a
Decimal whose value is (this * factor) . |
Decimal17f |
by(Decimal4f factor)
Returns a
Decimal whose value is (this * factor) . |
Decimal18f |
by(Decimal5f factor)
Returns a
Decimal whose value is (this * factor) . |
Decimal13f |
by(MutableDecimal0f factor)
Returns a
Decimal whose value is (this * factor) . |
Decimal14f |
by(MutableDecimal1f factor)
Returns a
Decimal whose value is (this * factor) . |
Decimal15f |
by(MutableDecimal2f factor)
Returns a
Decimal whose value is (this * factor) . |
Decimal16f |
by(MutableDecimal3f factor)
Returns a
Decimal whose value is (this * factor) . |
Decimal17f |
by(MutableDecimal4f factor)
Returns a
Decimal whose value is (this * factor) . |
Decimal18f |
by(MutableDecimal5f factor)
Returns a
Decimal whose value is (this * factor) . |
boolean |
equals(Object obj)
Compares this Multipliable13f to the specified object.
|
Decimal<Scale13f> |
getValue()
Returns the value underlying this Multipliable13f.
|
int |
hashCode()
Returns a hash code for this Multipliable13f which happens to be the
hash code of the underlying
Decimal13f value. |
String |
toString()
Returns a string representation of this
Multipliable13f which is
simply the string representation of the underlying Decimal value . |
public Multipliable13f(Decimal<Scale13f> value)
value
- the decimal value to be wrapped as a multipliable objectpublic Decimal<Scale13f> getValue()
public Decimal13f by(Decimal0f factor)
Decimal
whose value is (this * factor)
. The
result is exact and has scale 13 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 Decimal13f
.
Note that the result is always a new instance.
factor
- the factor to multiply with the Decimal that this multipliable representsArithmeticException
- if an overflow occurs and product is out of the possible
range for a Decimal13f
public Decimal13f by(MutableDecimal0f factor)
Decimal
whose value is (this * factor)
. The
result is exact and has scale 13 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 Decimal13f
.
Note that the result is always a new instance.
factor
- the factor to multiply with the Decimal that this multipliable representsArithmeticException
- if an overflow occurs and product is out of the possible
range for a Decimal13f
public Decimal14f by(Decimal1f factor)
Decimal
whose value is (this * factor)
. The
result is exact and has scale 14 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 Decimal14f
.
Note that the result is always a new instance.
factor
- the factor to multiply with the Decimal that this multipliable representsArithmeticException
- if an overflow occurs and product is out of the possible
range for a Decimal14f
public Decimal14f by(MutableDecimal1f factor)
Decimal
whose value is (this * factor)
. The
result is exact and has scale 14 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 Decimal14f
.
Note that the result is always a new instance.
factor
- the factor to multiply with the Decimal that this multipliable representsArithmeticException
- if an overflow occurs and product is out of the possible
range for a Decimal14f
public Decimal15f by(Decimal2f factor)
Decimal
whose value is (this * factor)
. The
result is exact and has scale 15 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 Decimal15f
.
Note that the result is always a new instance.
factor
- the factor to multiply with the Decimal that this multipliable representsArithmeticException
- if an overflow occurs and product is out of the possible
range for a Decimal15f
public Decimal15f by(MutableDecimal2f factor)
Decimal
whose value is (this * factor)
. The
result is exact and has scale 15 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 Decimal15f
.
Note that the result is always a new instance.
factor
- the factor to multiply with the Decimal that this multipliable representsArithmeticException
- if an overflow occurs and product is out of the possible
range for a Decimal15f
public Decimal16f by(Decimal3f factor)
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.
factor
- the factor to multiply with the Decimal that this multipliable representsArithmeticException
- if an overflow occurs and product is out of the possible
range for a Decimal16f
public Decimal16f by(MutableDecimal3f factor)
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.
factor
- the factor to multiply with the Decimal that this multipliable representsArithmeticException
- if an overflow occurs and product is out of the possible
range for a Decimal16f
public Decimal17f by(Decimal4f factor)
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.
factor
- the factor to multiply with the Decimal that this multipliable representsArithmeticException
- if an overflow occurs and product is out of the possible
range for a Decimal17f
public Decimal17f by(MutableDecimal4f factor)
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.
factor
- the factor to multiply with the Decimal that this multipliable representsArithmeticException
- if an overflow occurs and product is out of the possible
range for a Decimal17f
public Decimal18f by(Decimal5f factor)
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.
factor
- the factor to multiply with the Decimal that this multipliable representsArithmeticException
- if an overflow occurs and product is out of the possible
range for a Decimal18f
public Decimal18f by(MutableDecimal5f factor)
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.
factor
- the factor to multiply with the Decimal that this multipliable representsArithmeticException
- if an overflow occurs and product is out of the possible
range for a Decimal18f
public int hashCode()
Decimal13f
value.hashCode
in class Object
Decimal.hashCode()
public boolean equals(Object obj)
true
if and only if the argument is a Multipliable13f
with an equal underlying
value
.equals
in class Object
obj
- the object to compare withtrue
if the argument is a Multipliable13f
and if its value
is equal to this multipliables's value; false
otherwisegetValue()
,
Decimal.equals(Object)
public String toString()
Multipliable13f
which is
simply the string representation of the underlying Decimal value
.toString
in class Object
String
Decimal representation of this Multipliable13f
's
value with all the fraction digits (including trailing zeros)getValue()
,
Decimal.toString()