| ... | ... |
@@ -60,202 +60,192 @@ |
| 60 | 60 |
} |
| 61 | 61 |
} |
| 62 | 62 |
|
| 63 | 63 |
#endif // LEMON_ASSERT_H |
| 64 | 64 |
|
| 65 | 65 |
#undef LEMON_ASSERT |
| 66 | 66 |
#undef LEMON_FIXME |
| 67 | 67 |
#undef LEMON_DEBUG |
| 68 | 68 |
|
| 69 | 69 |
#if (defined(LEMON_ASSERT_LOG) ? 1 : 0) + \ |
| 70 | 70 |
(defined(LEMON_ASSERT_ABORT) ? 1 : 0) + \ |
| 71 | 71 |
(defined(LEMON_ASSERT_CUSTOM) ? 1 : 0) > 1 |
| 72 | 72 |
#error "LEMON assertion system is not set properly" |
| 73 | 73 |
#endif |
| 74 | 74 |
|
| 75 | 75 |
#if ((defined(LEMON_ASSERT_LOG) ? 1 : 0) + \ |
| 76 | 76 |
(defined(LEMON_ASSERT_ABORT) ? 1 : 0) + \ |
| 77 | 77 |
(defined(LEMON_ASSERT_CUSTOM) ? 1 : 0) == 1 || \ |
| 78 | 78 |
defined(LEMON_ENABLE_ASSERTS)) && \ |
| 79 | 79 |
(defined(LEMON_DISABLE_ASSERTS) || \ |
| 80 | 80 |
defined(NDEBUG)) |
| 81 | 81 |
#error "LEMON assertion system is not set properly" |
| 82 | 82 |
#endif |
| 83 | 83 |
|
| 84 | 84 |
|
| 85 | 85 |
#if defined LEMON_ASSERT_LOG |
| 86 | 86 |
# undef LEMON_ASSERT_HANDLER |
| 87 | 87 |
# define LEMON_ASSERT_HANDLER ::lemon::assert_fail_log |
| 88 | 88 |
#elif defined LEMON_ASSERT_ABORT |
| 89 | 89 |
# undef LEMON_ASSERT_HANDLER |
| 90 | 90 |
# define LEMON_ASSERT_HANDLER ::lemon::assert_fail_abort |
| 91 | 91 |
#elif defined LEMON_ASSERT_CUSTOM |
| 92 | 92 |
# undef LEMON_ASSERT_HANDLER |
| 93 | 93 |
# ifndef LEMON_CUSTOM_ASSERT_HANDLER |
| 94 | 94 |
# error "LEMON_CUSTOM_ASSERT_HANDLER is not set" |
| 95 | 95 |
# endif |
| 96 | 96 |
# define LEMON_ASSERT_HANDLER LEMON_CUSTOM_ASSERT_HANDLER |
| 97 | 97 |
#elif defined LEMON_DISABLE_ASSERTS |
| 98 | 98 |
# undef LEMON_ASSERT_HANDLER |
| 99 | 99 |
#elif defined NDEBUG |
| 100 | 100 |
# undef LEMON_ASSERT_HANDLER |
| 101 | 101 |
#else |
| 102 | 102 |
# define LEMON_ASSERT_HANDLER ::lemon::assert_fail_abort |
| 103 | 103 |
#endif |
| 104 | 104 |
|
| 105 | 105 |
#ifndef LEMON_FUNCTION_NAME |
| 106 | 106 |
# if defined __GNUC__ |
| 107 | 107 |
# define LEMON_FUNCTION_NAME (__PRETTY_FUNCTION__) |
| 108 | 108 |
# elif defined _MSC_VER |
| 109 | 109 |
# define LEMON_FUNCTION_NAME (__FUNCSIG__) |
| 110 | 110 |
# else |
| 111 | 111 |
# define LEMON_FUNCTION_NAME (__func__) |
| 112 | 112 |
# endif |
| 113 | 113 |
#endif |
| 114 | 114 |
|
| 115 | 115 |
#ifdef DOXYGEN |
| 116 | 116 |
|
| 117 | 117 |
/// \ingroup exceptions |
| 118 | 118 |
/// |
| 119 | 119 |
/// \brief Macro for assertion with customizable message |
| 120 | 120 |
/// |
| 121 | 121 |
/// Macro for assertion with customizable message. \param exp An |
| 122 | 122 |
/// expression that must be convertible to \c bool. If it is \c |
| 123 | 123 |
/// false, then an assertion is raised. The concrete behaviour depends |
| 124 | 124 |
/// on the settings of the assertion system. \param msg A <tt>const |
| 125 | 125 |
/// char*</tt> parameter, which can be used to provide information |
| 126 | 126 |
/// about the circumstances of the failed assertion. |
| 127 | 127 |
/// |
| 128 | 128 |
/// The assertions are enabled in the default behaviour. |
| 129 | 129 |
/// You can disable them with the following code: |
| 130 | 130 |
/// \code |
| 131 | 131 |
/// #define LEMON_DISABLE_ASSERTS |
| 132 | 132 |
/// \endcode |
| 133 | 133 |
/// or with compilation parameters: |
| 134 | 134 |
/// \code |
| 135 | 135 |
/// g++ -DLEMON_DISABLE_ASSERTS |
| 136 | 136 |
/// make CXXFLAGS='-DLEMON_DISABLE_ASSERTS' |
| 137 | 137 |
/// \endcode |
| 138 | 138 |
/// The checking is also disabled when the standard macro \c NDEBUG is defined. |
| 139 | 139 |
/// |
| 140 | 140 |
/// The LEMON assertion system has a wide range of customization |
| 141 | 141 |
/// properties. As a default behaviour the failed assertion prints a |
| 142 | 142 |
/// short log message to the standard error and aborts the execution. |
| 143 | 143 |
/// |
| 144 | 144 |
/// The following modes can be used in the assertion system: |
| 145 | 145 |
/// |
| 146 | 146 |
/// - \c LEMON_ASSERT_LOG The failed assertion prints a short log |
| 147 | 147 |
/// message to the standard error and continues the execution. |
| 148 | 148 |
/// - \c LEMON_ASSERT_ABORT This mode is similar to the \c |
| 149 | 149 |
/// LEMON_ASSERT_LOG, but it aborts the program. It is the default |
| 150 | 150 |
/// behaviour. |
| 151 | 151 |
/// - \c LEMON_ASSERT_CUSTOM The user can define own assertion handler |
| 152 | 152 |
/// function. |
| 153 | 153 |
/// \code |
| 154 | 154 |
/// void custom_assert_handler(const char* file, int line, |
| 155 | 155 |
/// const char* function, const char* message, |
| 156 | 156 |
/// const char* assertion); |
| 157 | 157 |
/// \endcode |
| 158 | 158 |
/// The name of the function should be defined as the \c |
| 159 | 159 |
/// LEMON_CUSTOM_ASSERT_HANDLER macro name. |
| 160 | 160 |
/// \code |
| 161 | 161 |
/// #define LEMON_CUSTOM_ASSERT_HANDLER custom_assert_handler |
| 162 | 162 |
/// \endcode |
| 163 | 163 |
/// Whenever an assertion is occured, the custom assertion |
| 164 | 164 |
/// handler is called with appropiate parameters. |
| 165 | 165 |
/// |
| 166 | 166 |
/// The assertion mode can also be changed within one compilation unit. |
| 167 | 167 |
/// If the macros are redefined with other settings and the |
| 168 | 168 |
/// \ref lemon/assert.h "assert.h" file is reincluded, then the |
| 169 | 169 |
/// behaviour is changed appropiately to the new settings. |
| 170 | 170 |
# define LEMON_ASSERT(exp, msg) \ |
| 171 | 171 |
(static_cast<void> (!!(exp) ? 0 : ( \ |
| 172 | 172 |
LEMON_ASSERT_HANDLER(__FILE__, __LINE__, \ |
| 173 | 173 |
LEMON_FUNCTION_NAME, \ |
| 174 | 174 |
::lemon::_assert_bits::cstringify(msg), #exp), 0))) |
| 175 | 175 |
|
| 176 | 176 |
/// \ingroup exceptions |
| 177 | 177 |
/// |
| 178 | 178 |
/// \brief Macro for mark not yet implemented features. |
| 179 | 179 |
/// |
| 180 | 180 |
/// Macro for mark not yet implemented features and outstanding bugs. |
| 181 | 181 |
/// It is close to be the shortcut of the following code: |
| 182 | 182 |
/// \code |
| 183 | 183 |
/// LEMON_ASSERT(false, msg); |
| 184 | 184 |
/// \endcode |
| 185 | 185 |
/// |
| 186 | 186 |
/// \see LEMON_ASSERT |
| 187 | 187 |
# define LEMON_FIXME(msg) \ |
| 188 | 188 |
(LEMON_ASSERT_HANDLER(__FILE__, __LINE__, LEMON_FUNCTION_NAME, \ |
| 189 | 189 |
::lemon::_assert_bits::cstringify(msg), \ |
| 190 | 190 |
static_cast<const char*>(0))) |
| 191 | 191 |
|
| 192 | 192 |
/// \ingroup exceptions |
| 193 | 193 |
/// |
| 194 | 194 |
/// \brief Macro for internal assertions |
| 195 | 195 |
/// |
| 196 | 196 |
/// Macro for internal assertions, it is used in the library to check |
| 197 | 197 |
/// the consistency of results of algorithms, several pre- and |
| 198 | 198 |
/// postconditions and invariants. The checking is disabled by |
| 199 | 199 |
/// default, but it can be turned on with the macro \c |
| 200 | 200 |
/// LEMON_ENABLE_DEBUG. |
| 201 | 201 |
/// \code |
| 202 | 202 |
/// #define LEMON_ENABLE_DEBUG |
| 203 | 203 |
/// \endcode |
| 204 | 204 |
/// or with compilation parameters: |
| 205 | 205 |
/// \code |
| 206 | 206 |
/// g++ -DLEMON_ENABLE_DEBUG |
| 207 | 207 |
/// make CXXFLAGS='-DLEMON_ENABLE_DEBUG' |
| 208 | 208 |
/// \endcode |
| 209 | 209 |
/// |
| 210 | 210 |
/// This macro works like the \c LEMON_ASSERT macro, therefore the |
| 211 | 211 |
/// current behaviour depends on the settings of \c LEMON_ASSERT |
| 212 | 212 |
/// macro. |
| 213 | 213 |
/// |
| 214 | 214 |
/// \see LEMON_ASSERT |
| 215 | 215 |
# define LEMON_DEBUG(exp, msg) \ |
| 216 | 216 |
(static_cast<void> (!!(exp) ? 0 : ( \ |
| 217 | 217 |
LEMON_ASSERT_HANDLER(__FILE__, __LINE__, \ |
| 218 | 218 |
LEMON_FUNCTION_NAME, \ |
| 219 | 219 |
::lemon::_assert_bits::cstringify(msg), #exp), 0))) |
| 220 | 220 |
|
| 221 | 221 |
#else |
| 222 | 222 |
|
| 223 | 223 |
# ifndef LEMON_ASSERT_HANDLER |
| 224 | 224 |
# define LEMON_ASSERT(exp, msg) (static_cast<void>(0)) |
| 225 | 225 |
# define LEMON_FIXME(msg) (static_cast<void>(0)) |
| 226 | 226 |
# define LEMON_DEBUG(exp, msg) (static_cast<void>(0)) |
| 227 | 227 |
# else |
| 228 | 228 |
# define LEMON_ASSERT(exp, msg) \ |
| 229 | 229 |
(static_cast<void> (!!(exp) ? 0 : ( \ |
| 230 | 230 |
LEMON_ASSERT_HANDLER(__FILE__, __LINE__, \ |
| 231 | 231 |
LEMON_FUNCTION_NAME, \ |
| 232 | 232 |
::lemon::_assert_bits::cstringify(msg), \ |
| 233 | 233 |
#exp), 0))) |
| 234 | 234 |
# define LEMON_FIXME(msg) \ |
| 235 | 235 |
(LEMON_ASSERT_HANDLER(__FILE__, __LINE__, LEMON_FUNCTION_NAME, \ |
| 236 | 236 |
::lemon::_assert_bits::cstringify(msg), \ |
| 237 | 237 |
static_cast<const char*>(0))) |
| 238 | 238 |
|
| 239 | 239 |
# if LEMON_ENABLE_DEBUG |
| 240 | 240 |
# define LEMON_DEBUG(exp, msg) |
| 241 | 241 |
(static_cast<void> (!!(exp) ? 0 : ( \ |
| 242 | 242 |
LEMON_ASSERT_HANDLER(__FILE__, __LINE__, \ |
| 243 | 243 |
LEMON_FUNCTION_NAME, \ |
| 244 | 244 |
::lemon::_assert_bits::cstringify(msg), \ |
| 245 | 245 |
#exp), 0))) |
| 246 | 246 |
# else |
| 247 | 247 |
# define LEMON_DEBUG(exp, msg) (static_cast<void>(0)) |
| 248 | 248 |
# endif |
| 249 | 249 |
# endif |
| 250 | 250 |
|
| 251 | 251 |
#endif |
| 252 |
|
|
| 253 |
#ifdef DOXYGEN |
|
| 254 |
|
|
| 255 |
|
|
| 256 |
#else |
|
| 257 |
|
|
| 258 |
|
|
| 259 |
#endif |
|
| 260 |
|
|
| 261 |
|
0 comments (0 inline)