public final class MutableDecimal6f extends AbstractMutableDecimal<Scale6f,MutableDecimal6f> implements Cloneable
All methods for this class throw NullPointerException
when passed a
null
object reference for any input parameter.
Constructor and Description |
---|
MutableDecimal6f()
Constructs a new
MutableDecimal6f with value zero. |
MutableDecimal6f(BigDecimal value)
Constructs a
MutableDecimal6f whose value is calculated by
rounding the specified BigDecimal argument to scale 6 using
HALF_UP rounding. |
MutableDecimal6f(BigInteger value)
Constructs a
MutableDecimal6f whose value is numerically equal to
that of the specified BigInteger value. |
MutableDecimal6f(Decimal<?> value)
|
MutableDecimal6f(Decimal6f value)
Constructs a
MutableDecimal6f whose value is numerically equal to
that of the specified Decimal6f value. |
MutableDecimal6f(double value)
Constructs a
MutableDecimal6f whose value is calculated by
rounding the specified double argument to scale 6 using
HALF_UP rounding. |
MutableDecimal6f(long value)
Constructs a
MutableDecimal6f whose value is numerically equal
to that of the specified long value. |
MutableDecimal6f(String value)
Translates the string representation of a
Decimal into a
MutableDecimal6f . |
Modifier and Type | Method and Description |
---|---|
static MutableDecimal6f |
billion()
Returns a new
MutableDecimal6f whose value is equal to one billion. |
MutableDecimal6f |
clone()
Returns a clone of this mutable Decimal numerically identical to this
value.
|
protected MutableDecimal6f |
create(long unscaled)
Returns a new
Decimal whose value is
(unscaled × 10-scale). |
protected MutableDecimal6f[] |
createArray(int length)
Returns a new
Decimal array of the specified length . |
static MutableDecimal6f |
eight()
Returns a new
MutableDecimal6f whose value is equal to eight. |
static MutableDecimal6f |
five()
Returns a new
MutableDecimal6f whose value is equal to five. |
static MutableDecimal6f |
four()
Returns a new
MutableDecimal6f whose value is equal to four. |
protected DecimalArithmetic |
getDefaultArithmetic()
Returns the default arithmetic performing unchecked operations with
rounding mode
HALF_UP . |
protected DecimalArithmetic |
getDefaultCheckedArithmetic()
Returns the default arithmetic performing checked operations with
rounding mode
HALF_UP . |
Factory6f |
getFactory()
Returns the factory that can be used to create other Decimal values of the same scale as
this Decimal. |
protected DecimalArithmetic |
getRoundingDownArithmetic()
Returns the arithmetic performing unchecked operations with rounding mode
DOWN . |
protected DecimalArithmetic |
getRoundingFloorArithmetic()
Returns the arithmetic performing unchecked operations with rounding mode
FLOOR . |
protected DecimalArithmetic |
getRoundingHalfEvenArithmetic()
Returns the arithmetic performing unchecked operations with rounding mode
HALF_EVEN . |
protected DecimalArithmetic |
getRoundingUnnecessaryArithmetic()
Returns the arithmetic performing unchecked operations with rounding mode
UNNECESSARY . |
int |
getScale()
Returns the scale associated with this Decimal.
|
Scale6f |
getScaleMetrics()
Returns the metrics associated with the scale of this Decimal.
|
static MutableDecimal6f |
half()
Returns a new
MutableDecimal6f whose value is equal to one half. |
static MutableDecimal6f |
hundred()
Returns a new
MutableDecimal6f whose value is equal to one hundred. |
static MutableDecimal6f |
hundredth()
Returns a new
MutableDecimal6f whose value is equal to one hundredth. |
static MutableDecimal6f |
million()
Returns a new
MutableDecimal6f whose value is equal to one million. |
static MutableDecimal6f |
millionth()
Returns a new
MutableDecimal6f whose value is equal to one millionth. |
static MutableDecimal6f |
minusOne()
Returns a new
MutableDecimal6f whose value is equal to minus one. |
Multipliable6f |
multiplyExact()
Returns this
Decimal as a multipliable factor for exact
typed exact multiplication. |
static MutableDecimal6f |
nine()
Returns a new
MutableDecimal6f whose value is equal to nine. |
static MutableDecimal6f |
one()
Returns a new
MutableDecimal6f whose value is equal to one. |
protected MutableDecimal6f |
self()
Returns
this decimal value as concrete implementation subtype. |
static MutableDecimal6f |
seven()
Returns a new
MutableDecimal6f whose value is equal to seven. |
static MutableDecimal6f |
six()
Returns a new
MutableDecimal6f whose value is equal to six. |
static MutableDecimal6f |
ten()
Returns a new
MutableDecimal6f whose value is equal to ten. |
static MutableDecimal6f |
tenth()
Returns a new
MutableDecimal6f whose value is equal to one tenth. |
static MutableDecimal6f |
thousand()
Returns a new
MutableDecimal6f whose value is equal to one thousand. |
static MutableDecimal6f |
thousandth()
Returns a new
MutableDecimal6f whose value is equal to one thousandth. |
static MutableDecimal6f |
three()
Returns a new
MutableDecimal6f whose value is equal to three. |
Decimal6f |
toImmutableDecimal()
If this
Decimal value is already an ImmutableDecimal it is simply returned. |
MutableDecimal6f |
toMutableDecimal()
If this
Decimal value is already a MutableDecimal it is simply returned. |
static MutableDecimal6f |
trillion()
Returns a new
MutableDecimal6f whose value is equal to one trillion. |
static MutableDecimal6f |
two()
Returns a new
MutableDecimal6f whose value is equal to two. |
static MutableDecimal6f |
ulp()
Returns a new
MutableDecimal6f whose value is equal to one ULP. |
static MutableDecimal6f |
unscaled(long unscaledValue)
Returns a new
MutableDecimal6f whose value is equal to
unscaledValue * 10-6 . |
static MutableDecimal6f |
zero()
Returns a new
MutableDecimal6f whose value is equal to zero. |
createOrAssign, max, min, multiplyExact, scale, scale, scale, scale, set, set, set, set, set, set, set, set, set, set, set, set, setMinusOne, setOne, setUlp, setUnscaled, setUnscaled, setUnscaled, setZero, unscaledValue
abs, abs, add, add, add, add, add, add, add, add, addSquared, addSquared, addSquared, addUnscaled, addUnscaled, addUnscaled, addUnscaled, addUnscaled, avg, avg, byteValueExact, compareTo, compareToNumerically, divide, divide, divide, divide, divide, divide, divide, divide, divideAndRemainder, divideAndRemainder, divideBy, divideBy, divideBy, divideByPowerOfTen, divideByPowerOfTen, divideByPowerOfTen, divideExact, divideToIntegralValue, divideToIntegralValue, divideToLongValue, divideToLongValue, divideTruncate, divideUnscaled, divideUnscaled, divideUnscaled, divideUnscaled, divideUnscaled, divideUnscaled, doubleValue, doubleValue, equals, floatValue, floatValue, fractionalPart, getArithmeticFor, getArithmeticFor, getArithmeticFor, getCheckedArithmeticFor, hashCode, integralPart, intValue, intValueExact, invert, invert, invert, isBetweenZeroAndMinusOne, isBetweenZeroAndOne, isEqualTo, isEqualToNumerically, isGreaterThan, isGreaterThanOrEqualTo, isIntegral, isIntegralPartZero, isLessThan, isLessThanOrEqualTo, isMinusOne, isNegative, isNonNegative, isNonPositive, isOne, isPositive, isUlp, isZero, longValue, longValue, longValueExact, max, max, min, min, multiply, multiply, multiply, multiply, multiply, multiply, multiply, multiplyBy, multiplyBy, multiplyBy, multiplyByPowerOfTen, multiplyByPowerOfTen, multiplyByPowerOfTen, multiplyUnscaled, multiplyUnscaled, multiplyUnscaled, multiplyUnscaled, multiplyUnscaled, multiplyUnscaled, negate, negate, pow, pow, pow, remainder, round, round, round, shiftLeft, shiftLeft, shiftLeft, shiftRight, shiftRight, shiftRight, shortValueExact, signum, sqrt, sqrt, square, square, square, subtract, subtract, subtract, subtract, subtract, subtract, subtract, subtract, subtractSquared, subtractSquared, subtractSquared, subtractUnscaled, subtractUnscaled, subtractUnscaled, subtractUnscaled, subtractUnscaled, toBigDecimal, toBigDecimal, toBigInteger, toBigInteger, toBigIntegerExact, toString
byteValue, shortValue
finalize, getClass, notify, notifyAll, wait, wait, wait
abs, abs, add, add, add, add, add, add, add, add, addSquared, addSquared, addSquared, addUnscaled, addUnscaled, addUnscaled, addUnscaled, addUnscaled, avg, avg, divide, divide, divide, divide, divide, divide, divide, divide, divideAndRemainder, divideAndRemainder, divideBy, divideBy, divideBy, divideByPowerOfTen, divideByPowerOfTen, divideByPowerOfTen, divideExact, divideToIntegralValue, divideToIntegralValue, divideTruncate, divideUnscaled, divideUnscaled, divideUnscaled, divideUnscaled, divideUnscaled, divideUnscaled, fractionalPart, integralPart, invert, invert, invert, multiply, multiply, multiply, multiply, multiply, multiply, multiply, multiplyBy, multiplyBy, multiplyBy, multiplyByPowerOfTen, multiplyByPowerOfTen, multiplyByPowerOfTen, multiplyUnscaled, multiplyUnscaled, multiplyUnscaled, multiplyUnscaled, multiplyUnscaled, multiplyUnscaled, negate, negate, pow, pow, pow, remainder, round, round, round, shiftLeft, shiftLeft, shiftLeft, shiftRight, shiftRight, shiftRight, sqrt, sqrt, square, square, square, subtract, subtract, subtract, subtract, subtract, subtract, subtract, subtract, subtractSquared, subtractSquared, subtractSquared, subtractUnscaled, subtractUnscaled, subtractUnscaled, subtractUnscaled, subtractUnscaled
byteValue, byteValueExact, compareTo, compareToNumerically, divideToLongValue, divideToLongValue, doubleValue, doubleValue, equals, floatValue, floatValue, hashCode, intValue, intValueExact, isBetweenZeroAndMinusOne, isBetweenZeroAndOne, isEqualTo, isEqualToNumerically, isGreaterThan, isGreaterThanOrEqualTo, isIntegral, isIntegralPartZero, isLessThan, isLessThanOrEqualTo, isMinusOne, isNegative, isNonNegative, isNonPositive, isOne, isPositive, isUlp, isZero, longValue, longValue, longValueExact, max, min, shortValue, shortValueExact, signum, toBigDecimal, toBigDecimal, toBigInteger, toBigInteger, toBigIntegerExact, toString
public MutableDecimal6f()
MutableDecimal6f
with value zero.zero()
public MutableDecimal6f(String value)
Decimal
into a
MutableDecimal6f
. The string representation consists
of an optional sign, '+'
or '-'
, followed by a sequence
of zero or more decimal digits ("the integer"), optionally followed by a
fraction.
The fraction consists of a decimal point followed by zero or more decimal
digits. The string must contain at least one digit in either the integer
or the fraction. If the fraction contains more than 6 digits, the
value is rounded using HALF_UP
rounding. An
exception is thrown if the value is too large to be represented as a
MutableDecimal6f
.
value
- String value to convert into a MutableDecimal6f
NumberFormatException
- if value
does not represent a valid Decimal
or if the value is too large to be represented as a
MutableDecimal6f
AbstractMutableDecimal.set(String, RoundingMode)
public MutableDecimal6f(long value)
MutableDecimal6f
whose value is numerically equal
to that of the specified long
value. An exception is thrown if the
specified value is too large to be represented as a MutableDecimal6f
.value
- long value to convert into a MutableDecimal6f
IllegalArgumentException
- if value
is too large to be represented as a
MutableDecimal6f
public MutableDecimal6f(double value)
MutableDecimal6f
whose value is calculated by
rounding the specified double
argument to scale 6 using
HALF_UP
rounding. An exception is thrown if the
specified value is too large to be represented as a MutableDecimal6f
.value
- double value to convert into a MutableDecimal6f
IllegalArgumentException
- if value
is NaN or infinite or if the magnitude is too large
for the double to be represented as a MutableDecimal6f
AbstractMutableDecimal.set(double, RoundingMode)
,
AbstractMutableDecimal.set(float)
,
AbstractMutableDecimal.set(float, RoundingMode)
public MutableDecimal6f(BigInteger value)
MutableDecimal6f
whose value is numerically equal to
that of the specified BigInteger
value. An exception is thrown if the
specified value is too large to be represented as a MutableDecimal6f
.value
- BigInteger
value to convert into a MutableDecimal6f
IllegalArgumentException
- if value
is too large to be represented as a MutableDecimal6f
public MutableDecimal6f(BigDecimal value)
MutableDecimal6f
whose value is calculated by
rounding the specified BigDecimal
argument to scale 6 using
HALF_UP
rounding. An exception is thrown if the
specified value is too large to be represented as a MutableDecimal6f
.value
- BigDecimal
value to convert into a MutableDecimal6f
IllegalArgumentException
- if value
is too large to be represented as a MutableDecimal6f
AbstractMutableDecimal.set(BigDecimal, RoundingMode)
public MutableDecimal6f(Decimal6f value)
MutableDecimal6f
whose value is numerically equal to
that of the specified Decimal6f
value.value
- Decimal6f
value to convert into a MutableDecimal6f
public MutableDecimal6f(Decimal<?> value)
MutableDecimal6f
whose value is calculated by
rounding the specified Decimal
argument to scale 6 using
HALF_UP
rounding. An exception is thrown if
the specified value is too large to be represented as a MutableDecimal6f
.value
- Decimal value to convert into a MutableDecimal6f
IllegalArgumentException
- if value
is too large to be represented as a MutableDecimal6f
AbstractMutableDecimal.set(Decimal, RoundingMode)
protected final MutableDecimal6f create(long unscaled)
AbstractDecimal
Decimal
whose value is
(unscaled × 10-scale).create
in class AbstractDecimal<Scale6f,MutableDecimal6f>
unscaled
- unscaled value to be returned as a Decimal
protected final MutableDecimal6f[] createArray(int length)
AbstractDecimal
Decimal
array of the specified length
.createArray
in class AbstractDecimal<Scale6f,MutableDecimal6f>
length
- the length of the array to returnnew D[length]
protected final MutableDecimal6f self()
AbstractDecimal
this
decimal value as concrete implementation subtype.self
in class AbstractDecimal<Scale6f,MutableDecimal6f>
this
public final Scale6f getScaleMetrics()
Decimal
long
value underlying this Decimal
.getScaleMetrics
in interface Decimal<Scale6f>
ScaleMetrics.getScale()
,
ScaleMetrics.getScaleFactor()
public final int getScale()
Decimal
long
value underlying this Decimal
.
If the scale is f
then the value represented by a Decimal
instance is
(unscaledValue × 10-f).
This method is a shortcut for getScaleMetrics().getScale()
.
getScale
in interface Decimal<Scale6f>
Decimal.getScaleMetrics()
,
ScaleMetrics.getScale()
,
Decimal.unscaledValue()
public Factory6f getFactory()
Decimal
this
Decimal.getFactory
in interface Decimal<Scale6f>
protected DecimalArithmetic getDefaultArithmetic()
AbstractDecimal
HALF_UP
.getDefaultArithmetic
in class AbstractDecimal<Scale6f,MutableDecimal6f>
HALF_UP
rounding and UNCHECKED
overflow
modeprotected DecimalArithmetic getDefaultCheckedArithmetic()
AbstractDecimal
HALF_UP
.getDefaultCheckedArithmetic
in class AbstractDecimal<Scale6f,MutableDecimal6f>
HALF_UP
rounding and CHECKED
overflow modeprotected DecimalArithmetic getRoundingDownArithmetic()
AbstractDecimal
DOWN
.getRoundingDownArithmetic
in class AbstractDecimal<Scale6f,MutableDecimal6f>
DOWN
rounding and
UNCHECKED
overflow modeprotected DecimalArithmetic getRoundingFloorArithmetic()
AbstractDecimal
FLOOR
.getRoundingFloorArithmetic
in class AbstractDecimal<Scale6f,MutableDecimal6f>
FLOOR
rounding and
UNCHECKED
overflow modeprotected DecimalArithmetic getRoundingHalfEvenArithmetic()
AbstractDecimal
HALF_EVEN
.getRoundingHalfEvenArithmetic
in class AbstractDecimal<Scale6f,MutableDecimal6f>
HALF_UP
rounding and
UNCHECKED
overflow modeprotected DecimalArithmetic getRoundingUnnecessaryArithmetic()
AbstractDecimal
UNNECESSARY
.getRoundingUnnecessaryArithmetic
in class AbstractDecimal<Scale6f,MutableDecimal6f>
UNNECESSARY
rounding and UNCHECKED
overflow
modepublic MutableDecimal6f clone()
MutableDecimal
clone
in interface MutableDecimal<Scale6f>
clone
in class AbstractMutableDecimal<Scale6f,MutableDecimal6f>
public static MutableDecimal6f unscaled(long unscaledValue)
MutableDecimal6f
whose value is equal to
unscaledValue * 10-6
.unscaledValue
- the unscaled decimal value to convertMutableDecimal6f
value initialised with unscaledValue * 10-6
AbstractMutableDecimal.setUnscaled(long, int)
,
AbstractMutableDecimal.setUnscaled(long, int, RoundingMode)
public static MutableDecimal6f zero()
MutableDecimal6f
whose value is equal to zero.MutableDecimal6f
value initialised with 0.public static MutableDecimal6f ulp()
MutableDecimal6f
whose value is equal to one ULP.MutableDecimal6f
value initialised with 10-6.public static MutableDecimal6f one()
MutableDecimal6f
whose value is equal to one.MutableDecimal6f
value initialised with 1.public static MutableDecimal6f two()
MutableDecimal6f
whose value is equal to two.MutableDecimal6f
value initialised with 2.public static MutableDecimal6f three()
MutableDecimal6f
whose value is equal to three.MutableDecimal6f
value initialised with 3.public static MutableDecimal6f four()
MutableDecimal6f
whose value is equal to four.MutableDecimal6f
value initialised with 4.public static MutableDecimal6f five()
MutableDecimal6f
whose value is equal to five.MutableDecimal6f
value initialised with 5.public static MutableDecimal6f six()
MutableDecimal6f
whose value is equal to six.MutableDecimal6f
value initialised with 6.public static MutableDecimal6f seven()
MutableDecimal6f
whose value is equal to seven.MutableDecimal6f
value initialised with 7.public static MutableDecimal6f eight()
MutableDecimal6f
whose value is equal to eight.MutableDecimal6f
value initialised with 8.public static MutableDecimal6f nine()
MutableDecimal6f
whose value is equal to nine.MutableDecimal6f
value initialised with 9.public static MutableDecimal6f ten()
MutableDecimal6f
whose value is equal to ten.MutableDecimal6f
value initialised with 10.public static MutableDecimal6f hundred()
MutableDecimal6f
whose value is equal to one hundred.MutableDecimal6f
value initialised with 100.public static MutableDecimal6f thousand()
MutableDecimal6f
whose value is equal to one thousand.MutableDecimal6f
value initialised with 1000.public static MutableDecimal6f million()
MutableDecimal6f
whose value is equal to one million.MutableDecimal6f
value initialised with 106.public static MutableDecimal6f billion()
MutableDecimal6f
whose value is equal to one billion.MutableDecimal6f
value initialised with 109.public static MutableDecimal6f trillion()
MutableDecimal6f
whose value is equal to one trillion.MutableDecimal6f
value initialised with 1012.public static MutableDecimal6f minusOne()
MutableDecimal6f
whose value is equal to minus one.MutableDecimal6f
value initialised with -1.public static MutableDecimal6f half()
MutableDecimal6f
whose value is equal to one half.MutableDecimal6f
value initialised with 0.5.public static MutableDecimal6f tenth()
MutableDecimal6f
whose value is equal to one tenth.MutableDecimal6f
value initialised with 0.1.public static MutableDecimal6f hundredth()
MutableDecimal6f
whose value is equal to one hundredth.MutableDecimal6f
value initialised with 0.01.public static MutableDecimal6f thousandth()
MutableDecimal6f
whose value is equal to one thousandth.MutableDecimal6f
value initialised with 0.001.public static MutableDecimal6f millionth()
MutableDecimal6f
whose value is equal to one millionth.MutableDecimal6f
value initialised with 10-6.public Multipliable6f multiplyExact()
Decimal
as a multipliable factor for exact
typed exact multiplication. The second factor is passed to one of
the by(..)
methods of the returned multiplier. The scale of
the result is the sum of the scales of this
Decimal and the
second factor passed to the by(..)
method.
The method is similar to multiplyExact(Decimal)
but the result
is retrieved in exact typed form with the correct result scale.
For instance one can write:
Decimal8f product = this.multiplyExact().by(Decimal2f.FIVE);
public Decimal6f toImmutableDecimal()
Decimal
Decimal
value is already an ImmutableDecimal
it is simply returned. Otherwise a new
immutable value with the same scale and numerical value as this
Decimal is created and returned.toImmutableDecimal
in interface Decimal<Scale6f>
this
if immutable and a new ImmutableDecimal
with the same scale and value as
this
Decimal otherwisepublic MutableDecimal6f toMutableDecimal()
Decimal
Decimal
value is already a MutableDecimal
it is simply returned. Otherwise a new mutable
value with the same scale and numerical value as this
Decimal is created and returned.toMutableDecimal
in interface Decimal<Scale6f>
this
if mutable and a new MutableDecimal
with the same scale and value as this
Decimal otherwise