com.oracle.truffle.api

Interface TruffleException

Deprecated.

Use AbstractTruffleException as a base class for Truffle exceptions.

@Deprecated
public interface TruffleException

Represents an exception thrown during the execution of a guest language program. All exceptions thrown in a guest language implementation that are not implementing TruffleException are considered internal errors.

TruffleException is most efficient if the cause is left uninitialized. Implementations of TruffleException also should not prevent initialization of the exception cause, e.g., by overriding Throwable.initCause(Throwable).

In order to be efficient, a TruffleException should override Throwable.fillInStackTrace() without the synchronized modifier, so that it returns this:

 @SuppressWarnings("sync-override")
 @Override
 public final Throwable fillInStackTrace() {
     return this;
 }
 

Since:

0.27

See Also:

TruffleStackTrace to access the stack trace of an exception.