1/**
2 * Copyright (c) 2006-2023 LOVE Development Team
3 *
4 * This software is provided 'as-is', without any express or implied
5 * warranty. In no event will the authors be held liable for any damages
6 * arising from the use of this software.
7 *
8 * Permission is granted to anyone to use this software for any purpose,
9 * including commercial applications, and to alter it and redistribute it
10 * freely, subject to the following restrictions:
11 *
12 * 1. The origin of this software must not be misrepresented; you must not
13 * claim that you wrote the original software. If you use this software
14 * in a product, an acknowledgment in the product documentation would be
15 * appreciated but is not required.
16 * 2. Altered source versions must be plainly marked as such, and must not be
17 * misrepresented as being the original software.
18 * 3. This notice may not be removed or altered from any source distribution.
19 **/
20
21#ifndef LOVE_EXCEPTION_H
22#define LOVE_EXCEPTION_H
23
24#include <exception>
25#include <cstdarg> // vararg
26#include <cstdio> // vsnprintf
27#include <cstring> // strncpy
28#include <string>
29
30namespace love
31{
32
33/**
34 * A convenient vararg-enabled exception class.
35 **/
36class Exception : public std::exception
37{
38public:
39
40 /**
41 * Creates a new Exception according to printf-rules.
42 *
43 * See: http://www.cplusplus.com/reference/clibrary/cstdio/printf/
44 *
45 * @param fmt The format string (see printf).
46 **/
47 Exception(const char *fmt, ...);
48 virtual ~Exception() throw();
49
50 /**
51 * Returns a string containing reason for the exception.
52 * @return A description of the exception.
53 **/
54 inline virtual const char *what() const throw()
55 {
56 return message.c_str();
57 }
58
59private:
60
61 std::string message;
62
63}; // Exception
64
65} // love
66
67#endif // LOVE_EXCEPTION_H
68