include/xbt/exception.hpp

   1 /* Copyright (c) 2005-2018. The SimGrid Team.All rights reserved. */
   2
   3 /* This program is free software; you can redistribute it and/or modify it
   4  * under the terms of the license (GNU LGPL) which comes with this package. */
   5
   6 #ifndef SIMGRID_XBT_EXCEPTION_HPP
   7 #define SIMGRID_XBT_EXCEPTION_HPP
   8
   9 #include <string>
  10 #include <type_traits>
  11 #include <vector>
  12
  13 #include <xbt/base.h>
  14 #include <xbt/backtrace.h>
  15 #include <xbt/backtrace.hpp>
  16 #include <xbt/log.h>
  17 #include <xbt/misc.h>  // xbt_procname
  18 #include <xbt/virtu.h> // xbt_getpid
  19
  20 /** @addtogroup XBT_ex
  21  *  @brief Exceptions support
  22  */
  23
  24 namespace simgrid {
  25 namespace xbt {
  26
  27 /** A backtrace
  28  *
  29  *  This is used (among other things) in exceptions to store the associated
  30  *  backtrace.
  31  *
  32  *  @ingroup XBT_ex
  33  */
  34 typedef std::vector<xbt_backtrace_location_t> Backtrace;
  35
  36 /** The location of where an exception has been throwed
  37  *
  38  *  This is a tuple (__FILE__, __LINE__, __func__) and can be created with
  39  *  @ref XBT_THROW_POINT.
  40  *
  41  *  @ingroup XBT_ex
  42  */
  43 class ThrowPoint {
  44  public:
  45   ThrowPoint() = default;
  46   explicit ThrowPoint(const char* file, int line, const char* function) : file(file), line(line), function(function) {}
  47   const char* file = nullptr;
  48   int line = 0;
  49   const char* function = nullptr;
  50 };
  51
  52 /** Create a ThrowPoint with (__FILE__, __LINE__, __func__) */
  53 #define XBT_THROW_POINT ::simgrid::xbt::ThrowPoint(__FILE__, __LINE__, __func__)
  54
  55 /** A base class for exceptions with context
  56  *
  57  *  This is a base class for exceptions which store additional contextual
  58  *  information: backtrace, throw point, simulated process name, PID, etc.
  59  *
  60  *  You are not expected to inherit from it. Instead of you use should
  61  *  @ref XBT_THROW an exception which will throw a subclass of your original
  62  *  exception with those additional features.
  63  *
  64  *  However, you can try `dynamic_cast` an exception to this type in order to
  65  *  get contextual information about the exception.
  66  */
  67 class XBT_PUBLIC WithContextException {
  68 public:
  69   WithContextException() :
  70     backtrace_(simgrid::xbt::backtrace()),
  71     procname_(xbt_procname()),
  72     pid_(xbt_getpid())
  73   {}
  74   explicit WithContextException(Backtrace bt) : backtrace_(std::move(bt)), procname_(xbt_procname()), pid_(xbt_getpid())
  75   {}
  76   explicit WithContextException(ThrowPoint throwpoint, Backtrace bt)
  77       : backtrace_(std::move(bt)), procname_(xbt_procname()), pid_(xbt_getpid()), throwpoint_(throwpoint)
  78   {}
  79   virtual ~WithContextException();
  80   Backtrace const& backtrace() const
  81   {
  82     return backtrace_;
  83   }
  84   int pid() const { return pid_; }
  85   std::string const& process_name() const { return procname_; }
  86   ThrowPoint& throw_point() { return throwpoint_; }
  87
  88   // deprecated
  89   XBT_ATTRIB_DEPRECATED_v323("Please use WithContextException::process_name()") std::string const& processName() const
  90   {
  91     return process_name();
  92   }
  93   XBT_ATTRIB_DEPRECATED_v323("Please use WithContextException::throw_point()") ThrowPoint& throwPoint()
  94   {
  95     return throw_point();
  96   }
  97
  98 private:
  99   Backtrace backtrace_;
 100   std::string procname_; /**< Name of the process who thrown this */
 101   int pid_;              /**< PID of the process who thrown this */
 102   ThrowPoint throwpoint_;
 103 };
 104 }
 105 }
 106
 107 #endif