Scanner nextBigDecimal() method in Java with Examples

The nextBigDecimal() method of java.util.Scanner class scans the next token of the input as a BigDecimal. If the next token matches the Decimal regular expression defined above then the token is converted into a BigDecimal value as if by removing all group separators, mapping non-ASCII digits into ASCII digits via the Character.digit, and passing the resulting string to the BigDecimal(String) constructor.

Syntax:

public BigDecimal nextBigDecimal()

Parameters: The function does not accepts any parameter.

Return Value: This function returns the BigDecimal scanned from the input.

Exceptions: The function throws three exceptions as described below:

• InputMismatchException: if the next token is not a valid BigDecimal or is out of range
• NoSuchElementException: throws if input is exhausted
• IllegalStateException: throws if this scanner is closed

Below programs illustrate the above function:

Program 1:

// Java program to illustrate the
// nextBigDecimal() method of Scanner class in Java
// without parameter

import java.util.*;

public class GFG1 {
    public static void main(String[] argv)
        throws Exception
    {

        String s = "Gfg 9 + 6 = 12.0";

        // create a new scanner
        // with the specified String Object
        Scanner scanner = new Scanner(s);

        while (scanner.hasNext()) {

            // if the next is a BigDecimal,
            // print found and the BigDecimal
            if (scanner.hasNextBigDecimal()) {
                System.out.println("Found BigDecimal value :"
                                   + scanner.nextBigDecimal());
            }

            // if no BigDecimal is found,
            // print "Not Found:" and the token
            else {
                System.out.println("Not found BigDecimal() value :"
                                   + scanner.next());
            }
        }
        scanner.close();
    }
}

Output:

Not found BigDecimal() value :Gfg
Found BigDecimal value :9
Not found BigDecimal() value :+
Found BigDecimal value :6
Not found BigDecimal() value :=
Found BigDecimal value :12.0

Program 2: To demonstrate InputMismatchException

// Java program to illustrate the
// nextBigDecimal() method of Scanner class in Java
// InputMismatchException

import java.util.*;

public class GFG1 {
    public static void main(String[] argv)
        throws Exception
    {

        try {

            String s = "Gfg 9 + 6 = 12.0";

            // create a new scanner
            // with the specified String Object
            Scanner scanner = new Scanner(s);

            while (scanner.hasNext()) {

                // if the next is a BigDecimal
                // print found and the BigDecimal
                // since the value 60 is out of range
                // it throws an exception

                System.out.println("Next BigDecimal value :"
                                   + scanner.nextBigDecimal());
            }
            scanner.close();
        }
        catch (Exception e) {
            System.out.println("Exception thrown: " + e);
        }
    }
}

Output:

Exception thrown: java.util.InputMismatchException

Program 3: To demonstrate NoSuchElementException

// Java program to illustrate the
// nextBigDecimal() method of Scanner class in Java
// NoSuchElementException

import java.util.*;

public class GFG1 {
    public static void main(String[] argv)
        throws Exception
    {

        try {

            String s = "Gfg";

            // create a new scanner
            // with the specified String Object
            Scanner scanner = new Scanner(s);

            // Trying to get the next BigDecimal value
            // more times than the scanner
            // Hence it will throw exception
            for (int i = 0; i < 5; i++) {

                // if the next is a BigDecimal,
                // print found and the BigDecimal
                if (scanner.hasNextBigDecimal()) {
                    System.out.println("Found BigDecimal value :"
                                       + scanner.nextBigDecimal());
                }

                // if no BigDecimal is found,
                // print "Not Found:" and the token
                else {
                    System.out.println("Not found BigDecimal value :"
                                       + scanner.next());
                }
            }
            scanner.close();
        }
        catch (Exception e) {
            System.out.println("Exception thrown: " + e);
        }
    }
}

Output:

Not found BigDecimal value :Gfg
Exception thrown: java.util.NoSuchElementException

Program 4: To demonstrate IllegalStateException

// Java program to illustrate the
// nextBigDecimal() method of Scanner class in Java
// IllegalStateException

import java.util.*;

public class GFG1 {
    public static void main(String[] argv)
        throws Exception
    {

        try {

            String s = "Gfg 9 + 6 = 12.0";

            // create a new scanner
            // with the specified String Object
            Scanner scanner = new Scanner(s);

            // close the scanner
            scanner.close();
            System.out.println("Scanner Closed");

            System.out.println("Trying to get "
                               + "next BigDecimal value");

            while (scanner.hasNext()) {

                // if the next is a BigDecimal,
                // print found and the BigDecimal
                if (scanner.hasNextBigDecimal()) {
                    System.out.println("Found BigDecimal value :"
                                       + scanner.nextBigDecimal());
                }

                // if no BigDecimal is found,
                // print "Not Found:" and the token
                else {
                    System.out.println("Not found BigDecimal value :"
                                       + scanner.next());
                }
            }
        }
        catch (Exception e) {
            System.out.println("Exception thrown: " + e);
        }
    }
}

Output:

Scanner Closed
Trying to get next BigDecimal value
Exception thrown: java.lang.IllegalStateException: Scanner closed

Reference: https://docs.oracle.com/javase/7/docs/api/java/util/Scanner.html#nextBigDecimal()