Class IllformedLocaleException

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:

Constructor Summary

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 Throwable

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

Methods declared in class 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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/IllformedLocaleException.html