exception.h
1 /*
2 ** ClanLib SDK
3 ** Copyright (c) 1997-2015 The ClanLib Team
4 **
5 ** This software is provided 'as-is', without any express or implied
6 ** warranty. In no event will the authors be held liable for any damages
7 ** arising from the use of this software.
8 **
9 ** Permission is granted to anyone to use this software for any purpose,
10 ** including commercial applications, and to alter it and redistribute it
11 ** freely, subject to the following restrictions:
12 **
13 ** 1. The origin of this software must not be misrepresented; you must not
14 ** claim that you wrote the original software. If you use this software
15 ** in a product, an acknowledgment in the product documentation would be
16 ** appreciated but is not required.
17 ** 2. Altered source versions must be plainly marked as such, and must not be
18 ** misrepresented as being the original software.
19 ** 3. This notice may not be removed or altered from any source distribution.
20 **
21 ** Note: Some of the libraries ClanLib may link to may have additional
22 ** requirements or restrictions.
23 **
24 ** File Author(s):
25 **
26 ** Magnus Norddahl
27 */
28 
29 
30 #pragma once
31 
32 #include <vector>
33 #include <stdexcept>
34 #include <string>
35 
36 namespace clan
37 {
40 
42 class Exception : public std::exception
43 {
46 public:
48  Exception(const std::string &message);
49 
51  virtual ~Exception() throw() {}
52 
56 public:
58  std::string message;
59 
61  virtual const char* what() const throw() override;
62 
66 public:
68 
69  std::vector<std::string> get_stack_trace() const;
70 
72 
73  std::string get_message_and_stack_trace() const;
74 
78 private:
79  enum { max_frames = 32 };
80  mutable void *frames[max_frames];
81  int num_frames;
82  mutable std::string buffer;
84 };
85 
86 }
87 
std::string message
Description of exception.
Definition: exception.h:58
virtual const char * what() const override
Returns description of exception.
Definition: clanapp.h:36
std::vector< std::string > get_stack_trace() const
Returns the call stack present when the exception object was created.
virtual ~Exception()
Destructs an exception object.
Definition: exception.h:51
Top-level exception class.
Definition: exception.h:43
Exception(const std::string &message)
Constructs an exception object.
std::string get_message_and_stack_trace() const
Returns the message and call stack present when the exception object was created, formatted using new...