Merge branch 'blender2.7'
[blender.git] / source / blender / blenlib / BLI_assert.h
1 /*
2  * This program is free software; you can redistribute it and/or
3  * modify it under the terms of the GNU General Public License
4  * as published by the Free Software Foundation; either version 2
5  * of the License, or (at your option) any later version.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * along with this program; if not, write to the Free Software Foundation,
14  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
15  */
16
17 #ifndef __BLI_ASSERT_H__
18 #define __BLI_ASSERT_H__
19
20 /** \file \ingroup bli
21  *
22  * Defines:
23  * - #BLI_assert
24  * - #BLI_STATIC_ASSERT
25  * - #BLI_STATIC_ASSERT_ALIGN
26  */
27
28 #ifdef __cplusplus
29 extern "C" {
30 #endif
31
32 #ifndef NDEBUG /* for BLI_assert */
33 #include <stdio.h>
34 #endif
35
36 /* BLI_assert(), default only to print
37  * for aborting need to define WITH_ASSERT_ABORT
38  */
39 /* For 'abort' only. */
40 #include <stdlib.h>
41
42 #ifndef NDEBUG
43 #  include "BLI_system.h"
44    /* _BLI_ASSERT_PRINT_POS */
45 #  if defined(__GNUC__)
46 #    define _BLI_ASSERT_PRINT_POS(a) \
47         fprintf(stderr, "BLI_assert failed: %s:%d, %s(), at \'%s\'\n", __FILE__, __LINE__, __func__, #a)
48 #  elif defined(_MSC_VER)
49 #    define _BLI_ASSERT_PRINT_POS(a) \
50         fprintf(stderr, "BLI_assert failed: %s:%d, %s(), at \'%s\'\n", __FILE__, __LINE__, __FUNCTION__, #a)
51 #  else
52 #    define _BLI_ASSERT_PRINT_POS(a) \
53         fprintf(stderr, "BLI_assert failed: %s:%d, at \'%s\'\n", __FILE__, __LINE__, #a)
54 #  endif
55    /* _BLI_ASSERT_ABORT */
56 #  ifdef WITH_ASSERT_ABORT
57 #    define _BLI_ASSERT_ABORT abort
58 #  else
59 #    define _BLI_ASSERT_ABORT() (void)0
60 #  endif
61    /* BLI_assert */
62 #  define BLI_assert(a) \
63         (void)((!(a)) ? ((BLI_system_backtrace(stderr), _BLI_ASSERT_PRINT_POS(a), _BLI_ASSERT_ABORT(), NULL)) : NULL)
64 #else
65 #  define BLI_assert(a) ((void)0)
66 #endif
67
68 /* C++ can't use _Static_assert, expects static_assert() but c++0x only,
69  * Coverity also errors out. */
70 #if (!defined(__cplusplus)) && \
71     (!defined(__COVERITY__)) && \
72     (defined(__GNUC__) && ((__GNUC__ * 100 + __GNUC_MINOR__) >= 406))  /* gcc4.6+ only */
73 #  define BLI_STATIC_ASSERT(a, msg) __extension__ _Static_assert(a, msg);
74 #else
75 /* Code adapted from http://www.pixelbeat.org/programming/gcc/static_assert.html */
76 /* Note we need the two concats below because arguments to ## are not expanded, so we need to
77  * expand __LINE__ with one indirection before doing the actual concatenation. */
78 #  define _BLI_ASSERT_CONCAT_(a, b) a##b
79 #  define _BLI_ASSERT_CONCAT(a, b) _BLI_ASSERT_CONCAT_(a, b)
80    /* These can't be used after statements in c89. */
81 #  if defined(__COUNTER__)  /* MSVC */
82 #    define BLI_STATIC_ASSERT(a, msg) \
83          ; enum { _BLI_ASSERT_CONCAT(static_assert_, __COUNTER__) = 1 / (int)(!!(a)) };
84 #  else  /* older gcc, clang... */
85     /* This can't be used twice on the same line so ensure if using in headers
86      * that the headers are not included twice (by wrapping in #ifndef...#endif)
87      * Note it doesn't cause an issue when used on same line of separate modules
88      * compiled with gcc -combine -fwhole-program. */
89 #    define BLI_STATIC_ASSERT(a, msg) \
90          ; enum { _BLI_ASSERT_CONCAT(assert_line_, __LINE__) = 1 / (int)(!!(a)) };
91 #  endif
92 #endif
93
94 #define BLI_STATIC_ASSERT_ALIGN(st, align) \
95   BLI_STATIC_ASSERT((sizeof(st) % (align) == 0), "Structure must be strictly aligned")
96
97 #ifdef __cplusplus
98 }
99 #endif
100
101 #endif  /* __BLI_ASSERT_H__ */