BigDecimal negate() Function in Java
- The java.math.BigDecimal.negate() method returns a BigDecimal whose value is the negated value of the BigDecimal with which it is used.
Syntax:
public BigDecimal negate()
Parameters: The method does not take any parameters .
Return Value: This method returns the negative value of the BigDecimal object and whose scale is this.scale().
Below programs will illustrate the use of java.math.BigDecimal.negate() function:
Program 1 :// Java program to demonstrate negate() methodimportjava.math.*;publicclassGFG {publicstaticvoidmain(String[] args) {// Create a BigDecimal objectBigDecimal num;// Assign value to numnum =newBigDecimal("4743");System.out.println("Negated value is "+ num.negate() );}}Output:Negated value is -4743
Program 2:
// Java program to demonstrate negate() methodimportjava.math.*;publicclassGFG {publicstaticvoidmain(String[] args) {// Create a BigDecimal objectBigDecimal num;// Assign value to numnum =newBigDecimal("-9674283517.97");System.out.println("Negated value is "+ num.negate() );}}Output:Negated value is 9674283517.97
- The java.math.BigDecimal.negate(MathContext mc) method returns a BigDecimal whose value is the negated value of it, i.e. obtained by rounding off according to the precision settings specified by the object of MathContext class.
Syntax:
public BigDecimal negate(MathContext mc)
Parameters: The method accepts only one parameter mc of MathContext class object which specifies the precision settings for rounding off the BigDecimal.
Return Value: This method returns the negated value of the object which is rounded as per the precision settings.
Exception: The method might throw ArithmeticException if the result obtained is not exact but the rounding mode is UNNECESSARY.
Below programs will illustrate the use of java.math.BigDecimal.negate(MathContext mc) method:
Program 1// Java program to demonstrate negate(MathContext mc) methodimportjava.math.*;publicclassGFG {publicstaticvoidmain(String[] args){// create 2 BigDecimal objectsBigDecimal num, negv;MathContext mc =newMathContext(4);// 4 precision// assign value to numnum =newBigDecimal("78.6714");// assign negate value of num to negv using mcnegv = num.negate(mc);System.out.println("Negated value, rounded to 4"+" precision "+ negv);}}Output:Negated value, rounded to 4 precision -78.67
Program 2
// Java program to demonstrate negate(MathContext mc) methodimportjava.math.*;publicclassGFG {publicstaticvoidmain(String[] args){// create 2 BigDecimal objectsBigDecimal num, negv;MathContext mc =newMathContext(12);// 12 precision// assign value to numnum =newBigDecimal("-178901456.68431");// assign negate value of num to negv using mcnegv = num.negate(mc);System.out.println("Negated value, rounded to 12 "+"precision "+ negv);}}Output:Negated value, rounded to 12 precision 178901456.684
Reference:
https://docs.oracle.com/javase/7/docs/api/java/math/BigDecimal.html#negate()
