Java Throwable getStackTrace() Method

---

---

Description

The Java Throwable getStackTrace() method returns an array of stack trace elements, each representing one stack frame. The zeroth element of the array (assuming the array's length is non-zero) represents the top of the stack, which is the last method invocation in the sequence. This is the point at which this throwable was created and thrown.

The last element of the array (assuming the array's length is non-zero) represents the bottom of the stack, which is the first method invocation in the sequence.

Declaration

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

public StackTraceElement[] getStackTrace()

Parameters

NA

Return Value

This method returns an array of stack trace elements representing the stack trace pertaining to this throwable.

Exception

NA

Example: Getting Stacktrace of a Throwable

The following example shows the usage of Java Throwable getStackTrace() method. We've defined a method raiseException() which throws a Throwable after setting the Stacktrace. In main method, raiseException() method is called and in catch block exception stack trace is retrieved using getStackTrace() and printed.

package com.tutorialspoint;

public class ThrowableDemo {

   public static void main(String[] args) {

      try {
         raiseException();
      } catch(Throwable e) {
         // access to the stack trace
         StackTraceElement[] trace = e.getStackTrace();
         System.err.println(trace[0].toString());
      }
   }
  
   public static void raiseException()throws Throwable {

      Throwable t = new Throwable("This is new Exception...");
      StackTraceElement[] trace = new StackTraceElement[] {
         new StackTraceElement("ClassName","methodName","fileName",10)
      };

      // sets the stack trace elements
      t.setStackTrace(trace);
      throw t;
   }
}

Output

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

ClassName.methodName(fileName:10)

Example: Getting Stacktrace of an Exception

The following example shows the usage of Java Throwable setStackTrace() method. We've defined a method raiseException() which throws an Exception after setting the Stacktrace. In main method, raiseException() method is called and in catch block exception stack trace is retrieved using getStackTrace() method and printed.

package com.tutorialspoint;

public class ThrowableDemo {

   public static void main(String[] args) {

      try {
         raiseException();
      } catch(Throwable e) {
         // access to the stack trace
         StackTraceElement[] trace = e.getStackTrace();
         System.err.println(trace[0].toString());
      }
   }
  
   public static void raiseException()throws Exception {

      Exception t = new Exception("This is new Exception...");
      StackTraceElement[] trace = new StackTraceElement[] {
         new StackTraceElement("ClassName","methodName","fileName",10)
      };

      // sets the stack trace elements
      t.setStackTrace(trace);
      throw t;
   }
}

Output

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

ClassName.methodName(fileName:10)

Example: Getting Stacktrace of a RuntimeException

The following example shows the usage of Java Throwable setStackTrace() method. We've defined a method raiseException() which throws an RuntimeException after setting the Stacktrace. In main method, raiseException() method is called and in catch block exception stack trace is retrieved using getStackTrace() method and printed.

package com.tutorialspoint;

public class ThrowableDemo {

   public static void main(String[] args) {

      try {
         raiseException();
      } catch(Throwable e) {
         // access to the stack trace
         StackTraceElement[] trace = e.getStackTrace();
         System.err.println(trace[0].toString());
      }
   }
  
   public static void raiseException()throws RuntimeException {

      RuntimeException t = new RuntimeException("This is new Exception...");
      StackTraceElement[] trace = new StackTraceElement[] {
         new StackTraceElement("ClassName","methodName","fileName",10)
      };

      // sets the stack trace elements
      t.setStackTrace(trace);
      throw t;
   }
}

Output

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

ClassName.methodName(fileName:10)