Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/java/lang/IllegalArgumentException#pubctors) \| [Inherited Methods](https://developer.android.com/reference/java/lang/IllegalArgumentException#inhmethods)

# IllegalArgumentException


`
public


class
IllegalArgumentException
`


`


`

`


`

`


`

`

extends https://developer.android.com/reference/java/lang/RuntimeException


`

`


`

|---|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) |||||
| ↳ | [java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable) ||||
|   | ↳ | [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception) |||
|   |   | ↳ | [java.lang.RuntimeException](https://developer.android.com/reference/java/lang/RuntimeException) ||
|   |   |   | ↳ | java.lang.IllegalArgumentException |

Known direct subclasses [IllegalChannelGroupException](https://developer.android.com/reference/java/nio/channels/IllegalChannelGroupException), [IllegalCharsetNameException](https://developer.android.com/reference/java/nio/charset/IllegalCharsetNameException), [IllegalFormatException](https://developer.android.com/reference/java/util/IllegalFormatException), [IllegalSelectorException](https://developer.android.com/reference/java/nio/channels/IllegalSelectorException), [IllegalThreadStateException](https://developer.android.com/reference/java/lang/IllegalThreadStateException), [InvalidParameterException](https://developer.android.com/reference/java/security/InvalidParameterException), [InvalidPathException](https://developer.android.com/reference/java/nio/file/InvalidPathException), [NumberFormatException](https://developer.android.com/reference/java/lang/NumberFormatException), [PatternSyntaxException](https://developer.android.com/reference/java/util/regex/PatternSyntaxException), [ProviderMismatchException](https://developer.android.com/reference/java/nio/file/ProviderMismatchException), [SkeletonSyntaxException](https://developer.android.com/reference/android/icu/number/SkeletonSyntaxException), [SystemUpdatePolicy.ValidationFailedException](https://developer.android.com/reference/android/app/admin/SystemUpdatePolicy.ValidationFailedException), [UnresolvedAddressException](https://developer.android.com/reference/java/nio/channels/UnresolvedAddressException), [UnsupportedAddressTypeException](https://developer.android.com/reference/java/nio/channels/UnsupportedAddressTypeException), [UnsupportedCharsetException](https://developer.android.com/reference/java/nio/charset/UnsupportedCharsetException) [IllegalChannelGroupException](https://developer.android.com/reference/java/nio/channels/IllegalChannelGroupException) Unchecked exception thrown when an attempt is made to open a channel in a group that was not created by the same provider. [IllegalCharsetNameException](https://developer.android.com/reference/java/nio/charset/IllegalCharsetNameException) Unchecked exception thrown when a string that is not a [legal charset name](https://developer.android.com/reference/java/lang/Charset#names) is used as such. [IllegalFormatException](https://developer.android.com/reference/java/util/IllegalFormatException) Unchecked exception thrown when a format string contains an illegal syntax or a format specifier that is incompatible with the given arguments. [IllegalSelectorException](https://developer.android.com/reference/java/nio/channels/IllegalSelectorException) Unchecked exception thrown when an attempt is made to register a channel with a selector that was not created by the provider that created the channel. [IllegalThreadStateException](https://developer.android.com/reference/java/lang/IllegalThreadStateException) Thrown to indicate that a thread is not in an appropriate state for the requested operation. [InvalidParameterException](https://developer.android.com/reference/java/security/InvalidParameterException) This exception, designed for use by the JCA/JCE engine classes, is thrown when an invalid parameter is passed to a method. [InvalidPathException](https://developer.android.com/reference/java/nio/file/InvalidPathException) Unchecked exception thrown when path string cannot be converted into a `https://developer.android.com/reference/java/nio/file/Path` because the path string contains invalid characters, or the path string is invalid for other file system specific reasons. [NumberFormatException](https://developer.android.com/reference/java/lang/NumberFormatException) Thrown to indicate that the application has attempted to convert a string to one of the numeric types, but that the string does not have the appropriate format. [PatternSyntaxException](https://developer.android.com/reference/java/util/regex/PatternSyntaxException) Unchecked exception thrown to indicate a syntax error in a regular-expression pattern. [ProviderMismatchException](https://developer.android.com/reference/java/nio/file/ProviderMismatchException) Unchecked exception thrown when an attempt is made to invoke a method on an object created by one file system provider with a parameter created by a different file system provider. [SkeletonSyntaxException](https://developer.android.com/reference/android/icu/number/SkeletonSyntaxException) Exception used for illegal number skeleton strings. [SystemUpdatePolicy.ValidationFailedException](https://developer.android.com/reference/android/app/admin/SystemUpdatePolicy.ValidationFailedException) An exception class that represents various validation errors thrown from `https://developer.android.com/reference/android/app/admin/SystemUpdatePolicy#setFreezePeriods(java.util.List<android.app.admin.FreezePeriod>)` and `https://developer.android.com/reference/android/app/admin/DevicePolicyManager#setSystemUpdatePolicy(android.content.ComponentName,%20android.app.admin.SystemUpdatePolicy)` [UnresolvedAddressException](https://developer.android.com/reference/java/nio/channels/UnresolvedAddressException) Unchecked exception thrown when an attempt is made to invoke a network operation upon an unresolved socket address. [UnsupportedAddressTypeException](https://developer.android.com/reference/java/nio/channels/UnsupportedAddressTypeException) Unchecked exception thrown when an attempt is made to bind or connect to a socket address of a type that is not supported. [UnsupportedCharsetException](https://developer.android.com/reference/java/nio/charset/UnsupportedCharsetException) Unchecked exception thrown when no support is available for a requested charset. Known indirect subclasses [DuplicateFormatFlagsException](https://developer.android.com/reference/java/util/DuplicateFormatFlagsException), [FormatFlagsConversionMismatchException](https://developer.android.com/reference/java/util/FormatFlagsConversionMismatchException), [IllegalFormatCodePointException](https://developer.android.com/reference/java/util/IllegalFormatCodePointException), [IllegalFormatConversionException](https://developer.android.com/reference/java/util/IllegalFormatConversionException), [IllegalFormatFlagsException](https://developer.android.com/reference/java/util/IllegalFormatFlagsException), [IllegalFormatPrecisionException](https://developer.android.com/reference/java/util/IllegalFormatPrecisionException), [IllegalFormatWidthException](https://developer.android.com/reference/java/util/IllegalFormatWidthException), [MissingFormatArgumentException](https://developer.android.com/reference/java/util/MissingFormatArgumentException), [MissingFormatWidthException](https://developer.android.com/reference/java/util/MissingFormatWidthException), [UnknownFormatConversionException](https://developer.android.com/reference/java/util/UnknownFormatConversionException), [UnknownFormatFlagsException](https://developer.android.com/reference/java/util/UnknownFormatFlagsException) [DuplicateFormatFlagsException](https://developer.android.com/reference/java/util/DuplicateFormatFlagsException) Unchecked exception thrown when duplicate flags are provided in the format specifier. [FormatFlagsConversionMismatchException](https://developer.android.com/reference/java/util/FormatFlagsConversionMismatchException) Unchecked exception thrown when a conversion and flag are incompatible. [IllegalFormatCodePointException](https://developer.android.com/reference/java/util/IllegalFormatCodePointException) Unchecked exception thrown when a character with an invalid Unicode code point as defined by `https://developer.android.com/reference/java/lang/Character#isValidCodePoint(int)` is passed to the `https://developer.android.com/reference/java/util/Formatter`. [IllegalFormatConversionException](https://developer.android.com/reference/java/util/IllegalFormatConversionException) Unchecked exception thrown when the argument corresponding to the format specifier is of an incompatible type. [IllegalFormatFlagsException](https://developer.android.com/reference/java/util/IllegalFormatFlagsException) Unchecked exception thrown when an illegal combination flags is given. [IllegalFormatPrecisionException](https://developer.android.com/reference/java/util/IllegalFormatPrecisionException) Unchecked exception thrown when the precision is a negative value other than `-1`, the conversion does not support a precision, or the value is otherwise unsupported. [IllegalFormatWidthException](https://developer.android.com/reference/java/util/IllegalFormatWidthException) Unchecked exception thrown when the format width is a negative value other than `-1` or is otherwise unsupported. [MissingFormatArgumentException](https://developer.android.com/reference/java/util/MissingFormatArgumentException) Unchecked exception thrown when there is a format specifier which does not have a corresponding argument or if an argument index refers to an argument that does not exist. [MissingFormatWidthException](https://developer.android.com/reference/java/util/MissingFormatWidthException) Unchecked exception thrown when the format width is required. [UnknownFormatConversionException](https://developer.android.com/reference/java/util/UnknownFormatConversionException) Unchecked exception thrown when an unknown conversion is given. [UnknownFormatFlagsException](https://developer.android.com/reference/java/util/UnknownFormatFlagsException) Unchecked exception thrown when an unknown flag is given.   

*** ** * ** ***

Thrown to indicate that a method has been passed an illegal or
inappropriate argument.

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/java/lang/IllegalArgumentException#IllegalArgumentException()() ` Constructs an `IllegalArgumentException` with no detail message. |
| ` https://developer.android.com/reference/java/lang/IllegalArgumentException#IllegalArgumentException(java.lang.String)(https://developer.android.com/reference/java/lang/String s) ` Constructs an `IllegalArgumentException` with the specified detail message. |
| ` https://developer.android.com/reference/java/lang/IllegalArgumentException#IllegalArgumentException(java.lang.String,%20java.lang.Throwable)(https://developer.android.com/reference/java/lang/String message, https://developer.android.com/reference/java/lang/Throwable cause) ` Constructs a new exception with the specified detail message and cause. |
| ` https://developer.android.com/reference/java/lang/IllegalArgumentException#IllegalArgumentException(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable cause) ` Constructs a new exception with the specified cause and a detail message of `(cause==null ? null : cause.toString())` (which typically contains the class and detail message of `cause`). |

### Inherited methods

From class `

https://developer.android.com/reference/java/lang/Throwable

` `


final

void` `
https://developer.android.com/reference/java/lang/Throwable#addSuppressed(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable exception)
`

Appends the specified exception to the exceptions that were
suppressed in order to deliver this exception.


`


https://developer.android.com/reference/java/lang/Throwable` `
https://developer.android.com/reference/java/lang/Throwable#fillInStackTrace()()
`

Fills in the execution stack trace.


`


https://developer.android.com/reference/java/lang/Throwable` `
https://developer.android.com/reference/java/lang/Throwable#getCause()()
`

Returns the cause of this throwable or `null` if the
cause is nonexistent or unknown.


`


https://developer.android.com/reference/java/lang/String` `
https://developer.android.com/reference/java/lang/Throwable#getLocalizedMessage()()
`

Creates a localized description of this throwable.


`


https://developer.android.com/reference/java/lang/String` `
https://developer.android.com/reference/java/lang/Throwable#getMessage()()
`

Returns the detail message string of this throwable.


`


https://developer.android.com/reference/java/lang/StackTraceElement` `
https://developer.android.com/reference/java/lang/Throwable#getStackTrace()()
`

Provides programmatic access to the stack trace information printed by
`https://developer.android.com/reference/java/lang/Throwable#printStackTrace()`.


`


final

https://developer.android.com/reference/java/lang/Throwable` `
https://developer.android.com/reference/java/lang/Throwable#getSuppressed()()
`

Returns an array containing all of the exceptions that were
suppressed, typically by the `try`-with-resources
statement, in order to deliver this exception.


`


https://developer.android.com/reference/java/lang/Throwable` `
https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable cause)
`

Initializes the *cause* of this throwable to the specified value.


`


void` `
https://developer.android.com/reference/java/lang/Throwable#printStackTrace()()
`

Prints this throwable and its backtrace to the
standard error stream.


`


void` `
https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintWriter)(https://developer.android.com/reference/java/io/PrintWriter s)
`

Prints this throwable and its backtrace to the specified
print writer.


`


void` `
https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintStream)(https://developer.android.com/reference/java/io/PrintStream s)
`

Prints this throwable and its backtrace to the specified print stream.


`


void` `
https://developer.android.com/reference/java/lang/Throwable#setStackTrace(java.lang.StackTraceElement[])(https://developer.android.com/reference/java/lang/StackTraceElement stackTrace)
`

Sets the stack trace elements that will be returned by
`https://developer.android.com/reference/java/lang/Throwable#getStackTrace()` and printed by `https://developer.android.com/reference/java/lang/Throwable#printStackTrace()`
and related methods.


`


https://developer.android.com/reference/java/lang/String` `
https://developer.android.com/reference/java/lang/Throwable#toString()()
`

Returns a short description of this throwable.


From class `

https://developer.android.com/reference/java/lang/Object

` `


https://developer.android.com/reference/java/lang/Object` `
https://developer.android.com/reference/java/lang/Object#clone()()
`

Creates and returns a copy of this object.


`


boolean` `
https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj)
`

Indicates whether some other object is "equal to" this one.


`


void` `
https://developer.android.com/reference/java/lang/Object#finalize()()
`

Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.


`


final

https://developer.android.com/reference/java/lang/Class<?>` `
https://developer.android.com/reference/java/lang/Object#getClass()()
`

Returns the runtime class of this `Object`.


`


int` `
https://developer.android.com/reference/java/lang/Object#hashCode()()
`

Returns a hash code value for the object.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#notify()()
`

Wakes up a single thread that is waiting on this object's
monitor.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#notifyAll()()
`

Wakes up all threads that are waiting on this object's monitor.


`


https://developer.android.com/reference/java/lang/String` `
https://developer.android.com/reference/java/lang/Object#toString()()
`

Returns a string representation of the object.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos)
`

Causes the current thread to wait until it is awakened, typically
by being *notified* or *interrupted*, or until a
certain amount of real time has elapsed.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis)
`

Causes the current thread to wait until it is awakened, typically
by being *notified* or *interrupted*, or until a
certain amount of real time has elapsed.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#wait()()
`

Causes the current thread to wait until it is awakened, typically
by being *notified* or *interrupted*.


## Public constructors

### IllegalArgumentException

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public IllegalArgumentException ()
```

Constructs an `IllegalArgumentException` with no
detail message.

<br />

### IllegalArgumentException

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public IllegalArgumentException (String s)
```

Constructs an `IllegalArgumentException` with the
specified detail message.

<br />

| Parameters ||
|---|---|
| `s` | `String`: the detail message. <br /> |

### IllegalArgumentException

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public IllegalArgumentException (String message, 
                Throwable cause)
```

Constructs a new exception with the specified detail message and
cause.

Note that the detail message associated with `cause` is
*not* automatically incorporated in this exception's detail
message.

<br />

| Parameters ||
|---|---|
| `message` | `String`: the detail message (which is saved for later retrieval by the `https://developer.android.com/reference/java/lang/Throwable#getMessage()` method). <br /> |
| `cause` | `Throwable`: the cause (which is saved for later retrieval by the `https://developer.android.com/reference/java/lang/Throwable#getCause()` method). (A `null` value is permitted, and indicates that the cause is nonexistent or unknown.) <br /> |

### IllegalArgumentException

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public IllegalArgumentException (Throwable cause)
```

Constructs a new exception with the specified cause and a detail
message of `(cause==null ? null : cause.toString())` (which
typically contains the class and detail message of `cause`).
This constructor is useful for exceptions that are little more than
wrappers for other throwables (for example, `https://developer.android.com/reference/java/security/PrivilegedActionException`).

<br />

| Parameters ||
|---|---|
| `cause` | `Throwable`: the cause (which is saved for later retrieval by the `https://developer.android.com/reference/java/lang/Throwable#getCause()` method). (A `null` value is permitted, and indicates that the cause is nonexistent or unknown.) <br /> |