org.openquark.cal.runtime
Class CALExecutorException.ExternalException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          org.openquark.cal.runtime.CALExecutorException
              org.openquark.cal.runtime.CALExecutorException.ExternalException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

CALExecutorException.ExternalException.ErrorFunctionException, CALExecutorException.ExternalException.ForeignOrPrimitiveFunctionException, CALExecutorException.ExternalException.PatternMatchFailure, CALExecutorException.ExternalException.PrimThrowFunctionException, CALExecutorException.ExternalException.TerminatedByClientException

Enclosing class:

CALExecutorException

public abstract static class CALExecutorException.ExternalException
extends CALExecutorException

A base class for external exceptions. All programmatic exceptions are types of CALProgramException.

External errors can originate via:

1. A call to the CAL Prelude.error function.
2. A foreign function generates an exception.
3. An arithmetic exception, such as divide by zero, occurs in evaluating the CAL code.
4. A pattern matching failure e.g. given the definition,

        f x = case x of LT -> "LT data cons";;
        

   then f GT will produce a pattern match exception.

A program exception can be either non-terminating (a call to the 'Error' function) or terminating.

See Also:

Serialized Form

Nested Class Summary

static class	CALExecutorException.ExternalException.ErrorFunctionException ErrorException is thrown by the CAL Prelude.error function.
static class	CALExecutorException.ExternalException.ForeignOrPrimitiveFunctionException ForeignOrPrimitiveFunctionException is a wrapper to catch exceptions thrown by foreign or primitive functions (such as Prelude.divideInt for division by zero).
static class	CALExecutorException.ExternalException.PatternMatchFailure CALPatternMatchException is thrown for pattern matching failures.
static class	CALExecutorException.ExternalException.PrimThrowFunctionException PrimThrowFunctionException is thrown by the Exception.primThrow function used to implement exception handling in CAL code.
static class	CALExecutorException.ExternalException.TerminatedByClientException CALForeignFunctionException is thrown in response to a client (e.g. user) terminating execution.

Nested classes/interfaces inherited from class org.openquark.cal.runtime.CALExecutorException

CALExecutorException.ExternalException, CALExecutorException.InternalException, CALExecutorException.Type

Constructor Summary

CALExecutorException.ExternalException(ErrorInfo errorInfo, String message, Throwable cause)

CALExecutorException.ExternalException(String message, Throwable cause)

Method Summary

boolean

isExternal() Return true if this is an external exception (i.e. an error was generated by the CAL source program)

Methods inherited from class org.openquark.cal.runtime.CALExecutorException

getErrorInfo, getExceptionType, getMessage

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CALExecutorException.ExternalException

public CALExecutorException.ExternalException(String message,
                                              Throwable cause)

CALExecutorException.ExternalException

public CALExecutorException.ExternalException(ErrorInfo errorInfo,
                                              String message,
                                              Throwable cause)

Method Detail

isExternal

public final boolean isExternal()

Return true if this is an external exception (i.e. an error was generated by the CAL source program)

Specified by:

isExternal in class CALExecutorException

Returns:

boolean