# AssertionError

public class **AssertionError** extends [Error](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Error.html)  
Thrown to indicate that an assertion has failed.

The seven one-argument public constructors provided by this
class ensure that the assertion error returned by the invocation:

```
     new AssertionError(expression)
 
```
has as its detail message the *string conversion* of *expression* (as defined in section 15.18.1.1 of The Java™ Language Specification), regardless of the type of *expression*.

<br />

### Public Constructor Summary

|---|---|
|   | [AssertionError](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/AssertionError.html#AssertionError())() Constructs an AssertionError with no detail message. |
|   | [AssertionError](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/AssertionError.html#AssertionError(java.lang.Object))([Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) detailMessage) Constructs an AssertionError with its detail message derived from the specified object, which is converted to a string as defined in section 15.18.1.1 of The Java™ Language Specification. |
|   | [AssertionError](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/AssertionError.html#AssertionError(boolean))(boolean detailMessage) Constructs an AssertionError with its detail message derived from the specified `boolean`, which is converted to a string as defined in section 15.18.1.1 of The Java™ Language Specification. |
|   | [AssertionError](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/AssertionError.html#AssertionError(char))(char detailMessage) Constructs an AssertionError with its detail message derived from the specified `char`, which is converted to a string as defined in section 15.18.1.1 of The Java™ Language Specification. |
|   | [AssertionError](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/AssertionError.html#AssertionError(int))(int detailMessage) Constructs an AssertionError with its detail message derived from the specified `int`, which is converted to a string as defined in section 15.18.1.1 of The Java™ Language Specification. |
|   | [AssertionError](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/AssertionError.html#AssertionError(long))(long detailMessage) Constructs an AssertionError with its detail message derived from the specified `long`, which is converted to a string as defined in section 15.18.1.1 of The Java™ Language Specification. |
|   | [AssertionError](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/AssertionError.html#AssertionError(float))(float detailMessage) Constructs an AssertionError with its detail message derived from the specified `float`, which is converted to a string as defined in section 15.18.1.1 of The Java™ Language Specification. |
|   | [AssertionError](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/AssertionError.html#AssertionError(double))(double detailMessage) Constructs an AssertionError with its detail message derived from the specified `double`, which is converted to a string as defined in section 15.18.1.1 of The Java™ Language Specification. |
|   | [AssertionError](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/AssertionError.html#AssertionError(java.lang.String,%20java.lang.Throwable))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) message, [Throwable](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html) cause) Constructs a new `AssertionError` with the specified detail message and cause. |

### Inherited Method Summary

From class [java.lang.Throwable](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html)

|---|---|
| synchronized final void | [addSuppressed](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#addSuppressed(java.lang.Throwable))([Throwable](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html) exception) Appends the specified exception to the exceptions that were suppressed in order to deliver this exception. |
| synchronized [Throwable](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html) | [fillInStackTrace](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#fillInStackTrace())() Fills in the execution stack trace. |
| synchronized [Throwable](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html) | [getCause](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#getCause())() Returns the cause of this throwable or `null` if the cause is nonexistent or unknown. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [getLocalizedMessage](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#getLocalizedMessage())() Creates a localized description of this throwable. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [getMessage](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#getMessage())() Returns the detail message string of this throwable. |
| StackTraceElement\[\] | [getStackTrace](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#getStackTrace())() Provides programmatic access to the stack trace information printed by `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#printStackTrace()`. |
| synchronized final [Throwable\[\]](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html) | [getSuppressed](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#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. |
| synchronized [Throwable](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html) | [initCause](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#initCause(java.lang.Throwable))([Throwable](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html) cause) Initializes the *cause* of this throwable to the specified value. |
| void | [printStackTrace](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#printStackTrace())() Prints this throwable and its backtrace to the standard error stream. |
| void | [printStackTrace](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#printStackTrace(java.io.PrintWriter))([PrintWriter](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/PrintWriter.html) s) Prints this throwable and its backtrace to the specified print writer. |
| void | [printStackTrace](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#printStackTrace(java.io.PrintStream))([PrintStream](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/PrintStream.html) s) Prints this throwable and its backtrace to the specified print stream. |
| void | [setStackTrace](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#setStackTrace(java.lang.StackTraceElement[]))(StackTraceElement\[\] stackTrace) Sets the stack trace elements that will be returned by `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#getStackTrace()` and printed by `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#printStackTrace()` and related methods. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [toString](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#toString())() Returns a short description of this throwable. |

From class [java.lang.Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)

|---|---|
| [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) | [clone](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#clone())() Creates and returns a copy of this `Object`. |
| boolean | [equals](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#equals(java.lang.Object))([Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) obj) Compares this instance with the specified object and indicates if they are equal. |
| void | [finalize](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#finalize())() Invoked when the garbage collector has detected that this instance is no longer reachable. |
| final [Class](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html)\<?\> | [getClass](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#getClass())() Returns the unique instance of `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html` that represents this object's class. |
| int | [hashCode](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#hashCode())() Returns an integer hash code for this object. |
| final void | [notify](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#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](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#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](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [toString](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#toString())() Returns a string containing a concise, human-readable description of this object. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long,%20int))(long timeout, 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](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long))(long timeout) 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](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait())() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object. |

## Public Constructors

#### public
**AssertionError**
()

Constructs an AssertionError with no detail message.

#### public
**AssertionError**
([Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) detailMessage)

Constructs an AssertionError with its detail message derived
from the specified object, which is converted to a string as
defined in section 15.18.1.1 of
The Java™ Language Specification.


If the specified object is an instance of `Throwable`, it
becomes the *cause* of the newly constructed assertion error.

##### Parameters

| detailMessage | value to be used in constructing detail message |
|---|---|

##### See Also

- `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html#getCause()`

#### public
**AssertionError**
(boolean detailMessage)

Constructs an AssertionError with its detail message derived
from the specified `boolean`, which is converted to
a string as defined in section 15.18.1.1 of
The Java™ Language Specification.

##### Parameters

| detailMessage | value to be used in constructing detail message |
|---|---|

#### public
**AssertionError**
(char detailMessage)

Constructs an AssertionError with its detail message derived
from the specified `char`, which is converted to a
string as defined in section 15.18.1.1 of
The Java™ Language Specification.

##### Parameters

| detailMessage | value to be used in constructing detail message |
|---|---|

#### public
**AssertionError**
(int detailMessage)

Constructs an AssertionError with its detail message derived
from the specified `int`, which is converted to a
string as defined in section 15.18.1.1 of
The Java™ Language Specification.

##### Parameters

| detailMessage | value to be used in constructing detail message |
|---|---|

#### public
**AssertionError**
(long detailMessage)

Constructs an AssertionError with its detail message derived
from the specified `long`, which is converted to a
string as defined in section 15.18.1.1 of
The Java™ Language Specification.

##### Parameters

| detailMessage | value to be used in constructing detail message |
|---|---|

#### public
**AssertionError**
(float detailMessage)

Constructs an AssertionError with its detail message derived
from the specified `float`, which is converted to a
string as defined in section 15.18.1.1 of
The Java™ Language Specification.

##### Parameters

| detailMessage | value to be used in constructing detail message |
|---|---|

#### public
**AssertionError**
(double detailMessage)

Constructs an AssertionError with its detail message derived
from the specified `double`, which is converted to a
string as defined in section 15.18.1.1 of
The Java™ Language Specification.

##### Parameters

| detailMessage | value to be used in constructing detail message |
|---|---|

#### public
**AssertionError**
([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) message, [Throwable](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Throwable.html) cause)

Constructs a new `AssertionError` with the specified
detail message and cause.

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

##### Parameters

| message | the detail message, may be `null` |
| cause | the cause, may be `null` |
|---|---|