java.lang: public class: AssertionError

java.lang
public class: AssertionError [javadoc | source]

java.lang.Object
   java.lang.Throwable
      java.lang.Error
         java.lang.AssertionError

All Implemented Interfaces:
Serializable

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.

since: 1.4 -

Fields inherited from java.lang.Error:
serialVersionUID

Constructor:

Constructor:
public AssertionError() { } Constructs an AssertionError with no detail message.
public AssertionError(Object detailMessage) { this("" + detailMessage); if (detailMessage instanceof Throwable) initCause((Throwable) 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 {@code Throwable}, it becomes the cause of the newly constructed assertion error. Parameters: `detailMessage` - value to be used in constructing detail message Also see: Throwable#getCause()
public AssertionError(boolean detailMessage) { this("" + 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) { this("" + 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) { this("" + 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) { this("" + 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) { this("" + 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) { this("" + 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 message, Throwable cause) { super(message, cause); } Constructs a new {@code AssertionError} with the specified detail message and cause. Note that the detail message associated with {@code cause} is not automatically incorporated in this error's detail message. Parameters: `message` - the detail message, may be {@code null} `cause` - the cause, may be {@code null} since: `1.7` -

 public AssertionError() {

}

Constructs an AssertionError with no detail message.

 public AssertionError(Object detailMessage) {
        this("" +  detailMessage);
        if (detailMessage instanceof Throwable)
            initCause((Throwable) detailMessage);
}

The Java™ Language Specification

If the specified object is an instance of {@code Throwable}, it becomes the cause of the newly constructed assertion error.

Parameters:

detailMessage - value to be used in constructing detail message

Also see:

Throwable#getCause()

 public AssertionError(boolean detailMessage) {
        this("" +  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) {
        this("" +  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) {
        this("" +  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) {
        this("" +  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) {
        this("" +  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) {
        this("" +  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 message,
    Throwable cause) {
        super(message, cause);
}

Note that the detail message associated with {@code cause} is not automatically incorporated in this error's detail message.

Parameters:

message - the detail message, may be {@code null}

cause - the cause, may be {@code null}

since: 1.7 -

Methods from java.lang.Throwable:
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getStackTraceDepth, getStackTraceElement, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait