About

All error types of the MAXON API are based on the maxon::ErrorInterface. This interface defines functions to set and get the information stored in the error object.

For creating new error types based on this interface see Error Types and Interface Basics.

Error Class

Basic information stored in an error object is accessed with:

maxon::ErrorInterface::GetLocation(): Returns the source code location of the error.
maxon::ErrorInterface::SetLocation(): Sets the source code location of the error.
maxon::ErrorInterface::GetMessage(): Returns the error message.
maxon::ErrorInterface::SetMessage(): Sets the error message.

The following data may or may not be set, depending on the error:

maxon::ErrorInterface::GetStackTrace(): Returns the stack trace.
maxon::ErrorInterface::SetStackTrace(): Sets the stack trace.
maxon::ErrorInterface::GetCause(): Returns the cause.
maxon::ErrorInterface::SetCause(): Sets the cause.
maxon::ErrorInterface::GetMachine(): Returns the machine that caused the error.
maxon::ErrorInterface::SetMachine(): Sets the machine that caused the error.

  // This example gets the error from the maxon::Result object and prints it in a custom way.
 
  const maxon::Result<maxon::Int> res = GetRandomNumber();
 
  if (res == maxon::FAILED)
  {
    const maxon::Error error = res.GetError();
 
    // get info on the error
    const maxon::String         message  = error.GetMessage();
    const maxon::SourceLocation location = error.GetLocation();
    const maxon::String         file(location.file);
 
    // print
    DiagnosticOutput("Error \"@\" in file @", message, file);
  }

Additionally, error objects provide these functions:

DbgStop(): Triggers a debug stop (DebugOutput()).
CritStop(): Triggers a critical stop (CriticalOutput()).
DiagOutput(): Prints the error to the console (DiagnosticOutput()).

// This example calls a sub-function and returns an UnexpectedError in case of an failure.
// If an error is returned, a debug stop is triggered.
 
static maxon::Result<void> CallAction()
{
  if (Action() == false)
  {
    return maxon::UnexpectedError(MAXON_SOURCE_LOCATION, "Could not perform action."_s).DbgStop();
  }
 
  return maxon::OK;
}

  // This example calls a function that may fail.
  // If an error occurred, the error is printed to the console.
 
  iferr (CallAction())
  {
    // print error
    err.DiagOutput();
  }

Table of Contents

About

Error Class

Further Reading