mirror of
https://github.com/ETLCPP/etl.git
synced 2026-04-30 19:09:10 +08:00
124 lines
5.0 KiB
C++
124 lines
5.0 KiB
C++
|
|
///\file
|
|
|
|
/******************************************************************************
|
|
The MIT License(MIT)
|
|
|
|
Embedded Template Library.
|
|
https://github.com/ETLCPP/etl
|
|
http://www.etlcpp.com
|
|
|
|
Copyright(c) 2014 jwellbelove
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files(the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions :
|
|
|
|
The above copyright notice and this permission notice shall be included in all
|
|
copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
SOFTWARE.
|
|
******************************************************************************/
|
|
|
|
#ifndef __ETL_ERROR_HANDLER__
|
|
#define __ETL_ERROR_HANDLER__
|
|
|
|
///\defgroup error_handler error_handler
|
|
/// Error handler for when throwing exceptions is not required.
|
|
///\ingroup utilities
|
|
|
|
#include <assert.h>
|
|
|
|
#include "exception.h"
|
|
#include "function.h"
|
|
|
|
namespace etl
|
|
{
|
|
//***************************************************************************
|
|
/// Error handler for when throwing exceptions is not required.
|
|
///\ingroup error_handler
|
|
//***************************************************************************
|
|
class error_handler
|
|
{
|
|
public:
|
|
|
|
//*************************************************************************
|
|
/// Callback class for free handler functions.
|
|
//*************************************************************************
|
|
struct free_function : public function<void, const etl::exception&>
|
|
{
|
|
free_function(void (*p_function)(const etl::exception&))
|
|
: etl::function<void, const etl::exception&>(p_function)
|
|
{
|
|
}
|
|
};
|
|
|
|
//*************************************************************************
|
|
/// Callback class for member handler functions.
|
|
//*************************************************************************
|
|
template <typename TObject>
|
|
struct member_function : public etl::function<TObject, const etl::exception&>
|
|
{
|
|
member_function(TObject& object, void(TObject::*p_function)(const etl::exception&))
|
|
: etl::function<TObject, const etl::exception&>(object, p_function)
|
|
{
|
|
}
|
|
};
|
|
|
|
static void set_callback(ifunction<const etl::exception&>& f);
|
|
static void error(const etl::exception& e);
|
|
|
|
private:
|
|
|
|
static ifunction<const etl::exception&>* p_ifunction;
|
|
};
|
|
}
|
|
|
|
//***************************************************************************
|
|
/// Asserts a coondition.
|
|
/// Versions of the macro that return a constant value of 'true' will allow the compiler to optimise away
|
|
/// any 'if' statements that it is contained within.
|
|
/// If ETL_NO_CHECKS is defined then no runtime checks are executed at all.
|
|
/// If ETL_THROW_EXCEPTIONS is defined then the error is thrown if the assert fails. The return value is always 'true'.
|
|
/// If ETL_LOG_ERRORS is defined then the error is logged if the assert fails. The return value is the value of the boolean test.
|
|
/// Otherwise 'assert' is called. The return value is always 'true'.
|
|
///\ingroup error_handler
|
|
//***************************************************************************
|
|
#if defined(ETL_NO_CHECKS)
|
|
#define ETL_ASSERT(b, e) (true) // Does nothing. Evaluates to 'true'.
|
|
#elif defined(ETL_THROW_EXCEPTIONS)
|
|
#define ETL_ASSERT(b, e) (((b) ? true : throw((e))), true) // Throws an exception if the condition fails. Evaluates to 'true'.
|
|
#elif defined(ETL_LOG_ERRORS)
|
|
#define ETL_ASSERT(b, e) (((b) ? true : etl::error_handler::error((e))), (b)) // Logs the error if the condition fails. Evaluates to the result of the condition.
|
|
#else
|
|
#if defined(NDEBUG)
|
|
#define ETL_ASSERT(b, e) (true) // Does nothing. Evaluates to 'true'.
|
|
#else
|
|
#define ETL_ASSERT(b, e) ((assert((b))), true) // Asserts if the condition fails. Evaluates to 'true'.
|
|
#endif
|
|
#endif
|
|
|
|
#if defined(ETL_VERBOSE_ERRORS)
|
|
#define ETL_ERROR(e) (e(__FILE__, __LINE__)) // Make an exception with the file name and line number.
|
|
#else
|
|
#define ETL_ERROR(e) (e("", __LINE__)) // Make an exception with the line number.
|
|
#endif
|
|
|
|
#if defined(ETL_VERBOSE_ERRORS)
|
|
#define ETL_ERROR_TEXT(verbose_text, terse_text) (verbose_text) // Use the verbose text.
|
|
#else
|
|
#define ETL_ERROR_TEXT(verbose_text, terse_text) (terse_text) // Use the terse text.
|
|
#endif
|
|
|
|
#endif
|
|
|