Implements the absolute value operator, performed within the mathematical
context mc, and returns a positive BigDecimal value equal in magnitude
to this value (apart from rounding specified by the MathContext).
The ArciMath BigDecimal class contains immutable arbitrary-precision signed decimal
numbers supporting operations for both fixed and floating point arithmetic,
comparison, scale manipulation, comparison, hashing, and format conversion.
Constructs a be.arci.math.BigDecimal object from a java.math.BigDecimal
as though the parameter had been represented as a String
(using its toString() method) and the be.arci.math.BigDecimal(java.lang.String)
constructor had then been used.
Convenience method to construct a localized BigDecimalFormat, based on e.g.
one of the standard DecimalFormat's for a given locale, obtained using the
factory methods on NumberFormat such as getInstance or getCurrencyInstance.
Converts this BigDecimal to a Java byte value (an 8-bit signed
integer); if the BigDecimal has a non-zero decimal part or is out
of range for a Java byte value then an ArithmeticException is thrown.
Copyright notice for ArciMath BigDecimal; this String also can serve to distinguish
the evaluation version and the producion version of ArciMath BigDecimal.
The default context, which is digits=9, form=SCIENTIFIC,
lostDigits=false, roundingMode=ROUND_HALF_UP, settings
well suited for general-purpose arithmetic.
Implements the division (/) operator, using fixed point
arithmetic, and returns a BigDecimal quotient whose scale will
be the same as the scale of this BigDecimal (the dividend) if
this were formatted without exponential notation.
Implements the division (/) operator, using fixed
point arithmetic and a rounding mode, and returns a BigDecimal
quotient whose scale will be the same as the scale of this
BigDecimal (the dividend) if this were formatted without
exponential notation.
Floating point notation (with engineering exponential format,
having one to three digits before any decimal point, such that the
power of ten in an eventual exponent is a multiple of 3).
Convenience method which formats the decimal String representation of a double
value to a String according to the pattern represented by this BigDecimalFormat.
Convenience method which formats the toString() representation of a Number
value to a String according to the pattern represented by this BigDecimalFormat.
Returns a clone of the decimal format symbols used by this BigDecimalFormat;
changes to the returned object thus have no influence on the BigDecimalFormat.
Get the rounding mode used in rounding numbers to the maximum decimal places and to
multiples of the smallest module, and in dividing parsed numbers by the multiplier
property.
Converts this BigDecimal to a Java int value; if the BigDecimal has a non-zero
decimal part or is out of the possible range for a Java int (32-bit signed
integer) result then an ArithmeticException is thrown.
Converts this BigDecimal to a Java long value; if the BigDecimal has a non-zero
decimal part or is out of the possible range for a Java long (64-bit signed
integer) then an ArithmeticException is thrown.
The immutable class MathContext contains the arithmetic
settings understood by the operator methods of the
BigDecimal class (and potentially other classes).
Implements the multiplication (*) operator, using fixed
point arithmetic, and returns a BigDecimal product with scale equal
to the sum of the scales of the operands, if they were formatted
without exponential notation.
Implements the negation operator (unary -), using fixed point
arithmetic, and returns a BigDecimal whose value is (-this),
and whose scale is this.scale().
Parsing strictness constant for getParsingStrictness() and
setParsingStrictness(), allowing only the exponent symbol
set for the BigDecimalFormat as exponent symbol in a number String.
Parsing strictness constant for getParsingStrictness() and
setParsingStrictness(), requiring digit grouping if the grouping
size set for the BigDecimalFormat is not zero.
Parsing strictness constant for getParsingStrictness() and
setParsingStrictness(), accepting only the padding character set for the
BigDecimalFormat as padding in a number String.
Parsing strictness constant for getParsingStrictness() and
setParsingStrictness(), requiring any padding in a number String to
occur at the padding position set for the BigDecimalFormat.
Parsing strictness constant for getParsingStrictness() and
setParsingStrictness(), requiring a match with either
the positive or the negative prefix when parsing a number String.
Parsing strictness constant for getParsingStrictness() and
setParsingStrictness(), allowing only the grouping separator
and the decimal (or monetary decimal for currency formats) separator characters
set for the BigDecimalFormat's java.text.DecimalFormatSymbols as separator
characters in a number String.
Parsing strictness constant for getParsingStrictness() and
setParsingStrictness(), allowing only the
plus sign and minus sign set for the BigDecimalFormat or it's
java.text.DecimalFormatSymbols as sign character in a number String.
Parsing strictness constant for getParsingStrictness() and
setParsingStrictness(), requiring a match with either
the positive or the negative suffix when parsing a number String.
Implements the plus operator (unary +), using fixed point
arithmetic, and returns a BigDecimal whose value is (+this),
and whose scale is this.scale().
Implements the plus operator (unary +), within the context
specified by mc; this method is useful for rounding or otherwise applying a
context to a decimal value.
Sets the maximum number of digits to format in the decimal fraction of a
number; this value has no effect on parsing. maximumDecimalPlaces must
be >= minimumDecimalPlaces.
Sets the maximum number of digits to format in the integer portion of a
number; this value has no effect on parsing. maximumIntegerDigits must
be >= minimumIntegerDigits.
Sets the minimum number of digits to format in the decimal fraction of a
number; this value has no effect on parsing. minimumDecimalPlaces must
be <= maximumDecimalPlaces.
Sets the minimum number of digits to format in the integer portion of a
number; this value has no effect on parsing. minimumIntegerDigits must
be <= maximumIntegerDigits.
Deprecated.This method is retained for compatibility with DecimalFormat only; we advise
to obtain an integer number from the fully parsed ArciMath BigDecimal result, e.g. by the
operation bdResult.setScale(0, roundingMode)
Get the rounding mode used in rounding numbers to the maximum decimal places and to
multiples of the smallest module, and in dividing parsed numbers by the multiplier
property.
Returns a BigDecimal whose scale is the specified value, and whose
unscaled value is determined by multiplying or dividing this
BigDecimal's unscaled value by the appropriate power of ten to maintain
its overall value.
Converts this BigDecimal to a Java short value; if the BigDecimal has a non-zero
decimal part or is out of the possible range for a Java short (16-bit signed
integer) result then an ArithmeticException is thrown.
Implements the subtraction (-) operator, using fixed point
arithmetic, and returns a BigDecimal difference whose scale is
max(this.scale(), val.scale()).
Returns a java.math.BigInteger whose value is the unscaled value of this
BigDecimal; that is, the number is expressed as a plain number, any
decimal point is then removed (retaining the digits of any decimal part),
and the result is then converted to a java.math.BigInteger.