Module java.base
Package java.util

# Class IllformedLocaleException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
java.util.IllformedLocaleException

All Implemented Interfaces:
  `Serializable`

public class IllformedLocaleException extends RuntimeException
Thrown by methods in `Locale` and `Locale.Builder` to indicate that an argument is not a well-formed BCP 47 tag.

Since:
  1.7
See Also:
  - `Locale`
  - Serialized Form

## Constructor Summary

Constructors
Constructor
Description
`IllformedLocaleException()`
Constructs a new `IllformedLocaleException` with no detail message and -1 as the error index.
`IllformedLocaleException(String message)`
Constructs a new `IllformedLocaleException` with the given message and -1 as the error index.
`IllformedLocaleException(String message, int errorIndex)`
Constructs a new `IllformedLocaleException` with the given message and the error index.

## Method Summary

Modifier and Type
Method
Description
`int`
`getErrorIndex()`
Returns the index where the error was found.

### Methods declared in class java.lang.Throwable

`addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString`

### Methods declared in class java.lang.Object

`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

## Constructor Details

### IllformedLocaleException

public IllformedLocaleException()
Constructs a new `IllformedLocaleException` with no detail message and -1 as the error index.

### IllformedLocaleException

public IllformedLocaleException(String message)
Constructs a new `IllformedLocaleException` with the given message and -1 as the error index.

Parameters:
  `message` - the message

### IllformedLocaleException

public IllformedLocaleException(String message, int errorIndex)
Constructs a new `IllformedLocaleException` with the given message and the error index. The error index is the approximate offset from the start of the ill-formed value to the point where the parse first detected an error. A negative error index value indicates either the error index is not applicable or unknown.

Parameters:
  `message` - the message
  `errorIndex` - the index

## Method Details

### getErrorIndex

public int getErrorIndex()
Returns the index where the error was found. A negative value indicates either the error index is not applicable or unknown.

Returns:
  the error index