Java Throwable toString() Method

---

---

Description

The Java Throwable toString() method returns a short description of this throwable. The result is the concatenation of −

• the name of the class of this object
• ": " (a colon and a space)
• the result of invoking this object's getLocalizedMessage() method.

If getLocalizedMessage returns null, then just the class name is returned.

Declaration

Following is the declaration for java.lang.Throwable.toString() method

public String toString()

Parameters

NA

Return Value

This method returns a string representation of this throwable.

Exception

NA

Example: String Representation of a Throwable

The following example shows the usage of Java Throwable toString() method. We've defined a method raiseException() which throws a Throwable when called. In main method, raiseException() method is called and in catch block exception string representation is printed using toString() method.

package com.tutorialspoint;

public class ThrowableDemo {

   public static void main(String[] args) {

      try {
         raiseException();
      } catch(Throwable e) {
         // print string representation of throwable	  
         System.err.println(e.toString());
      }
   }
  
   // throws Throwable  
   public static void raiseException() throws Throwable {
      throw new Throwable("This is the new Exception"); 
   }
} 

Output

Let us compile and run the above program, this will produce the following result −

java.lang.Throwable: This is the new Exception

Example: String Representation of an Exception

The following example shows the usage of Java Throwable toString() method. We've defined a method raiseException() which throws an Exception when called. In main method, raiseException() method is called and in catch block exception string representation is printed using toString() method.

package com.tutorialspoint;

public class ThrowableDemo {

   public static void main(String[] args) {

      try {
         raiseException();
      } catch(Throwable e) {
         // print string representation of throwable
         System.err.println(e.toString());
      }
   }

   // throws Exception    
   public static void raiseException() throws Exception {
      throw new Exception("This is the new Exception"); 
   }
} 

Output

Let us compile and run the above program, this will produce the following result −

java.lang.Exception: This is the new Exception

Example: String Representation of a RuntimeException

The following example shows the usage of Java Throwable toString() method. We've defined a method raiseException() which throws a RuntimeException when called. In main method, raiseException() method is called and in catch block exception string representation is printed using toString() method.

package com.tutorialspoint;

public class ThrowableDemo {

   public static void main(String[] args) {

      try {
         raiseException();
      } catch(Throwable e) {
         // print string representation of throwable
         System.err.println(e.toString());
      }
   }

   // throws RuntimeException    
   public static void raiseException() throws Exception {
      throw new RuntimeException("This is the new Exception"); 
   }
} 

Output

Let us compile and run the above program, this will produce the following result −

java.lang.RuntimeException: This is the new Exception