home
about
news
download
doc
source
systems
tests
bugs
contact
IMP Reference Guide
2.17.0
The Integrative Modeling Platform
IMP Manual
Reference Guide
Tutorial Index
Modules
Classes
Examples
include
IMP
version 2.17.0
compiler_macros.h
Go to the documentation of this file.
1
/**
2
* \file IMP/compiler_macros.h
3
* \brief Various compiler workarounds
4
*
5
* Copyright 2007-2022 IMP Inventors. All rights reserved.
6
*/
7
8
#ifndef IMPKERNEL_COMPILER_MACROS_H
9
#define IMPKERNEL_COMPILER_MACROS_H
10
11
// Deprecated: just use C++11 range-based for instead
12
#define IMP_FOREACH(v, r) for (v : r)
13
14
#define IMP_STRINGIFY(x) #x
15
16
// recommended by http://gcc.gnu.org/gcc/Function-Names.html
17
#if defined(_MSC_VER)
18
#define IMP_CURRENT_FUNCTION __FUNCTION__
19
#define IMP_CURRENT_PRETTY_FUNCTION __FUNCTION__
20
#elif defined(__STDC_VERSION__) && __STDC_VERSION__ < 199901L
21
#define IMP_CURRENT_FUNCTION __FUNCTION__
22
#define IMP_CURRENT_PRETTY_FUNCTION __PRETTY_FUNCTION__
23
#else
24
#define IMP_CURRENT_FUNCTION __func__
25
#define IMP_CURRENT_PRETTY_FUNCTION __PRETTY_FUNCTION__
26
#endif
27
28
#ifndef IMP_DOXYGEN
29
#ifdef __GNUC__
30
#define IMP_NO_SIDEEFFECTS __attribute__((pure))
31
#define IMP_UNUSED_FUNCTION __attribute__((unused))
32
#define IMP_WARN_UNUSED_RESULT __attribute__((warn_unused_result))
33
#define IMP_RESTRICT __restrict__
34
35
#else
36
#define IMP_NO_SIDEEFFECTS
37
#define IMP_UNUSED_FUNCTION
38
#define IMP_WARN_UNUSED_RESULT
39
#define IMP_RESTRICT
40
#endif
41
42
#else
43
//! Use this to label a function with no side effects
44
/** \advancedmethod */
45
#define IMP_NO_SIDEEFFECTS
46
//! Use this to make the compiler (possibly) warn if the result is not used
47
/** \advancedmethod */
48
#define IMP_WARN_UNUSED_RESULT
49
//! Label a function that is never called
50
/** \advancedmethod */
51
#define IMP_UNUSED_FUNCTION
52
//! restrict means that a variable is not aliased with this function
53
#define IMP_RESTRICT
54
#endif
55
56
57
// Deprecated: just use the 'override' keyword directly
58
#ifdef IMP_DOXYGEN
59
#define IMP_OVERRIDE
60
#else
61
#define IMP_OVERRIDE override
62
#endif
63
64
#ifdef IMP_DOXYGEN
65
#define IMP_FINAL
66
//! Have the compiler report an error if anything overrides this method
67
#define IMP_SWIG_FINAL
68
#else
69
#if defined(IMP_SWIG_WRAPPER) || defined(SWIG)
70
#define IMP_FINAL
71
#define IMP_SWIG_FINAL
72
#else
73
#define IMP_FINAL final
74
#define IMP_SWIG_FINAL final
75
#endif
76
#endif
77
78
#if defined(__GNUC__) && __cplusplus >= 201103L
79
#define IMP_HAS_NOEXCEPT 1
80
#elif defined(__clang__) && defined(__has_feature)
81
#define IMP_HAS_NOEXCEPT __has_feature(cxx_noexcept)
82
#else
83
#define IMP_HAS_NOEXCEPT 0
84
#endif
85
86
#if IMP_HAS_NOEXCEPT
87
#define IMP_NOEXCEPT noexcept
88
#define IMP_CXX11_DEFAULT_COPY_CONSTRUCTOR(Name) \
89
Name(const Name &) = default; \
90
Name &operator=(const Name &) = default
91
#else
92
// probably should be finer here
93
#define IMP_NOEXCEPT throw()
94
#define IMP_CXX11_DEFAULT_COPY_CONSTRUCTOR(Name)
95
#endif
96
97
#if defined(__clang__) || defined(__GNUC__)
98
#define IMP_PRAGMA(x) _Pragma(IMP_STRINGIFY(x))
99
100
#if defined(__clang__)
101
#define IMP_CLANG_PRAGMA(x) IMP_PRAGMA(clang x)
102
#define IMP_GCC_PRAGMA(x)
103
#define IMP_VC_PRAGMA(x)
104
#else
105
#define IMP_CLANG_PRAGMA(x)
106
#define IMP_GCC_PRAGMA(x) IMP_PRAGMA(GCC x)
107
#define IMP_VC_PRAGMA(x)
108
#endif
109
110
#elif defined(_MSC_VER)
111
#define IMP_PRAGMA(x) __pragma(x)
112
#define IMP_CLANG_PRAGMA(x)
113
#define IMP_GCC_PRAGMA(x)
114
#define IMP_VC_PRAGMA(x) IMP_PRAGMA(x)
115
116
#else
117
#define IMP_PRAGMA(x)
118
#define IMP_CLANG_PRAGMA(x)
119
#define IMP_GCC_PRAGMA(x)
120
#define IMP_VC_PRAGMA(x)
121
#endif
122
123
#ifdef __clang__
124
125
#define IMP_GCC_PUSH_POP(x)
126
127
#define IMP_COMPILER_ENABLE_WARNINGS \
128
IMP_CLANG_PRAGMA(diagnostic push) \
129
IMP_CLANG_PRAGMA(diagnostic warning "-Wall") \
130
IMP_CLANG_PRAGMA(diagnostic warning "-Wextra") \
131
IMP_CLANG_PRAGMA(diagnostic warning "-Weverything") \
132
IMP_CLANG_PRAGMA(diagnostic ignored "-Wconversion") \
133
IMP_CLANG_PRAGMA(diagnostic ignored "-Wc++11-extensions") \
134
IMP_CLANG_PRAGMA(diagnostic ignored "-Wc++11-compat") \
135
IMP_CLANG_PRAGMA(diagnostic warning "-Wsign-compare") \
136
IMP_CLANG_PRAGMA(diagnostic ignored "-Wunused-member-function")
137
138
#define IMP_HELPER_MACRO_PUSH_WARNINGS IMP_CLANG_PRAGMA(diagnostic push)
139
140
#define IMP_HELPER_MACRO_POP_WARNINGS IMP_CLANG_PRAGMA(diagnostic pop)
141
142
#define IMP_COMPILER_DISABLE_WARNINGS IMP_CLANG_PRAGMA(diagnostic pop)
143
144
#elif defined(__GNUC__)
145
146
/*ret+=["-Wno-deprecated",
147
"-Wstrict-aliasing=2",
148
-fno-operator-names",]*/
149
#if __GNUC__ > 4 || __GNUC_MINOR__ >= 6
150
#define IMP_GCC_PUSH_POP(x) IMP_PRAGMA(x)
151
#define IMP_GCC_CXX0X_COMPAT \
152
IMP_GCC_PRAGMA(diagnostic ignored \
153
"-Wc++0x-compat")
154
#ifdef IMP_SWIG_WRAPPER
155
#define IMP_GCC_PROTOTYPES
156
#else
157
#define IMP_GCC_PROTOTYPES \
158
IMP_GCC_PRAGMA(diagnostic warning "-Wmissing-declarations")
159
#endif
160
161
#define IMP_HELPER_MACRO_PUSH_WARNINGS IMP_GCC_PRAGMA(diagnostic push)
162
163
#define IMP_HELPER_MACRO_POP_WARNINGS IMP_GCC_PRAGMA(diagnostic pop)
164
165
#else
166
#define IMP_GCC_PUSH_POP(x)
167
#define IMP_GCC_CXX0X_COMPAT
168
#define IMP_GCC_PROTOTYPES
169
#define IMP_HELPER_MACRO_PUSH_WARNINGS
170
#define IMP_HELPER_MACRO_POP_WARNINGS
171
#endif
172
173
// Warn about missing IMP_OVERRIDE on virtual methods if gcc is new enough
174
#if __GNUC__ > 5 || (__GNUC__ == 5 && __GNUC_MINOR__ >= 1)
175
#ifdef IMP_SWIG_WRAPPER
176
#define IMP_GCC_OVERRIDE
177
#else
178
#define IMP_GCC_OVERRIDE \
179
IMP_GCC_PRAGMA(diagnostic warning "-Wsuggest-override")
180
#endif
181
#else
182
#define IMP_GCC_OVERRIDE
183
#endif
184
185
#define IMP_COMPILER_ENABLE_WARNINGS \
186
IMP_GCC_PUSH_POP(GCC diagnostic push) \
187
IMP_GCC_PRAGMA(diagnostic warning "-Wall") \
188
IMP_GCC_PRAGMA(diagnostic warning "-Wextra") \
189
IMP_GCC_PRAGMA(diagnostic warning "-Winit-self") \
190
IMP_GCC_PRAGMA(diagnostic warning "-Wcast-align") \
191
IMP_GCC_PRAGMA(diagnostic warning "-Woverloaded-virtual") \
192
IMP_GCC_PRAGMA(diagnostic warning "-Wdeprecated-declarations") \
193
IMP_GCC_PRAGMA(diagnostic warning "-Wundef") \
194
IMP_GCC_PROTOTYPES IMP_GCC_CXX0X_COMPAT IMP_GCC_OVERRIDE
195
196
#define IMP_COMPILER_DISABLE_WARNINGS IMP_GCC_PUSH_POP(GCC diagnostic pop)
197
198
#elif defined(_MSC_VER)
199
#define IMP_GCC_PUSH_POP(x)
200
201
#define IMP_COMPILER_ENABLE_WARNINGS \
202
IMP_VC_PRAGMA(warning(push)) IMP_VC_PRAGMA(warning(disable : 4273)) \
203
IMP_VC_PRAGMA(warning(disable : 4244)) \
204
IMP_VC_PRAGMA(warning(disable : 4068)) \
205
IMP_VC_PRAGMA(warning(disable : 4297))
206
207
#define IMP_COMPILER_DISABLE_WARNINGS IMP_VC_PRAGMA(warning(pop))
208
209
#define IMP_HELPER_MACRO_PUSH_WARNINGS
210
#define IMP_HELPER_MACRO_POP_WARNINGS
211
212
#else
213
#define IMP_COMPILER_ENABLE_WARNINGS
214
#define IMP_COMPILER_DISABLE_WARNINGS
215
#define IMP_HELPER_MACRO_PUSH_WARNINGS
216
#define IMP_HELPER_MACRO_POP_WARNINGS
217
#endif
218
219
#if defined(__GNUC__) || defined(__clang__)
220
#define IMP_DEPRECATED_ATTRIBUTE __attribute__((deprecated))
221
#else
222
#define IMP_DEPRECATED_ATTRIBUTE
223
#endif
224
225
// likely/unlikely macros provide manual optimization of branch
226
// prediction - particularly useful for rare cases in scoring
227
// functions, but use only if you know what you're doing cause
228
// profiler is better at this in 99.9% of times:
229
#if defined(__GNUC__)
230
#define IMP_LIKELY(x) __builtin_expect (!!(x), 1)
231
#define IMP_UNLIKELY(x) __builtin_expect (!!(x), 0)
232
#else // ifdef __GNUC__
233
#define IMP_LIKELY(x) x
234
#define IMP_UNLIKELY(x) x
235
#endif // ifdef __GNUC__
236
237
#if defined(_MSC_VER)
238
//! platform independent C open() method
239
#define IMP_C_OPEN _open
240
#define IMP_C_CLOSE _close
241
//! platform independent C flag for open() method
242
#define IMP_C_OPEN_FLAG(x) _##x
243
#define IMP_C_OPEN_BINARY _O_BINARY
244
#else
245
//! platform independent C open() method
246
#define IMP_C_OPEN open
247
#define IMP_C_CLOSE close
248
//! platform independent C flag for open() method
249
#define IMP_C_OPEN_FLAG(x) x
250
#define IMP_C_OPEN_BINARY 0
251
#endif
252
253
#endif
/* IMPKERNEL_COMPILER_MACROS_H */
