[Windows] Activate supported C++11 Features for VS2010
[WebKit-https.git] / Source / WTF / wtf / Compiler.h
1 /*
2  * Copyright (C) 2011, 2012 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() - the compiler being used to build the project ==== */
39
40 /* COMPILER(CLANG) - Clang  */
41 #if defined(__clang__)
42 #define WTF_COMPILER_CLANG 1
43
44 #ifndef __has_extension
45 #define __has_extension __has_feature /* Compatibility with older versions of clang */
46 #endif
47
48 #define CLANG_PRAGMA(PRAGMA) _Pragma(PRAGMA)
49
50 /* Specific compiler features */
51 #define WTF_COMPILER_SUPPORTS_CXX_VARIADIC_TEMPLATES __has_extension(cxx_variadic_templates)
52
53 /* There is a bug in clang that comes with Xcode 4.2 where AtomicStrings can't be implicitly converted to Strings
54    in the presence of move constructors and/or move assignment operators. This bug has been fixed in Xcode 4.3 clang, so we
55    check for both cxx_rvalue_references as well as the unrelated cxx_nonstatic_member_init feature which we know was added in 4.3 */
56 #define WTF_COMPILER_SUPPORTS_CXX_RVALUE_REFERENCES __has_extension(cxx_rvalue_references) && __has_extension(cxx_nonstatic_member_init)
57
58 #define WTF_COMPILER_SUPPORTS_CXX_DELETED_FUNCTIONS __has_extension(cxx_deleted_functions)
59 #define WTF_COMPILER_SUPPORTS_CXX_NULLPTR __has_feature(cxx_nullptr)
60 #define WTF_COMPILER_SUPPORTS_CXX_EXPLICIT_CONVERSIONS __has_feature(cxx_explicit_conversions)
61 #define WTF_COMPILER_SUPPORTS_BLOCKS __has_feature(blocks)
62 #define WTF_COMPILER_SUPPORTS_C_STATIC_ASSERT __has_extension(c_static_assert)
63 #define WTF_COMPILER_SUPPORTS_CXX_STATIC_ASSERT __has_extension(cxx_static_assert)
64 #define WTF_COMPILER_SUPPORTS_CXX_OVERRIDE_CONTROL __has_extension(cxx_override_control)
65 #define WTF_COMPILER_SUPPORTS_HAS_TRIVIAL_DESTRUCTOR __has_extension(has_trivial_destructor)
66 #define WTF_COMPILER_SUPPORTS_CXX_STRONG_ENUMS __has_extension(cxx_strong_enums)
67 #define WTF_COMPILER_SUPPORTS_CXX_REFERENCE_QUALIFIED_FUNCTIONS __has_extension(cxx_reference_qualified_functions)
68 #endif
69
70 #ifndef CLANG_PRAGMA
71 #define CLANG_PRAGMA(PRAGMA)
72 #endif
73
74 /* COMPILER(MSVC) - Microsoft Visual C++ */
75 /* COMPILER(MSVC9_OR_LOWER) - Microsoft Visual C++ 2008 or lower*/
76 #if defined(_MSC_VER)
77 #define WTF_COMPILER_MSVC 1
78 #if _MSC_VER < 1600
79 #define WTF_COMPILER_MSVC9_OR_LOWER 1
80 #endif
81
82 /* Specific compiler features */
83 #if !COMPILER(CLANG) && _MSC_VER >= 1600
84 #define WTF_COMPILER_SUPPORTS_CXX_NULLPTR 1
85 #endif
86
87 #if !COMPILER(CLANG)
88 #define WTF_COMPILER_SUPPORTS_CXX_OVERRIDE_CONTROL 1
89 #define WTF_COMPILER_QUIRK_FINAL_IS_CALLED_SEALED 1
90 #endif
91
92 /* Check for VS2010 or newer */
93 #if _MSC_VER >= 1600
94 #define WTF_COMPILER_SUPPORTS_CXX_RVALUE_REFERENCES 1
95 #define WTF_COMPILER_SUPPORTS_CXX_STATIC_ASSERT 1
96 #endif
97
98 #endif /* defined(_MSC_VER) */
99
100 /* COMPILER(RVCT) - ARM RealView Compilation Tools */
101 #if defined(__CC_ARM) || defined(__ARMCC__)
102 #define WTF_COMPILER_RVCT 1
103 #define RVCT_VERSION_AT_LEAST(major, minor, patch, build) (__ARMCC_VERSION >= (major * 100000 + minor * 10000 + patch * 1000 + build))
104 #else
105 /* Define this for !RVCT compilers, just so we can write things like RVCT_VERSION_AT_LEAST(3, 0, 0, 0). */
106 #define RVCT_VERSION_AT_LEAST(major, minor, patch, build) 0
107 #endif
108
109 /* COMPILER(GCCE) - GNU Compiler Collection for Embedded */
110 #if defined(__GCCE__)
111 #define WTF_COMPILER_GCCE 1
112 #define GCCE_VERSION (__GCCE__ * 10000 + __GCCE_MINOR__ * 100 + __GCCE_PATCHLEVEL__)
113 #define GCCE_VERSION_AT_LEAST(major, minor, patch) (GCCE_VERSION >= (major * 10000 + minor * 100 + patch))
114 #endif
115
116 /* COMPILER(GCC) - GNU Compiler Collection */
117 /* --gnu option of the RVCT compiler also defines __GNUC__ */
118 #if defined(__GNUC__) && !COMPILER(RVCT)
119 #define WTF_COMPILER_GCC 1
120 #define GCC_VERSION (__GNUC__ * 10000 + __GNUC_MINOR__ * 100 + __GNUC_PATCHLEVEL__)
121 #define GCC_VERSION_AT_LEAST(major, minor, patch) (GCC_VERSION >= (major * 10000 + minor * 100 + patch))
122 #else
123 /* Define this for !GCC compilers, just so we can write things like GCC_VERSION_AT_LEAST(4, 1, 0). */
124 #define GCC_VERSION_AT_LEAST(major, minor, patch) 0
125 #endif
126
127 /* Specific compiler features */
128 #if COMPILER(GCC) && !COMPILER(CLANG)
129 #if GCC_VERSION_AT_LEAST(4, 8, 0)
130 #pragma GCC diagnostic ignored "-Wunused-local-typedefs"
131 #endif
132 #if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L
133 /* C11 support */
134 #define WTF_COMPILER_SUPPORTS_C_STATIC_ASSERT 1
135 #endif
136 #if defined(__GXX_EXPERIMENTAL_CXX0X__) || (defined(__cplusplus) && __cplusplus >= 201103L)
137 /* C++11 support */
138 #if GCC_VERSION_AT_LEAST(4, 3, 0)
139 #define WTF_COMPILER_SUPPORTS_CXX_RVALUE_REFERENCES 1
140 #define WTF_COMPILER_SUPPORTS_CXX_STATIC_ASSERT 1
141 #define WTF_COMPILER_SUPPORTS_CXX_VARIADIC_TEMPLATES 1
142 #endif
143 #if GCC_VERSION_AT_LEAST(4, 4, 0)
144 #define WTF_COMPILER_SUPPORTS_CXX_DELETED_FUNCTIONS 1
145 #endif
146 #if GCC_VERSION_AT_LEAST(4, 5, 0)
147 #define WTF_COMPILER_SUPPORTS_CXX_EXPLICIT_CONVERSIONS 1
148 #endif
149 #if GCC_VERSION_AT_LEAST(4, 6, 0)
150 #define WTF_COMPILER_SUPPORTS_CXX_NULLPTR 1
151 /* Strong enums should work from gcc 4.4, but doesn't seem to support some operators */
152 #define WTF_COMPILER_SUPPORTS_CXX_STRONG_ENUMS 1
153 #endif
154 #if GCC_VERSION_AT_LEAST(4, 7, 0)
155 #define WTF_COMPILER_SUPPORTS_CXX_OVERRIDE_CONTROL 1
156 #endif
157 #endif /* defined(__GXX_EXPERIMENTAL_CXX0X__) || (defined(__cplusplus) && __cplusplus >= 201103L) */
158 #endif /* COMPILER(GCC) */
159
160 /* COMPILER(MINGW) - MinGW GCC */
161 /* COMPILER(MINGW64) - mingw-w64 GCC - only used as additional check to exclude mingw.org specific functions */
162 #if defined(__MINGW32__)
163 #define WTF_COMPILER_MINGW 1
164 #include <_mingw.h> /* private MinGW header */
165     #if defined(__MINGW64_VERSION_MAJOR) /* best way to check for mingw-w64 vs mingw.org */
166         #define WTF_COMPILER_MINGW64 1
167     #endif /* __MINGW64_VERSION_MAJOR */
168 #endif /* __MINGW32__ */
169
170 /* COMPILER(INTEL) - Intel C++ Compiler */
171 #if defined(__INTEL_COMPILER)
172 #define WTF_COMPILER_INTEL 1
173 #endif
174
175 /* COMPILER(SUNCC) */
176 #if defined(__SUNPRO_CC) || defined(__SUNPRO_C)
177 #define WTF_COMPILER_SUNCC 1
178 #endif
179
180 /* ABI */
181 #if defined(__ARM_EABI__) || defined(__EABI__)
182 #define WTF_COMPILER_SUPPORTS_EABI 1
183 #endif
184
185 /* ==== Compiler features ==== */
186
187 /* ALWAYS_INLINE */
188
189 #ifndef ALWAYS_INLINE
190 #if COMPILER(GCC) && defined(NDEBUG) && !COMPILER(MINGW)
191 #define ALWAYS_INLINE inline __attribute__((__always_inline__))
192 #elif (COMPILER(MSVC) || COMPILER(RVCT)) && defined(NDEBUG)
193 #define ALWAYS_INLINE __forceinline
194 #else
195 #define ALWAYS_INLINE inline
196 #endif
197 #endif
198
199
200 /* NEVER_INLINE */
201
202 #ifndef NEVER_INLINE
203 #if COMPILER(GCC)
204 #define NEVER_INLINE __attribute__((__noinline__))
205 #elif COMPILER(RVCT)
206 #define NEVER_INLINE __declspec(noinline)
207 #else
208 #define NEVER_INLINE
209 #endif
210 #endif
211
212
213 /* UNLIKELY */
214
215 #ifndef UNLIKELY
216 #if COMPILER(GCC) || (COMPILER(RVCT) && defined(__GNUC__))
217 #define UNLIKELY(x) __builtin_expect((x), 0)
218 #else
219 #define UNLIKELY(x) (x)
220 #endif
221 #endif
222
223
224 /* LIKELY */
225
226 #ifndef LIKELY
227 #if COMPILER(GCC) || (COMPILER(RVCT) && defined(__GNUC__))
228 #define LIKELY(x) __builtin_expect((x), 1)
229 #else
230 #define LIKELY(x) (x)
231 #endif
232 #endif
233
234
235 /* NO_RETURN */
236
237
238 #ifndef NO_RETURN
239 #if COMPILER(GCC)
240 #define NO_RETURN __attribute((__noreturn__))
241 #elif COMPILER(MSVC) || COMPILER(RVCT)
242 #define NO_RETURN __declspec(noreturn)
243 #else
244 #define NO_RETURN
245 #endif
246 #endif
247
248
249 /* NO_RETURN_WITH_VALUE */
250
251 #ifndef NO_RETURN_WITH_VALUE
252 #if !COMPILER(MSVC)
253 #define NO_RETURN_WITH_VALUE NO_RETURN
254 #else
255 #define NO_RETURN_WITH_VALUE
256 #endif
257 #endif
258
259
260 /* WARN_UNUSED_RETURN */
261
262 #if COMPILER(GCC)
263 #define WARN_UNUSED_RETURN __attribute__ ((warn_unused_result))
264 #else
265 #define WARN_UNUSED_RETURN
266 #endif
267
268 /* OVERRIDE and FINAL */
269
270 #if COMPILER_SUPPORTS(CXX_OVERRIDE_CONTROL)
271 #define OVERRIDE override
272
273 #if COMPILER_QUIRK(FINAL_IS_CALLED_SEALED)
274 #define FINAL sealed
275 #else
276 #define FINAL final
277 #endif
278
279 #else
280 #define OVERRIDE
281 #define FINAL
282 #endif
283
284 #if COMPILER_SUPPORTS(CXX_DELETED_FUNCTIONS)
285 #define WTF_DELETED_FUNCTION = delete
286 #else
287 #define WTF_DELETED_FUNCTION
288 #endif
289
290 /* REFERENCED_FROM_ASM */
291
292 #ifndef REFERENCED_FROM_ASM
293 #if COMPILER(GCC)
294 #define REFERENCED_FROM_ASM __attribute__((used))
295 #else
296 #define REFERENCED_FROM_ASM
297 #endif
298 #endif
299
300 /* OBJC_CLASS */
301
302 #ifndef OBJC_CLASS
303 #ifdef __OBJC__
304 #define OBJC_CLASS @class
305 #else
306 #define OBJC_CLASS class
307 #endif
308 #endif
309
310 /* UNUSED_PARAM */
311
312 #if COMPILER(INTEL) && !(defined(WIN32) || defined(_WIN32)) || COMPILER(RVCT)
313 template<typename T>
314 inline void unusedParam(T& x) { (void)x; }
315 #define UNUSED_PARAM(variable) unusedParam(variable)
316 #elif COMPILER(MSVC)
317 #define UNUSED_PARAM(variable) (void)&variable
318 #else
319 #define UNUSED_PARAM(variable) (void)variable
320 #endif
321
322 /* UNUSED_LABEL */
323
324 /* This is to keep the compiler from complaining when for local labels are
325  declared but not referenced. For example, this can happen with code that
326  works with auto-generated code.
327  */
328 #if COMPILER(MSVC)
329 #define UNUSED_LABEL(label) if (false) goto label
330 #else
331 #define UNUSED_LABEL(label) UNUSED_PARAM(&& label)
332 #endif
333
334
335
336 #endif /* WTF_Compiler_h */