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()
