2012-04-29 20:52:25 +02:00
|
|
|
//
|
|
|
|
// Bugcheck.h
|
|
|
|
//
|
|
|
|
// $Id: //poco/1.4/Foundation/include/Poco/Bugcheck.h#1 $
|
|
|
|
//
|
|
|
|
// Library: Foundation
|
|
|
|
// Package: Core
|
|
|
|
// Module: Bugcheck
|
|
|
|
//
|
|
|
|
// Definition of the Bugcheck class and the self-testing macros.
|
|
|
|
//
|
|
|
|
// Copyright (c) 2004-2006, Applied Informatics Software Engineering GmbH.
|
|
|
|
// and Contributors.
|
|
|
|
//
|
2014-05-04 21:02:42 +02:00
|
|
|
// SPDX-License-Identifier: BSL-1.0
|
2012-04-29 20:52:25 +02:00
|
|
|
//
|
|
|
|
|
|
|
|
|
|
|
|
#ifndef Foundation_Bugcheck_INCLUDED
|
|
|
|
#define Foundation_Bugcheck_INCLUDED
|
|
|
|
|
|
|
|
|
|
|
|
#include "Poco/Foundation.h"
|
|
|
|
#include <string>
|
|
|
|
#if defined(_DEBUG)
|
|
|
|
# include <iostream>
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
namespace Poco {
|
|
|
|
|
|
|
|
|
|
|
|
class Foundation_API Bugcheck
|
|
|
|
/// This class provides some static methods that are
|
|
|
|
/// used by the
|
2014-09-19 08:16:47 +02:00
|
|
|
/// poco_assert_dbg(), poco_assert(), poco_check_ptr(),
|
|
|
|
/// poco_bugcheck() and poco_unexpected() macros.
|
2012-04-29 20:52:25 +02:00
|
|
|
/// You should not invoke these methods
|
|
|
|
/// directly. Use the macros instead, as they
|
|
|
|
/// automatically provide useful context information.
|
|
|
|
{
|
|
|
|
public:
|
2014-11-06 12:04:28 +01:00
|
|
|
static void assertion(const char* cond, const char* file, int line, const char* text = 0);
|
2012-04-29 20:52:25 +02:00
|
|
|
/// An assertion failed. Break into the debugger, if
|
|
|
|
/// possible, then throw an AssertionViolationException.
|
2014-12-09 03:13:20 +01:00
|
|
|
|
2012-04-29 20:52:25 +02:00
|
|
|
static void nullPointer(const char* ptr, const char* file, int line);
|
|
|
|
/// An null pointer was encountered. Break into the debugger, if
|
|
|
|
/// possible, then throw an NullPointerException.
|
|
|
|
|
|
|
|
static void bugcheck(const char* file, int line);
|
|
|
|
/// An internal error was encountered. Break into the debugger, if
|
|
|
|
/// possible, then throw an BugcheckException.
|
|
|
|
|
|
|
|
static void bugcheck(const char* msg, const char* file, int line);
|
|
|
|
/// An internal error was encountered. Break into the debugger, if
|
|
|
|
/// possible, then throw an BugcheckException.
|
|
|
|
|
2014-09-19 08:16:47 +02:00
|
|
|
static void unexpected(const char* file, int line);
|
|
|
|
/// An exception was caught in a destructor. Break into debugger,
|
|
|
|
/// if possible and report exception. Must only be called from
|
|
|
|
/// within a catch () block as it rethrows the exception to
|
|
|
|
/// determine its class.
|
|
|
|
|
2012-04-29 20:52:25 +02:00
|
|
|
static void debugger(const char* file, int line);
|
|
|
|
/// An internal error was encountered. Break into the debugger, if
|
|
|
|
/// possible.
|
|
|
|
|
|
|
|
static void debugger(const char* msg, const char* file, int line);
|
|
|
|
/// An internal error was encountered. Break into the debugger, if
|
|
|
|
/// possible.
|
|
|
|
|
|
|
|
protected:
|
2014-11-06 12:04:28 +01:00
|
|
|
static std::string what(const char* msg, const char* file, int line, const char* text = 0);
|
2012-04-29 20:52:25 +02:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
} // namespace Poco
|
|
|
|
|
|
|
|
|
|
|
|
//
|
|
|
|
// useful macros (these automatically supply line number and file name)
|
|
|
|
//
|
|
|
|
#if defined(_DEBUG)
|
|
|
|
#define poco_assert_dbg(cond) \
|
|
|
|
if (!(cond)) Poco::Bugcheck::assertion(#cond, __FILE__, __LINE__); else (void) 0
|
2014-10-15 04:37:12 +02:00
|
|
|
|
2014-11-06 12:04:28 +01:00
|
|
|
#define poco_assert_msg_dbg(cond, text) \
|
2014-10-15 04:37:12 +02:00
|
|
|
if (!(cond)) Poco::Bugcheck::assertion(#cond, __FILE__, __LINE__, text); else (void) 0
|
2012-04-29 20:52:25 +02:00
|
|
|
#else
|
2014-11-06 12:04:28 +01:00
|
|
|
#define poco_assert_msg_dbg(cond, text)
|
2012-04-29 20:52:25 +02:00
|
|
|
#define poco_assert_dbg(cond)
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
#define poco_assert(cond) \
|
|
|
|
if (!(cond)) Poco::Bugcheck::assertion(#cond, __FILE__, __LINE__); else (void) 0
|
|
|
|
|
2014-11-06 12:04:28 +01:00
|
|
|
|
2014-10-15 04:37:12 +02:00
|
|
|
#define poco_assert_msg(cond, text) \
|
|
|
|
if (!(cond)) Poco::Bugcheck::assertion(#cond, __FILE__, __LINE__, text); else (void) 0
|
2012-04-29 20:52:25 +02:00
|
|
|
|
2014-11-06 12:04:28 +01:00
|
|
|
|
2012-04-29 20:52:25 +02:00
|
|
|
#define poco_check_ptr(ptr) \
|
|
|
|
if (!(ptr)) Poco::Bugcheck::nullPointer(#ptr, __FILE__, __LINE__); else (void) 0
|
|
|
|
|
|
|
|
|
|
|
|
#define poco_bugcheck() \
|
|
|
|
Poco::Bugcheck::bugcheck(__FILE__, __LINE__)
|
|
|
|
|
|
|
|
|
|
|
|
#define poco_bugcheck_msg(msg) \
|
|
|
|
Poco::Bugcheck::bugcheck(msg, __FILE__, __LINE__)
|
2014-12-09 03:13:20 +01:00
|
|
|
|
|
|
|
|
2014-09-19 08:16:47 +02:00
|
|
|
#define poco_unexpected() \
|
|
|
|
Poco::Bugcheck::unexpected(__FILE__, __LINE__);
|
2012-04-29 20:52:25 +02:00
|
|
|
|
|
|
|
|
|
|
|
#define poco_debugger() \
|
|
|
|
Poco::Bugcheck::debugger(__FILE__, __LINE__)
|
|
|
|
|
|
|
|
|
|
|
|
#define poco_debugger_msg(msg) \
|
|
|
|
Poco::Bugcheck::debugger(msg, __FILE__, __LINE__)
|
|
|
|
|
|
|
|
|
|
|
|
#if defined(_DEBUG)
|
|
|
|
# define poco_stdout_dbg(outstr) \
|
|
|
|
std::cout << __FILE__ << '(' << std::dec << __LINE__ << "):" << outstr << std::endl;
|
|
|
|
#else
|
|
|
|
# define poco_stdout_dbg(outstr)
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
#if defined(_DEBUG)
|
|
|
|
# define poco_stderr_dbg(outstr) \
|
|
|
|
std::cerr << __FILE__ << '(' << std::dec << __LINE__ << "):" << outstr << std::endl;
|
|
|
|
#else
|
|
|
|
# define poco_stderr_dbg(outstr)
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
//
|
|
|
|
// poco_static_assert
|
2014-12-09 03:13:20 +01:00
|
|
|
//
|
2012-04-29 20:52:25 +02:00
|
|
|
// The following was ported from <boost/static_assert.hpp>
|
|
|
|
//
|
|
|
|
|
|
|
|
|
2015-01-06 05:20:58 +01:00
|
|
|
#if defined(POCO_COMPILER_GCC) && (((__GNUC__ * 100) + __GNUC_MINOR__) >= 406)
|
2015-01-02 05:47:03 +01:00
|
|
|
GCC_DIAG_OFF(unused-local-typedefs) // supress numerous gcc warnings
|
2015-01-06 05:20:58 +01:00
|
|
|
#endif // POCO_COMPILER_GCC && (((__GNUC__ * 100) + __GNUC_MINOR__) >= 406)
|
2014-12-09 03:13:20 +01:00
|
|
|
|
|
|
|
|
2012-04-29 20:52:25 +02:00
|
|
|
template <bool x>
|
|
|
|
struct POCO_STATIC_ASSERTION_FAILURE;
|
|
|
|
|
|
|
|
|
2014-12-09 03:13:20 +01:00
|
|
|
template <>
|
|
|
|
struct POCO_STATIC_ASSERTION_FAILURE<true>
|
2012-04-29 20:52:25 +02:00
|
|
|
{
|
2014-12-09 03:13:20 +01:00
|
|
|
enum
|
|
|
|
{
|
|
|
|
value = 1
|
|
|
|
};
|
2012-04-29 20:52:25 +02:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
template <int x>
|
|
|
|
struct poco_static_assert_test
|
|
|
|
{
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
#if defined(__GNUC__) && (__GNUC__ == 3) && ((__GNUC_MINOR__ == 3) || (__GNUC_MINOR__ == 4))
|
|
|
|
#define poco_static_assert(B) \
|
|
|
|
typedef char POCO_JOIN(poco_static_assert_typedef_, __LINE__) \
|
|
|
|
[POCO_STATIC_ASSERTION_FAILURE<(bool) (B)>::value]
|
|
|
|
#else
|
|
|
|
#define poco_static_assert(B) \
|
|
|
|
typedef poco_static_assert_test<sizeof(POCO_STATIC_ASSERTION_FAILURE<(bool) (B)>)> \
|
|
|
|
POCO_JOIN(poco_static_assert_typedef_, __LINE__)
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
#endif // Foundation_Bugcheck_INCLUDED
|