Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Update copyright lines for 2022.
[simgrid.git] / include / xbt / backtrace.hpp
index ca3f282..4e53a8f 100644 (file)
@@ -1,38 +1,43 @@
-/* Copyright (c) 2005-2019. The SimGrid Team.
- * All rights reserved. */
+/* Copyright (c) 2005-2022. The SimGrid Team. All rights reserved.          */
 
-#ifndef SIMGRIX_XBT_BACKTRACE_HPP
-#define SIMGRIX_XBT_BACKTRACE_HPP
+/* This program is free software; you can redistribute it and/or modify it
+ * under the terms of the license (GNU LGPL) which comes with this package. */
 
-#include <cstddef>
+#ifndef SIMGRID_XBT_BACKTRACE_HPP
+#define SIMGRID_XBT_BACKTRACE_HPP
 
-#include <string>
+#include <xbt/base.h>
+
+#include <functional>
 #include <memory>
-#include <vector>
+#include <string>
 
-#include <xbt/base.h>
-#include <xbt/backtrace.h>
+SG_BEGIN_DECL
+/** @brief Shows a backtrace of the current location */
+XBT_PUBLIC void xbt_backtrace_display_current();
+SG_END_DECL
 
 namespace simgrid {
 namespace xbt {
 
-/** Try to demangle a C++ name
+class BacktraceImpl;
+/** A backtrace
  *
- *  Return the origin string if this fails.
- */
-XBT_PUBLIC() std::unique_ptr<char, void(*)(void*)> demangle(const char* name);
-
-/** Get the current backtrace */
-XBT_PUBLIC(std::vector<xbt_backtrace_location_t>) backtrace();
-
-/* Translate the backtrace in a human friendly form
+ *  This is used (among other things) in exceptions to store the associated
+ *  backtrace.
  *
- *  Try ro resolve symbols and source code location.
+ *  @ingroup XBT_ex
  */
-XBT_PUBLIC(std::vector<std::string>) resolveBacktrace(
-  xbt_backtrace_location_t const* loc, std::size_t count);
+class Backtrace {
+public:
+  std::shared_ptr<BacktraceImpl> impl_;
+  Backtrace();
+  /** @brief Translate the backtrace in a human friendly form, unmangled with source code locations. */
+  std::string resolve() const;
+  /** @brief Display the resolved backtrace on stderr */
+  void display() const;
+};
 
 }
 }
-
 #endif