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
21  * \ingroup bli
22  *
23  * Defines:
24  * - #BLI_assert
25  * - #BLI_STATIC_ASSERT
26  * - #BLI_STATIC_ASSERT_ALIGN
27  */
28
29 #ifdef __cplusplus
30 extern "C" {
31 #endif
32
33 #ifndef NDEBUG /* for BLI_assert */
34 #include <stdio.h>
35 #endif
36
37 #ifdef _MSC_VER
38 #include <crtdbg.h> /* for _STATIC_ASSERT */
39 #endif
40
41 /* BLI_assert(), default only to print
42  * for aborting need to define WITH_ASSERT_ABORT
43  */
44 /* For 'abort' only. */
45 #include <stdlib.h>
46
47 #ifndef NDEBUG
48 #  include "BLI_system.h"
49    /* _BLI_ASSERT_PRINT_POS */
50 #  if defined(__GNUC__)
51 #    define _BLI_ASSERT_PRINT_POS(a) \
52         fprintf(stderr, "BLI_assert failed: %s:%d, %s(), at \'%s\'\n", __FILE__, __LINE__, __func__, #a)
53 #  elif defined(_MSC_VER)
54 #    define _BLI_ASSERT_PRINT_POS(a) \
55         fprintf(stderr, "BLI_assert failed: %s:%d, %s(), at \'%s\'\n", __FILE__, __LINE__, __FUNCTION__, #a)
56 #  else
57 #    define _BLI_ASSERT_PRINT_POS(a) \
58         fprintf(stderr, "BLI_assert failed: %s:%d, at \'%s\'\n", __FILE__, __LINE__, #a)
59 #  endif
60    /* _BLI_ASSERT_ABORT */
61 #  ifdef WITH_ASSERT_ABORT
62 #    define _BLI_ASSERT_ABORT abort
63 #  else
64 #    define _BLI_ASSERT_ABORT() (void)0
65 #  endif
66    /* BLI_assert */
67 #  define BLI_assert(a) \
68         (void)((!(a)) ? ((BLI_system_backtrace(stderr), _BLI_ASSERT_PRINT_POS(a), _BLI_ASSERT_ABORT(), NULL)) : NULL)
69 #else
70 #  define BLI_assert(a) ((void)0)
71 #endif
72
73 /* C++ can't use _Static_assert, expects static_assert() but c++0x only,
74  * Coverity also errors out. */
75 #if (!defined(__cplusplus)) && \
76     (!defined(__COVERITY__)) && \
77     (defined(__GNUC__) && ((__GNUC__ * 100 + __GNUC_MINOR__) >= 406))  /* gcc4.6+ only */
78 #  define BLI_STATIC_ASSERT(a, msg) __extension__ _Static_assert(a, msg);
79 #elif defined(_MSC_VER)
80 #  define BLI_STATIC_ASSERT(a, msg) _STATIC_ASSERT(a);
81 #else  /* older gcc, clang... */
82   /* Code adapted from http://www.pixelbeat.org/programming/gcc/static_assert.html */
83   /* Note we need the two concats below because arguments to ## are not expanded, so we need to
84    * expand __LINE__ with one indirection before doing the actual concatenation. */
85 #  define _BLI_ASSERT_CONCAT_(a, b) a##b
86 #  define _BLI_ASSERT_CONCAT(a, b) _BLI_ASSERT_CONCAT_(a, b)
87    /* This can't be used twice on the same line so ensure if using in headers
88     * that the headers are not included twice (by wrapping in #ifndef...#endif)
89     * Note it doesn't cause an issue when used on same line of separate modules
90     * compiled with gcc -combine -fwhole-program. */
91 #  define BLI_STATIC_ASSERT(a, msg) \
92        ; enum { _BLI_ASSERT_CONCAT(assert_line_, __LINE__) = 1 / (int)(!!(a)) };
93 #endif
94
95 #define BLI_STATIC_ASSERT_ALIGN(st, align) \
96   BLI_STATIC_ASSERT((sizeof(st) % (align) == 0), "Structure must be strictly aligned")
97
98 #ifdef __cplusplus
99 }
100 #endif
101
102 #endif  /* __BLI_ASSERT_H__ */