/* * @(#)AssertionError.java 1.7 03/12/19 * * Copyright 2004 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package java.lang; /** * 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 * The Java Language Specification, Second Edition, * * Section 15.18.1.1), regardless of the type of expression. * * @version 1.7, 12/19/03 * @since JDK1.4 */ public class AssertionError extends Error { /** * Constructs an AssertionError with no detail message. */ public AssertionError() { } /** * This internal constructor does no processing on its string argument, * even if it is a null reference. The public constructors will * never call this constructor with a null argument. */ private AssertionError(String detailMessage) { super(detailMessage); } /** * Constructs an AssertionError with its detail message derived * from the specified object, which is converted to a string as * defined in The Java Language Specification, Second * Edition, Section 15.18.1.1. *
* If the specified object is an instance of Throwable, it
* becomes the cause of the newly constructed assertion error.
*
* @param detailMessage value to be used in constructing detail message
* @see Throwable#getCause()
*/
public AssertionError(Object detailMessage) {
this("" + detailMessage);
if (detailMessage instanceof Throwable)
initCause((Throwable) detailMessage);
}
/**
* Constructs an AssertionError with its detail message derived
* from the specified boolean
, which is converted to
* a string as defined in The Java Language Specification,
* Second Edition, Section 15.18.1.1.
*
* @param detailMessage value to be used in constructing detail message
*/
public AssertionError(boolean detailMessage) {
this("" + detailMessage);
}
/**
* Constructs an AssertionError with its detail message derived
* from the specified char
, which is converted to a
* string as defined in The Java Language Specification, Second
* Edition, Section 15.18.1.1.
*
* @param 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 int
, which is converted to a
* string as defined in The Java Language Specification, Second
* Edition, Section 15.18.1.1.
*
* @param 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 long
, which is converted to a
* string as defined in The Java Language Specification, Second
* Edition, Section 15.18.1.1.
*
* @param 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 float
, which is converted to a
* string as defined in The Java Language Specification, Second
* Edition, Section 15.18.1.1.
*
* @param 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 double
, which is converted to a
* string as defined in The Java Language Specification, Second
* Edition, Section 15.18.1.1.
*
* @param detailMessage value to be used in constructing detail message
*/
public AssertionError(double detailMessage) {
this("" + detailMessage);
}
}