IllformedLocaleException

  • IllformedLocaleException signals that an argument is not a well-formed BCP 47 tag when working with Locale and Locale.Builder.

  • This exception is a type of RuntimeException and provides constructors to specify error messages and the location of the error within the tag.

  • The getErrorIndex method can be used to retrieve the index within the tag where the error was detected.

  • IllformedLocaleException inherits methods from Throwable for handling and reporting exceptions.

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.

See Also

Public Constructor Summary

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.

Public Method Summary

int
getErrorIndex()
Returns the index where the error was found.

Inherited Method Summary

Public Constructors

public IllformedLocaleException ()

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

public IllformedLocaleException (String message)

Constructs a new IllformedLocaleException with the given message and -1 as the error index.

Parameters
message the message

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

Public Methods

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