Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)

Interfaces
Classes
- Boolean
- Byte
- Character
- Character.Subset
- Character.UnicodeBlock
- Class
- ClassLoader
- Compiler
- Double
- Enum
- Float
- InheritableThreadLocal
- Integer
- Long
- Math
- Number
- Object
- Package
- Process
- ProcessBuilder
- Runtime
- RuntimePermission
- SecurityManager
- Short
- StackTraceElement
- StrictMath
- String
- StringBuffer
- StringBuilder
- System
- Thread
- ThreadGroup
- ThreadLocal
- Throwable
- Void
Enums
- Thread.State
Exceptions
Errors

Summary: Ctors | Inherited Methods | [Expand All]

Added in API level 1

public class

IllegalArgumentException

extends RuntimeException

java.lang.Object
↳	java.lang.Throwable
	↳	java.lang.Exception
		↳	java.lang.RuntimeException
			↳	java.lang.IllegalArgumentException

Known Direct Subclasses

IllegalCharsetNameException , IllegalFormatException , IllegalSelectorException , IllegalThreadStateException , InvalidParameterException , NumberFormatException , PatternSyntaxException , UnresolvedAddressException , UnsupportedAddressTypeException , UnsupportedCharsetException

IllegalCharsetNameException	An `IllegalCharsetNameException` is thrown when an illegal charset name is encountered.
IllegalFormatException	An `IllegalFormatException` is thrown when a format string that contains either an illegal syntax or format specifier is transferred as a parameter.
IllegalSelectorException	An `IllegalSelectorException` is thrown when a call is made to register a channel on a selector that has been created by a different provider.
IllegalThreadStateException	Thrown when an operation is attempted which is not possible given the state that the executing thread is in.
InvalidParameterException	`InvalidParameterException` indicates exceptional conditions, caused by invalid parameters.
NumberFormatException	Thrown when an invalid value is passed to a string-to-number conversion method.
PatternSyntaxException	Encapsulates a syntax error that occurred during the compilation of a `Pattern` .
UnresolvedAddressException	An `UnresolvedAddressException` is thrown when trying to use an unresolved network address in a network operation.
UnsupportedAddressTypeException	An `UnsupportedAddressTypeException` is thrown when connecting or binding to an unsupported address type.
UnsupportedCharsetException	An `UnsupportedCharsetException` is thrown when an unsupported charset name is encountered.

Known Indirect Subclasses

DuplicateFormatFlagsException , FormatFlagsConversionMismatchException , IllegalFormatCodePointException , IllegalFormatConversionException , IllegalFormatFlagsException , IllegalFormatPrecisionException , IllegalFormatWidthException , MissingFormatArgumentException , MissingFormatWidthException , UnknownFormatConversionException , UnknownFormatFlagsException

DuplicateFormatFlagsException	The unchecked exception will be thrown out if there are duplicate flags given out in the format specifier.
FormatFlagsConversionMismatchException	A `FormatFlagsConversionMismatchException` will be thrown if a conversion and the flags are incompatible.
IllegalFormatCodePointException	An `IllegalFormatCodePointException` will be thrown if an invalid Unicode code point (defined by `isValidCodePoint(int)` ) is passed as a parameter to a Formatter.
IllegalFormatConversionException	An `IllegalFormatConversionException` will be thrown when the parameter is incompatible with the corresponding format specifier.
IllegalFormatFlagsException	An `IllegalFormatFlagsException` will be thrown if the combination of the format flags is illegal.
IllegalFormatPrecisionException	An `IllegalFormatPrecisionException` will be thrown if the precision is a negative other than -1 or in other cases where precision is not supported.
IllegalFormatWidthException	An `IllegalFormatWidthException` will be thrown if the width is a negative value other than -1 or in other cases where a width is not supported.
MissingFormatArgumentException	A `MissingFormatArgumentException` will be thrown if there is no corresponding argument with the specified conversion or an argument index that refers to a missing argument.
MissingFormatWidthException	A `MissingFormatWidthException` will be thrown if the format width is missing but is required.
UnknownFormatConversionException	An `UnknownFormatConversionException` will be thrown if the format conversion is unknown.
UnknownFormatFlagsException	An `UnknownFormatFlagsException` will be thrown if there is an unknown flag.

Class Overview

Thrown when a method is invoked with an argument which it can not reasonably deal with.

Summary

Public Constructors
	IllegalArgumentException () Constructs a new `IllegalArgumentException` that includes the current stack trace.
	IllegalArgumentException ( String detailMessage) Constructs a new `IllegalArgumentException` with the current stack trace and the specified detail message.
	IllegalArgumentException ( String message, Throwable cause) Constructs a new `IllegalArgumentException` with the current stack trace, the specified detail message and the specified cause.
	IllegalArgumentException ( Throwable cause) Constructs a new `IllegalArgumentException` with the current stack trace and the specified cause.

[Expand]

Inherited Methods

From class java.lang.Throwable

final void	addSuppressed ( Throwable throwable) Adds `throwable` to the list of throwables suppressed by this.
Throwable	fillInStackTrace () Records the stack trace from the point where this method has been called to this `Throwable` .
Throwable	getCause () Returns the cause of this `Throwable` , or `null` if there is no cause.
String	getLocalizedMessage () Returns the detail message which was provided when this `Throwable` was created.
String	getMessage () Returns the detail message which was provided when this `Throwable` was created.
StackTraceElement[]	getStackTrace () Returns a clone of the array of stack trace elements of this `Throwable` .
final Throwable[]	getSuppressed () Returns the throwables suppressed by this.
Throwable	initCause ( Throwable throwable) Initializes the cause of this `Throwable` .
void	printStackTrace ( PrintStream err) Writes a printable representation of this `Throwable` 's stack trace to the given print stream.
void	printStackTrace ( PrintWriter err) Writes a printable representation of this `Throwable` 's stack trace to the specified print writer.
void	printStackTrace () Writes a printable representation of this `Throwable` 's stack trace to the `System.err` stream.
void	setStackTrace ( StackTraceElement[] trace) Sets the array of stack trace elements.
String	toString () Returns a string containing a concise, human-readable description of this object.

From class java.lang.Object

Object	clone () Creates and returns a copy of this `Object` .
boolean	equals ( Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize () Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class <?>	getClass () Returns the unique instance of `Class` that represents this object's class.
int	hashCode () Returns an integer hash code for this object.
final void	notify () Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll () Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString () Returns a string containing a concise, human-readable description of this object.
final void	wait () Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait (long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait (long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Public Constructors

public IllegalArgumentException ()

Added in API level 1

Constructs a new IllegalArgumentException that includes the current stack trace.

public IllegalArgumentException ( String detailMessage)

Added in API level 1

Constructs a new IllegalArgumentException with the current stack trace and the specified detail message.

Parameters

detailMessage	the detail message for this exception.

public IllegalArgumentException ( String message, Throwable cause)

Added in API level 1

Constructs a new IllegalArgumentException with the current stack trace, the specified detail message and the specified cause.

Parameters

message	the detail message for this exception.
cause	the cause of this exception, may be `null` .

public IllegalArgumentException ( Throwable cause)

Added in API level 1

Constructs a new IllegalArgumentException with the current stack trace and the specified cause.

Parameters

cause	the cause of this exception, may be `null` .

Results

Interfaces

Classes

Enums

Exceptions

Errors

IllegalArgumentException

Class Overview

Summary

Public Constructors

public IllegalArgumentException ()

public IllegalArgumentException ( String detailMessage)

Parameters

public IllegalArgumentException ( String message, Throwable cause)

Parameters

public IllegalArgumentException ( Throwable cause)

Parameters