Module java.base
Package java.lang

Class AssertionError

  • All Implemented Interfaces:
    Serializable
    public class AssertionError
extends Error
    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
    See Also:
    Serialized Form

    • Constructor Summary

      Constructors 
      Constructor Description
      AssertionError()
      Constructs an AssertionError with no detail message.
      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.
      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.
      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.
      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.
      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.
      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.
      AssertionError​(Object 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​(String message, Throwable cause)
      Constructs a new AssertionError with the specified detail message and cause.

    • Constructor Detail

      • AssertionError

        public AssertionError()
        Constructs an AssertionError with no detail message.

      • AssertionError

        public AssertionError​(Object 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:
        Throwable.getCause()

      • AssertionError

        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

      • AssertionError

        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

      • AssertionError

        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

      • AssertionError

        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

      • AssertionError

        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

      • AssertionError

        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

      • AssertionError

        public AssertionError​(String message,
                      Throwable 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
        Since:
        1.7