Module java.base
Package java.lang

Class NullPointerException

All Implemented Interfaces:

public class NullPointerException extends RuntimeException
Thrown when an application attempts to use null in a case where an object is required. These include:
  • Calling the instance method of a null object.
  • Accessing or modifying the field of a null object.
  • Taking the length of null as if it were an array.
  • Accessing or modifying the slots of null as if it were an array.
  • Throwing null as if it were a Throwable value.

Applications should throw instances of this class to indicate other illegal uses of the null object. NullPointerException objects may be constructed by the virtual machine as if suppression were disabled and/or the stack trace was not writable.

See Also:
  • Constructor Details

    • NullPointerException

      public NullPointerException()
      Constructs a NullPointerException with no detail message.
    • NullPointerException

      public NullPointerException(String s)
      Constructs a NullPointerException with the specified detail message.
      s - the detail message.
  • Method Details

    • fillInStackTrace

      public Throwable fillInStackTrace()
      Fills in the execution stack trace. This method records within this Throwable object information about the current state of the stack frames for the current thread.

      If the stack trace of this Throwable is not writable, calling this method has no effect.

      fillInStackTrace in class Throwable
      a reference to this Throwable instance.
      See Also:
    • getMessage

      public String getMessage()
      Returns the detail message string of this throwable.

      If a non-null message was supplied in a constructor it is returned. Otherwise, an implementation specific message or null is returned.

      getMessage in class Throwable
      Implementation Note:
      If no explicit message was passed to the constructor, and as long as certain internal information is available, a verbose description of the null reference is returned. The internal information is not available in deserialized NullPointerExceptions.
      the detail message string, which may be null.