Java.math.BigDecimal Class

Advertisements


Introduction

The java.math.BigDecimal class provides operations for arithmetic, scale manipulation, rounding, comparison, hashing, and format conversion.

The toString() method provides a canonical representation of a BigDecimal. It gives the user complete control over rounding behavior.

Two types of operations are provided for manipulating the scale of a BigDecimal:
  • scaling/rounding operations
  • decimal point motion operations.

This class and its iterator implement all of the optional methods of the Comparable interfaces.

Class declaration

Following is the declaration for java.math.BigDecimal class:

public class BigDecimal
    extends Number
        implements Comparable<BigDecimal>

Field

Following are the fields for java.math.BigDecimal class:

  • static BigDecimal ONE -- The value 1, with a scale of 0.

  • static int ROUND_CEILING -- Rounding mode to round towards positive infinity.

  • static int ROUND_DOWN -- Rounding mode to round towards zero.

  • static int ROUND_FLOOR -- Rounding mode to round towards negative infinity.

  • static int ROUND_HALF_DOWN -- Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in which case round down.

  • static int ROUND_HALF_EVEN -- Rounding mode to round towards the "nearest neighbor" unless both neighbors are equidistant, in which case, round towards the even neighbor.

  • static int ROUND_HALF_UP --Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in which case round up.

  • static int ROUND_UNNECESSARY --Rounding mode to assert that the requested operation has an exact result, hence no rounding is necessary.

  • static int ROUND_UP --Rounding mode to round away from zero.

  • static BigDecimal TEN --The value 10, with a scale of 0.

  • static BigDecimal ZERO --The value 0, with a scale of 0.

Class constructors

S.N.Constructor & Description
1BigDecimal(BigInteger val)
This constructor is used to translates a BigInteger into a BigDecimal.
2BigDecimal(BigInteger unscaledVal, int scale)
This constructor is used to translate a BigInteger unscaled value and an int scale into a BigDecimal.
3BigDecimal(BigInteger unscaledVal, int scale, MathContext mc)
This constructor is used to translate a BigInteger unscaled value and an int scale into a BigDecimal, with rounding according to the context settings.
4BigDecimal(BigInteger val, MathContext mc)
This constructor is used to translate a BigInteger into a BigDecimal rounding according to the context settings.
5BigDecimal(char[ ] in)
This constructor is used to translate a character array representation of a BigDecimal into a BigDecimal, accepting the same sequence of characters as the BigDecimal(String) constructor.
6BigDecimal(char[ ] in, int offset, int len)
This constructor is used to translate a character array representation of a BigDecimal into a BigDecimal, accepting the same sequence of characters as the BigDecimal(String) constructor, while allowing a sub-array to be specified.
7BigDecimal(char[ ] in, int offset, int len, MathContext mc)
This constructor is used to translate a character array representation of a BigDecimal into a BigDecimal, accepting the same sequence of characters as the BigDecimal(String) constructor, while allowing a sub-array to be specified and with rounding according to the context settings.
8BigDecimal(char[ ] in, MathContext mc)
This constructor is used to translate a character array representation of a BigDecimal into a BigDecimal, accepting the same sequence of characters as the BigDecimal(String) constructor and with rounding according to the context settings.
9BigDecimal(double val)
This constructor is used to translates a double into a BigDecimal which is the exact decimal representation of the double's binary floating-point value.
10BigDecimal(double val, MathContext mc)
This constructor is used to translates a double into a BigDecimal, with rounding according to the context settings.
11BigDecimal(int val)
This constructor is used to translates an int into a BigDecimal.
12BigDecimal(int val, MathContext mc)
This constructor is used to translates an int into a BigDecimal, with rounding according to the context settings.
13BigDecimal(long val)
This constructor is used to translate a long into a BigDecimal.
14BigDecimal(long val, MathContext mc)
This constructor is used to translates a BigInteger into a BigDecimal.
15BigDecimal(String val)
This constructor is used to the string representation of a BigDecimal into a BigDecimal.
16BigDecimal(String val, MathContext mc)
This constructor is used to translates the string representation of a BigDecimal into a BigDecimal, accepting the same strings as the BigDecimal(String) constructor, with rounding according to the context settings.

Class methods

S.N.Method & Description
1BigDecimal abs()
This method returns a BigDecimal whose value is the absolute value of this BigDecimal, and whose scale is this.scale().
2BigDecimal abs(MathContext mc)
This method returns a BigDecimal whose value is the absolute value of this BigDecimal, with rounding according to the context settings.
3BigDecimal add(BigDecimal augend)
This method returns a BigDecimal whose value is (this + augend), and whose scale is max(this.scale(), augend.scale()).
4BigDecimal add(BigDecimal augend, MathContext mc)
This method returns a BigDecimal whose value is (this + augend), with rounding according to the context settings.
5byte byteValueExact()
This method converts the BigDecimal to a byte, checking for lost information.
6int compareTo(BigDecimal val)
This method compares the BigDecimal with the specified BigDecimal.
7BigDecimal divide(BigDecimal divisor)
This method returns a BigDecimal whose value is (this / divisor), and whose preferred scale is (this.scale() - divisor.scale()); if the exact quotient cannot be represented (because it has a non-terminating decimal expansion) an ArithmeticException is thrown.
8BigDecimal divide(BigDecimal divisor, int roundingMode)
This method returns a BigDecimal whose value is (this / divisor), and whose scale is this.scale().
9BigDecimal divide(BigDecimal divisor, int scale, int roundingMode)
This method returns a BigDecimal whose value is (this / divisor), and whose scale is as specified.
10BigDecimal divide(BigDecimal divisor, int scale, RoundingMode roundingMode)
This method returns a BigDecimal whose value is (this / divisor), and whose scale is as specified.
11BigDecimal divide(BigDecimal divisor, MathContext mc)
This method returns a BigDecimal whose value is (this / divisor), with rounding according to the context settings.
12BigDecimal divide(BigDecimal divisor, RoundingMode roundingMode)
This method returns a BigDecimal whose value is (this / divisor), and whose scale is this.scale().
13BigDecimal[ ] divideAndRemainder(BigDecimal divisor)
This method returns a two-element BigDecimal array containing the result of divideToIntegralValue followed by the result of remainder on the two operands.
14BigDecimal[ ] divideAndRemainder(BigDecimal divisor, MathContext mc)
This method returns a two-element BigDecimal array containing the result of divideToIntegralValue followed by the result of remainder on the two operands calculated with rounding according to the context settings.
15BigDecimal divideToIntegralValue(BigDecimal divisor)
This method returns a BigDecimal whose value is the integer part of the quotient (this / divisor) rounded down.
16BigDecimal divideToIntegralValue(BigDecimal divisor, MathContext mc)
This method returns a BigDecimal whose value is the integer part of (this / divisor).
17double doubleValue()
This method converts the BigDecimal to a double.
18boolean equals(Object x)
This method compares the BigDecimal with the specified Object for equality.
19float floatValue()
This method converts the BigDecimal to a float.
20int hashCode()
This method returns the hash code for this BigDecimal.
21int intValue()
This method converts the BigDecimal to an int.
22int intValueExact()
This method converts the BigDecimal to an int, checking for lost information.
23long longValue()
This method converts the BigDecimal to a long.
24long longValueExact()
This method converts the BigDecimal to a long, checking for lost information.
25BigDecimal max(BigDecimal val)
This method returns the maximum of this BigDecimal and val.
26BigDecimal min(BigDecimal val)
This method returns the minimum of this BigDecimal and val.
27BigDecimal movePointLeft(int n)
This method returns a BigDecimal which is equivalent to this one with the decimal point moved n places to the left.
28BigDecimal movePointRight(int n)
This method returns a BigDecimal which is equivalent to this one with the decimal point moved n places to the right.
29BigDecimal multiply(BigDecimal multiplicand)
This method returns a BigDecimal whose value is (this × multiplicand), and whose scale is (this.scale() + multiplicand.scale()).
30BigDecimal multiply(BigDecimal multiplicand, MathContext mc)
This method returns a BigDecimal whose value is (this × multiplicand), with rounding according to the context settings.
31BigDecimal negate()
This method returns a BigDecimal whose value is (+this), and whose scale is this.scale().
32BigDecimal negate(MathContext mc)
This method returns a BigDecimal whose value is (-this), with rounding according to the context settings.
33BigDecimal plus()
This method returns a BigDecimal whose value is (+this), and whose scale is this.scale().
34BigDecimal plus(MathContext mc)
This method returns a BigDecimal whose value is (+this), with rounding according to the context settings.
35BigDecimal pow(int n)
This method returns a BigDecimal whose value is (thisn), The power is computed exactly, to unlimited precision.
36BigDecimal pow(int n, MathContext mc)
This method returns a BigDecimal whose value is (thisn).
37int precision()
This method returns the precision of this BigDecimal.
38BigDecimal remainder(BigDecimal divisor)
This method converts this BigDecimal to a byte, checking for lost information.
39BigDecimal remainder(BigDecimal divisor, MathContext mc)
This method returns a BigDecimal whose value is (this % divisor), with rounding according to the context settings.
40BigDecimal round(MathContext mc)
This method returns a BigDecimal rounded according to the MathContext settings.
41int scale()
This method returns the scale of this BigDecimal.
42BigDecimal scaleByPowerOfTen(int n)
This method returns a BigDecimal whose numerical value is equal to (this * 10n).
43BigDecimal setScale(int newScale)
This method returns a BigDecimal whose scale is the specified value, and whose value is numerically equal to this BigDecimal's.
44BigDecimal setScale(int newScale, int roundingMode)
This method 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.
45BigDecimal setScale(int newScale, RoundingMode roundingMode)
This method 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.
46short shortValueExact()
This method converts the BigDecimal to a short, checking for lost information.
47int signum()
This method returns the signum function of this BigDecimal.
48BigDecimal stripTrailingZeros()
This method returns a BigDecimal which is numerically equal to this one but with any trailing zeros removed from the representation.
49BigDecimal subtract(BigDecimal subtrahend)
This method returns a BigDecimal whose value is (this - subtrahend), and whose scale is max(this.scale(), subtrahend.scale()).
50BigDecimal subtract(BigDecimal subtrahend, MathContext mc)
This method returns a BigDecimal whose value is (this - subtrahend), with rounding according to the context settings.
51BigInteger toBigInteger()
This method converts the BigDecimal to a BigInteger.
52BigInteger toBigIntegerExact()
This method converts the BigDecimal to a BigInteger, checking for lost information.
53String toEngineeringString()
This method returns a string representation of this BigDecimal, using engineering notation if an exponent is needed.
54String toPlainString()
This method returns a string representation of this BigDecimal without an exponent field.
55String toString()
This method returns the string representation of this BigDecimal, using scientific notation if an exponent is needed.
56BigDecimal ulp()
This method returns the size of an ulp, a unit in the last place, of this BigDecimal.
57BigInteger unscaledValue()
This method returns a BigInteger whose value is the unscaled value of this BigDecimal.
58static BigDecimal valueOf(double val)
This method translates a double into a BigDecimal, using the double's canonical string representation provided by the Double.toString(double) method.
59static BigDecimal valueOf(long val)
This method translates a long value into a BigDecimal with a scale of zero.
60static BigDecimal valueOf(long unscaledVal, int scale)
This method translates a long unscaled value and an int scale into a BigDecimal.



Advertisements
Advertisements