Unified · Split
| @@ -0,0 +1,57 @@ | |||
| 1 | /* | ||
| 2 | * This file is part of mpv. | ||
| 3 | * | ||
| 4 | * mpv is free software; you can redistribute it and/or | ||
| 5 | * modify it under the terms of the GNU Lesser General Public | ||
| 6 | * License as published by the Free Software Foundation; either | ||
| 7 | * version 2.1 of the License, or (at your option) any later version. | ||
| 8 | * | ||
| 9 | * mpv is distributed in the hope that it will be useful, | ||
| 10 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
| 11 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||
| 12 | * GNU Lesser General Public License for more details. | ||
| 13 | * | ||
| 14 | * You should have received a copy of the GNU Lesser General Public | ||
| 15 | * License along with mpv. If not, see <http://www.gnu.org/licenses/>. | ||
| 16 | */ | ||
| 17 | |||
| 18 | #pragma once | ||
| 19 | |||
| 20 | /** | ||
| 21 | * @brief This file provides two macros, mp_assert and mp_require, used to check | ||
| 22 | * for conditions that should never occur. | ||
| 23 | * | ||
| 24 | * The mp_assert macro is a convenience wrapper around the standard assert, | ||
| 25 | * which also sinks unused variables to prevent compiler warnings. It should be | ||
| 26 | * used for debugging purposes only to check for conditions that should never | ||
| 27 | * occur. This macro can be disabled in release builds by defining NDEBUG and | ||
| 28 | * should not be used for error handling. | ||
| 29 | * | ||
| 30 | * The mp_require macro is similar to mp_assert but more strict. It enforces | ||
| 31 | * critical assertions even in release builds. If the condition is not met, this | ||
| 32 | * macro will abort the program, making it suitable for error handling in cases | ||
| 33 | * where recovery is impossible. Note that this macro does not log any messages | ||
| 34 | * to keep as small footprint as possible in NDEBUG builds. | ||
| 35 | */ | ||
| 36 | |||
| 37 | #ifndef NDEBUG | ||
| 38 | |||
| 39 | #include <assert.h> | ||
| 40 | |||
| 41 | #define mp_assert assert | ||
| 42 | #define mp_require assert | ||
| 43 | |||
| 44 | #else | ||
| 45 | |||
| 46 | #include <stdio.h> | ||
| 47 | #include <stdlib.h> | ||
| 48 | |||
| 49 | #define mp_require(expr) \ | ||
| 50 | do { \ | ||
| 51 | if (!(expr)) \ | ||
| 52 | abort(); \ | ||
| 53 | } while (0) | ||
| 54 | |||
| 55 | #define mp_assert(expr) do { (void)sizeof(expr);} while (0) | ||
| 56 | |||
| 57 | #endif | ||