Make variant only available when compiling for C++14 or greater
[WebKit-https.git] / Source / WTF / wtf / Compiler.h
1 /*
2  * Copyright (C) 2011, 2012, 2014 Apple Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
24  */
25
26 #ifndef WTF_Compiler_h
27 #define WTF_Compiler_h
28
29 /* COMPILER() - the compiler being used to build the project */
30 #define COMPILER(WTF_FEATURE) (defined WTF_COMPILER_##WTF_FEATURE  && WTF_COMPILER_##WTF_FEATURE)
31
32 /* COMPILER_SUPPORTS() - whether the compiler being used to build the project supports the given feature. */
33 #define COMPILER_SUPPORTS(WTF_COMPILER_FEATURE) (defined WTF_COMPILER_SUPPORTS_##WTF_COMPILER_FEATURE  && WTF_COMPILER_SUPPORTS_##WTF_COMPILER_FEATURE)
34
35 /* COMPILER_QUIRK() - whether the compiler being used to build the project requires a given quirk. */
36 #define COMPILER_QUIRK(WTF_COMPILER_QUIRK) (defined WTF_COMPILER_QUIRK_##WTF_COMPILER_QUIRK  && WTF_COMPILER_QUIRK_##WTF_COMPILER_QUIRK)
37
38 /* COMPILER_HAS_CLANG_BUILTIN() - wether the compiler supports a particular clang builtin. */
39 #ifdef __has_builtin
40 #define COMPILER_HAS_CLANG_BUILTIN(x) __has_builtin(x)
41 #else
42 #define COMPILER_HAS_CLANG_BUILTIN(x) 0
43 #endif
44
45 /* ==== COMPILER() - primary detection of the compiler being used to build the project, in alphabetical order ==== */
46
47 /* COMPILER(CLANG) - Clang  */
48
49 #if defined(__clang__)
50 #define WTF_COMPILER_CLANG 1
51 #define WTF_COMPILER_SUPPORTS_BLOCKS __has_feature(blocks)
52 #define WTF_COMPILER_SUPPORTS_C_STATIC_ASSERT __has_feature(c_static_assert)
53 #define WTF_COMPILER_SUPPORTS_CXX_REFERENCE_QUALIFIED_FUNCTIONS __has_feature(cxx_reference_qualified_functions)
54 #define WTF_COMPILER_SUPPORTS_CXX_USER_LITERALS __has_feature(cxx_user_literals)
55 #define WTF_COMPILER_SUPPORTS_FALLTHROUGH_WARNINGS __has_feature(cxx_attributes) && __has_warning("-Wimplicit-fallthrough")
56 #define WTF_COMPILER_SUPPORTS_CXX_EXCEPTIONS __has_feature(cxx_exceptions)
57
58 #ifdef __cplusplus
59 #if __cplusplus <= 201103L
60 #define WTF_CPP_STD_VER 11
61 #elif __cplusplus <= 201402L
62 #define WTF_CPP_STD_VER 14
63 #endif
64 #endif
65
66 #endif
67
68 /* COMPILER(GCC_OR_CLANG) - GNU Compiler Collection or Clang */
69 #if defined(__GNUC__)
70 #define WTF_COMPILER_GCC_OR_CLANG 1
71 #endif
72
73 /* COMPILER(GCC) - GNU Compiler Collection */
74 /* Note: This section must come after the Clang section since we check !COMPILER(CLANG) here. */
75 #if COMPILER(GCC_OR_CLANG) && !COMPILER(CLANG)
76 #define WTF_COMPILER_GCC 1
77 #define WTF_COMPILER_SUPPORTS_CXX_USER_LITERALS 1
78 #define WTF_COMPILER_SUPPORTS_CXX_REFERENCE_QUALIFIED_FUNCTIONS 1
79
80 #define GCC_VERSION (__GNUC__ * 10000 + __GNUC_MINOR__ * 100 + __GNUC_PATCHLEVEL__)
81 #define GCC_VERSION_AT_LEAST(major, minor, patch) (GCC_VERSION >= (major * 10000 + minor * 100 + patch))
82
83 #if !GCC_VERSION_AT_LEAST(4, 9, 0)
84 #error "Please use a newer version of GCC. WebKit requires GCC 4.9.0 or newer to compile."
85 #endif
86
87 #if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L
88 #define WTF_COMPILER_SUPPORTS_C_STATIC_ASSERT 1
89 #endif
90
91 #pragma GCC diagnostic ignored "-Wmaybe-uninitialized"
92
93 #endif /* COMPILER(GCC) */
94
95 /* COMPILER(MINGW) - MinGW GCC */
96
97 #if defined(__MINGW32__)
98 #define WTF_COMPILER_MINGW 1
99 #include <_mingw.h>
100 #endif
101
102 /* COMPILER(MINGW64) - mingw-w64 GCC - used as additional check to exclude mingw.org specific functions */
103
104 /* Note: This section must come after the MinGW section since we check COMPILER(MINGW) here. */
105
106 #if COMPILER(MINGW) && defined(__MINGW64_VERSION_MAJOR) /* best way to check for mingw-w64 vs mingw.org */
107 #define WTF_COMPILER_MINGW64 1
108 #endif
109
110 /* COMPILER(MSVC) - Microsoft Visual C++ */
111
112 #if defined(_MSC_VER)
113 #define WTF_COMPILER_MSVC 1
114 #endif
115
116 #if defined(_MSC_VER) && _MSC_VER < 1800
117 #error "Please use a newer version of Visual Studio. WebKit requires VS2013 or newer to compile."
118 #endif
119
120 /* COMPILER(SUNCC) */
121
122 #if defined(__SUNPRO_CC) || defined(__SUNPRO_C)
123 #define WTF_COMPILER_SUNCC 1
124 #endif
125
126 #if !COMPILER(CLANG) && !COMPILER(MSVC)
127 #define WTF_COMPILER_QUIRK_CONSIDERS_UNREACHABLE_CODE 1
128 #endif
129
130 /* ==== COMPILER_SUPPORTS - additional compiler feature detection, in alphabetical order ==== */
131
132 /* COMPILER_SUPPORTS(EABI) */
133
134 #if defined(__ARM_EABI__) || defined(__EABI__)
135 #define WTF_COMPILER_SUPPORTS_EABI 1
136 #endif
137
138 #if defined(__has_feature)
139 #define ASAN_ENABLED __has_feature(address_sanitizer)
140 #else
141 #define ASAN_ENABLED 0
142 #endif
143
144 #if ASAN_ENABLED
145 #define SUPPRESS_ASAN __attribute__((no_sanitize_address))
146 #else
147 #define SUPPRESS_ASAN
148 #endif
149
150 /* ==== Compiler-independent macros for various compiler features, in alphabetical order ==== */
151
152 /* ALWAYS_INLINE */
153
154 #if !defined(ALWAYS_INLINE) && COMPILER(GCC_OR_CLANG) && defined(NDEBUG) && !COMPILER(MINGW)
155 #define ALWAYS_INLINE inline __attribute__((__always_inline__))
156 #endif
157
158 #if !defined(ALWAYS_INLINE) && COMPILER(MSVC) && defined(NDEBUG)
159 #define ALWAYS_INLINE __forceinline
160 #endif
161
162 #if !defined(ALWAYS_INLINE)
163 #define ALWAYS_INLINE inline
164 #endif
165
166 /* WTF_EXTERN_C_{BEGIN, END} */
167
168 #ifdef __cplusplus
169 #define WTF_EXTERN_C_BEGIN extern "C" {
170 #define WTF_EXTERN_C_END }
171 #else
172 #define WTF_EXTERN_C_BEGIN
173 #define WTF_EXTERN_C_END
174 #endif
175
176 /* FIXME: Remove this once we have transitioned to WTF_EXTERN_C_BEGIN/WTF_EXTERN_C_END. */
177 #ifdef __cplusplus
178 #define EXTERN_C extern "C"
179 #else
180 #define EXTERN_C extern
181 #endif
182
183 /* FALLTHROUGH */
184
185 #if !defined(FALLTHROUGH) && COMPILER_SUPPORTS(FALLTHROUGH_WARNINGS) && COMPILER(CLANG)
186 #define FALLTHROUGH [[clang::fallthrough]]
187 #endif
188
189 #if !defined(FALLTHROUGH)
190 #define FALLTHROUGH
191 #endif
192
193 /* LIKELY */
194
195 #if !defined(LIKELY) && COMPILER(GCC_OR_CLANG)
196 #define LIKELY(x) __builtin_expect(!!(x), 1)
197 #endif
198
199 #if !defined(LIKELY)
200 #define LIKELY(x) (x)
201 #endif
202
203 /* NEVER_INLINE */
204
205 #if !defined(NEVER_INLINE) && COMPILER(GCC_OR_CLANG)
206 #define NEVER_INLINE __attribute__((__noinline__))
207 #endif
208
209 #if !defined(NEVER_INLINE) && COMPILER(MSVC)
210 #define NEVER_INLINE __declspec(noinline)
211 #endif
212
213 #if !defined(NEVER_INLINE)
214 #define NEVER_INLINE
215 #endif
216
217 /* NO_RETURN */
218
219 #if !defined(NO_RETURN) && COMPILER(GCC_OR_CLANG)
220 #define NO_RETURN __attribute((__noreturn__))
221 #endif
222
223 #if !defined(NO_RETURN) && COMPILER(MSVC)
224 #define NO_RETURN __declspec(noreturn)
225 #endif
226
227 #if !defined(NO_RETURN)
228 #define NO_RETURN
229 #endif
230
231 /* NO_RETURN_WITH_VALUE */
232
233 #if !defined(NO_RETURN_WITH_VALUE) && !COMPILER(MSVC)
234 #define NO_RETURN_WITH_VALUE NO_RETURN
235 #endif
236
237 #if !defined(NO_RETURN_WITH_VALUE)
238 #define NO_RETURN_WITH_VALUE
239 #endif
240
241 /* OBJC_CLASS */
242
243 #if !defined(OBJC_CLASS) && defined(__OBJC__)
244 #define OBJC_CLASS @class
245 #endif
246
247 #if !defined(OBJC_CLASS)
248 #define OBJC_CLASS class
249 #endif
250
251 /* PURE_FUNCTION */
252
253 #if !defined(PURE_FUNCTION) && COMPILER(GCC_OR_CLANG)
254 #define PURE_FUNCTION __attribute__((__pure__))
255 #endif
256
257 #if !defined(PURE_FUNCTION)
258 #define PURE_FUNCTION
259 #endif
260
261 /* REFERENCED_FROM_ASM */
262
263 #if !defined(REFERENCED_FROM_ASM) && COMPILER(GCC_OR_CLANG)
264 #define REFERENCED_FROM_ASM __attribute__((__used__))
265 #endif
266
267 #if !defined(REFERENCED_FROM_ASM)
268 #define REFERENCED_FROM_ASM
269 #endif
270
271 /* UNLIKELY */
272
273 #if !defined(UNLIKELY) && COMPILER(GCC_OR_CLANG)
274 #define UNLIKELY(x) __builtin_expect(!!(x), 0)
275 #endif
276
277 #if !defined(UNLIKELY)
278 #define UNLIKELY(x) (x)
279 #endif
280
281 /* UNUSED_LABEL */
282
283 /* Keep the compiler from complaining for a local label that is defined but not referenced. */
284 /* Helpful when mixing hand-written and autogenerated code. */
285
286 #if !defined(UNUSED_LABEL) && COMPILER(MSVC)
287 #define UNUSED_LABEL(label) if (false) goto label
288 #endif
289
290 #if !defined(UNUSED_LABEL)
291 #define UNUSED_LABEL(label) UNUSED_PARAM(&& label)
292 #endif
293
294 /* UNUSED_PARAM */
295
296 #if !defined(UNUSED_PARAM) && COMPILER(MSVC)
297 #define UNUSED_PARAM(variable) (void)&variable
298 #endif
299
300 #if !defined(UNUSED_PARAM)
301 #define UNUSED_PARAM(variable) (void)variable
302 #endif
303
304 /* WARN_UNUSED_RETURN */
305
306 #if !defined(WARN_UNUSED_RETURN) && COMPILER(GCC_OR_CLANG)
307 #define WARN_UNUSED_RETURN __attribute__((__warn_unused_result__))
308 #endif
309
310 #if !defined(WARN_UNUSED_RETURN)
311 #define WARN_UNUSED_RETURN
312 #endif
313
314 #if !defined(__has_include) && COMPILER(MSVC)
315 #define __has_include(path) 0
316 #endif
317
318 #endif /* WTF_Compiler_h */