1 /* Copyright (c) 2005-2017. The SimGrid Team.
2 * All rights reserved. */
4 /* Copyright (c) 2002-2004 Ralf S. Engelschall <rse@engelschall.com> */
5 /* Copyright (c) 2002-2004 The OSSP Project <http://www.ossp.org/> */
6 /* Copyright (c) 2002-2004 Cable & Wireless <http://www.cw.com/> */
7 /* All rights reserved. */
9 /* This code is inspirated from the OSSP version (as retrieved back in 2004)*/
10 /* It was heavily modified to fit the SimGrid framework. */
12 /* The OSSP version has the following copyright notice:
13 ** OSSP ex - Exception Handling
14 ** Copyright (c) 2002-2004 Ralf S. Engelschall <rse@engelschall.com>
15 ** Copyright (c) 2002-2004 The OSSP Project <http://www.ossp.org/>
16 ** Copyright (c) 2002-2004 Cable & Wireless <http://www.cw.com/>
18 ** This file is part of OSSP ex, an exception handling library
19 ** which can be found at http://www.ossp.org/pkg/lib/ex/.
21 ** Permission to use, copy, modify, and distribute this software for
22 ** any purpose with or without fee is hereby granted, provided that
23 ** the above copyright notice and this permission notice appear in all
26 ** THIS SOFTWARE IS PROVIDED `AS IS'' AND ANY EXPRESSED OR IMPLIED
27 ** WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
28 ** MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
29 ** IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
30 ** CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
31 ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
32 ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
33 ** USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
34 ** ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
35 ** OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
36 ** OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
40 /* The extensions made for the SimGrid project can either be distributed */
41 /* under the same license, or under the LGPL v2.1 */
43 #ifndef SIMGRID_XBT_EX_HPP
44 #define SIMGRID_XBT_EX_HPP
47 #include <xbt/exception.hpp>
51 /** A legacy exception
53 * It is defined by a category and a value within that category (as well as
54 * an optional error message).
56 * This used to be a structure for C exceptions but it has been retrofitted
57 * as a C++ exception and some of its data has been moved in the
58 * @ref WithContextException base class. We should deprecate it and replace it
59 * with either C++ different exceptions or `std::system_error` which already
60 * provides this (category + error code) logic.
64 struct XBT_PUBLIC() xbt_ex :
66 simgrid::xbt::WithContextException {
69 std::runtime_error("")
74 * @param throwpoint Throw point (use XBT_THROW_POINT)
75 * @param message Exception message
77 xbt_ex(simgrid::xbt::ThrowPoint throwpoint, const char* message) :
78 std::runtime_error(message),
79 simgrid::xbt::WithContextException(throwpoint, simgrid::xbt::backtrace())
84 /** Category (what went wrong) */
85 xbt_errcat_t category = unknown_error;
87 /** Why did it went wrong */