Multipliable7f (decimal4j API 1.0.7-SNAPSHOT)

java.lang.Object
- org.decimal4j.exact.Multipliable7f

```
public final class Multipliable7f
extends Object
```
A Multipliable7f encapsulates a Decimal of scale 7 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 Multipliable7f object is returned by Decimal7f.multiplyExact(), hence an exact typed multiplication can be written as:
```
 Decimal7f value = ... //some value
 Decimal9f product = value.multiplyExact().by(Decimal2f.FIVE);
 
```

Constructor Summary

Constructors
Constructor and Description

Multipliable7f(Decimal<Scale7f> value)
Constructor with Decimal value to be encapsulated.

Constructors
Constructor and Description
`Multipliable7f(Decimal<Scale7f> value)` Constructor with Decimal value to be encapsulated.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Decimal14f`	`by(Decimal<Scale7f> factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal7f`	`by(Decimal0f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal17f`	`by(Decimal10f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal18f`	`by(Decimal11f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal8f`	`by(Decimal1f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal9f`	`by(Decimal2f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal10f`	`by(Decimal3f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal11f`	`by(Decimal4f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal12f`	`by(Decimal5f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal13f`	`by(Decimal6f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal15f`	`by(Decimal8f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal16f`	`by(Decimal9f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal7f`	`by(MutableDecimal0f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal17f`	`by(MutableDecimal10f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal18f`	`by(MutableDecimal11f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal8f`	`by(MutableDecimal1f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal9f`	`by(MutableDecimal2f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal10f`	`by(MutableDecimal3f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal11f`	`by(MutableDecimal4f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal12f`	`by(MutableDecimal5f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal13f`	`by(MutableDecimal6f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal15f`	`by(MutableDecimal8f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`Decimal16f`	`by(MutableDecimal9f factor)` Returns a `Decimal` whose value is `(this * factor)`.
`boolean`	`equals(Object obj)` Compares this Multipliable7f to the specified object.
`Decimal<Scale7f>`	`getValue()` Returns the value underlying this Multipliable7f.
`int`	`hashCode()` Returns a hash code for this `Multipliable7f` which happens to be the hash code of the underlying `Decimal7f` value.
`Decimal14f`	`square()` Returns a `Decimal` whose value is `(this²)`.
`String`	`toString()` Returns a string representation of this `Multipliable7f` 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
  - Multipliable7f
```
public Multipliable7f(Decimal<Scale7f> 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<Scale7f> getValue()
```
    Returns the value underlying this Multipliable7f.
    
    Returns:
    
    the Decimal value wrapped by this multipliable object
  - square
```
public Decimal14f square()
```
    Returns a Decimal whose value is (this²). The result is exact and has scale 14 which is twice the scale of the Decimal that this multipliable object represents. 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.
    
    Returns:
    
    (this * this)
    
    Throws:
    
    ArithmeticException - if an overflow occurs and product is out of the possible range for a Decimal14f
  - by
```
public Decimal14f by(Decimal<Scale7f> factor)
```
    Returns a 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.
    
    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 Decimal14f
  - by
```
public Decimal7f by(Decimal0f factor)
```
    Returns a Decimal whose value is (this * factor). The result is exact and has scale 7 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 Decimal7f.
    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 Decimal7f
  - by
```
public Decimal7f by(MutableDecimal0f factor)
```
    Returns a Decimal whose value is (this * factor). The result is exact and has scale 7 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 Decimal7f.
    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 Decimal7f
  - by
```
public Decimal8f by(Decimal1f factor)
```
    Returns a Decimal whose value is (this * factor). The result is exact and has scale 8 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 Decimal8f.
    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 Decimal8f
  - by
```
public Decimal8f by(MutableDecimal1f factor)
```
    Returns a Decimal whose value is (this * factor). The result is exact and has scale 8 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 Decimal8f.
    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 Decimal8f
  - by
```
public Decimal9f by(Decimal2f factor)
```
    Returns a Decimal whose value is (this * factor). The result is exact and has scale 9 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 Decimal9f.
    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 Decimal9f
  - by
```
public Decimal9f by(MutableDecimal2f factor)
```
    Returns a Decimal whose value is (this * factor). The result is exact and has scale 9 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 Decimal9f.
    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 Decimal9f
  - by
```
public Decimal10f by(Decimal3f factor)
```
    Returns a Decimal whose value is (this * factor). The result is exact and has scale 10 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 Decimal10f.
    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 Decimal10f
  - by
```
public Decimal10f by(MutableDecimal3f factor)
```
    Returns a Decimal whose value is (this * factor). The result is exact and has scale 10 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 Decimal10f.
    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 Decimal10f
  - by
```
public Decimal11f by(Decimal4f factor)
```
    Returns a Decimal whose value is (this * factor). The result is exact and has scale 11 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 Decimal11f.
    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 Decimal11f
  - by
```
public Decimal11f by(MutableDecimal4f factor)
```
    Returns a Decimal whose value is (this * factor). The result is exact and has scale 11 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 Decimal11f.
    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 Decimal11f
  - by
```
public Decimal12f by(Decimal5f factor)
```
    Returns a Decimal whose value is (this * factor). The result is exact and has scale 12 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 Decimal12f.
    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 Decimal12f
  - by
```
public Decimal12f by(MutableDecimal5f factor)
```
    Returns a Decimal whose value is (this * factor). The result is exact and has scale 12 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 Decimal12f.
    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 Decimal12f
  - by
```
public Decimal13f by(Decimal6f factor)
```
    Returns a 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.
    
    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 Decimal13f
  - by
```
public Decimal13f by(MutableDecimal6f factor)
```
    Returns a 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.
    
    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 Decimal13f
  - by
```
public Decimal15f by(Decimal8f factor)
```
    Returns a 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.
    
    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 Decimal15f
  - by
```
public Decimal15f by(MutableDecimal8f factor)
```
    Returns a 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.
    
    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 Decimal15f
  - by
```
public Decimal16f by(Decimal9f 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(MutableDecimal9f 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(Decimal10f 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(MutableDecimal10f 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(Decimal11f 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(MutableDecimal11f 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 Multipliable7f which happens to be the hash code of the underlying Decimal7f 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 Multipliable7f to the specified object. The result is true if and only if the argument is a Multipliable7f with an equal underlying value.
    
    Overrides:
    
    equals in class Object
    
    Parameters:
    
    obj - the object to compare with
    
    Returns:
    
    true if the argument is a Multipliable7f 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 Multipliable7f which is simply the string representation of the underlying Decimal value.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    a String Decimal representation of this Multipliable7f's value with all the fraction digits (including trailing zeros)
    
    See Also:
    
    getValue(), Decimal.toString()

Class Multipliable7f

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Multipliable7f

Method Detail

getValue

square

by

by

by

by

by

by

by

by

by

by

by

by

by

by

by

by

by

by

by

by

by

by

by

hashCode

equals

toString