Home » Java » Java Reference » Java BigDecimal Class

Java BigDecimal toPlainString() Method with Example

BigDecimal Class toPlainString() method: Here, we are going to learn about the toPlainString() method of BigDecimal Class with its syntax and example.
Submitted by Preeti Jain, on May 07, 2020

BigDecimal Class toPlainString() method

• toPlainString() method is available in java.math package.
• toPlainString() method is used to represent string denotation of this BigDecimal without the help of any notation and no exponent is required to denote BigDecimal as a String.
  • Case 1: What happens when values with scale > 0 (i.e. +ve)
    The number of digits to the rightmost side after the decimal is used to represent scale.
  • Case 2: What happens when values with scale < 0 (i.e. -ve)
    When all the trailing zeros of the scale value existed in the calculation.
  • Case 3: What happens when values with scale = 0 (i.e. 0)
    When the value was translated to an equivalent value to represent a string with scale =0.
• The resulting string is prefixed by the negative (-) sign when the unscaled value is negative otherwise no sign is prefixed when the unscaled value is 0 or positive.
• toPlainString() method is a non-static method, it is accessible with the class object only and if we try to access the method with the class name then we will get an error.
• toPlainString() method does not throw an exception at the time of representing this BigDecimal as a String.

Syntax:

    public String toPlainString();

Parameter(s):

• It does not accept any parameter.

Return value:

The return type of this method is String, it returns string denotation of this BigDecimal object with no exponent is required.

Example:

// Java program to demonstrate the example 
// of String toPlainString() method of BigDecimal

import java.math.*;

public class ToPlainStringOfBD {
    public static void main(String args[]) {
        // Initializes two variables -  
        // String type
        String str1 = "12E+5";
        String str2 = "1200000";

        // Initializes two BigDecimal objects  
        BigDecimal b_dec1 = new BigDecimal(str1);
        BigDecimal b_dec2 = new BigDecimal(str2);

        // By using toPlainString() method is 
        // used to represent this BigDecimal b_dec1 as
        // a String without using the engineering notation
        String str_conv = b_dec1.toPlainString();
        System.out.println("b_dec1.toPlainString(): " + str_conv);

        // By using toPlainString() method is 
        // used to represent this BigDecimal b_dec2 as
        // a String without using the engineering notation
        str_conv = b_dec2.toPlainString();
        System.out.println("b_dec2.toPlainString(): " + str_conv);
    }
}

Output

b_dec1.toPlainString(): 1200000
b_dec2.toPlainString(): 1200000