source/throw.hxx

   1 /**
   2  * @file
   3  *
   4  * Macros related to throwing exceptions.
   5  */
   6
   7 #ifndef LIBSEX_THROW_HXX
   8 #define LIBSEX_THROW_HXX
   9
  10 #include <source/utility.hxx>
  11
  12 /**
  13  * Macro to throw an exception without any argument.
  14  *
  15  * File name and line number are inserted automatically.
  16  *
  17  * @param class Which exception to throw.
  18  */
  19 #define THROW_ARGLESS(class) \
  20 { \
  21         throw libsex::formatted<class>(__FILE__, __LINE__); \
  22 }
  23
  24 /**
  25  * Macro to throw an exception with arguments.
  26  *
  27  * @param class Which exception to throw.
  28  * @param args... Arguments for message template.
  29  * @see THROW_ARGLESS()
  30  */
  31 #define THROW(class, args...) \
  32 { \
  33         throw libsex::formatted<class>(__FILE__, __LINE__, ##args); \
  34 }
  35
  36 /**
  37  * Macro to throw another exception when an exception has
  38  * been caught.
  39  *
  40  * Chains the previous exception and the newly created one
  41  * together.
  42  *
  43  * @note The previous exception has to be accessible in
  44  *       this scope via the variable name @c e.
  45  *
  46  * @param class   Which exception to throw.
  47  * @param args... Arguments for message template.
  48  * @see THROW
  49  */
  50 #define CHAIN(class, args...) \
  51 {\
  52         throw libsex::formatted<class>(e, __FILE__, __LINE__, ##args); \
  53 }
  54
  55 #endif