How to create user-defined exception (xtd.core)

xtd provides a hierarchy of exception classes ultimately derived from the Exception base class. However, if none of the predefined exceptions meet your needs, you can create your own exception class by deriving from the xtd::exception class.

When creating your own exceptions, end the class name of the user-defined exception with the word "_exception", and implement the three common constructors, as shown in the following example. The example defines a new exception class named employee_list_not_found_exception. The class is derived from the xtd::exception base class and includes three constructors.

#include <xtd/exception>

using namespace xtd;
using namespace xtd::diagnostics;

class employee_list_not_found_exception : public exception {
public:
  employee_list_not_found_exception(const stack_frame& frame = stack_frame::current()) : exception {"The employee list does not exist."_t, frame} {
  }

  employee_list_not_found_exception(const string& message, const stack_frame& frame = stack_frame::current()) : exception {message, frame} {
  }

  template<typename exception_t>
  employee_list_not_found_exception(const string& message, const exception_t& inner, const stack_frame& frame = stack_frame::current()) : exception {message, inner, frame} {
  }
};

[!NOTE] In situations where you're using remoting, you must ensure that the metadata for any user-defined exceptions is available at the server (callee) and to the client (the proxy object or caller). For more information, see Best practices for exceptions.

How to create user-defined exception (xtd.core)

See also