Clang Project

clang_source_code/include/clang/Basic/Features.def
1//===--- Features.def - Features and Extensions database --------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file defines features exposed via __has_feature and extensions exposed
10// via __has_extension. Users of this file must either define the FEATURE or
11// EXTENSION macros (or both) to make use of this information. Note that these
12// macros expect the following declarations to be available for the Predicate:
13//
14//   const LangOptions &LangOpts;
15//   const Preprocessor &PP;
16//
17// The Predicate field dictates the conditions under which the feature or
18// extension will be made available.
19//
20// FEATURE(...) should be used to advertise support for standard language
21// features, whereas EXTENSION(...) should be used for clang extensions. Note
22// that many of the identifiers in this file don't follow this rule for backward
23// compatibility reasons.
24//
25//===----------------------------------------------------------------------===//
26
27#if !defined(FEATURE) && !defined(EXTENSION)
28#  error Define either the FEATURE or EXTENSION macro to handle features
29#endif
30
31#ifndef FEATURE
32#define FEATURE(Name, Predicate)
33#endif
34
35#ifndef EXTENSION
36#define EXTENSION(Name, Predicate)
37#endif
38
39FEATURE(address_sanitizer,
40        LangOpts.Sanitize.hasOneOf(SanitizerKind::Address |
41                                   SanitizerKind::KernelAddress))
42FEATURE(hwaddress_sanitizer,
43        LangOpts.Sanitize.hasOneOf(SanitizerKind::HWAddress |
44                                   SanitizerKind::KernelHWAddress))
45FEATURE(xray_instrument, LangOpts.XRayInstrument)
46FEATURE(undefined_behavior_sanitizer,
47        LangOpts.Sanitize.hasOneOf(SanitizerKind::Undefined))
48FEATURE(assume_nonnull, true)
49FEATURE(attribute_analyzer_noreturn, true)
50FEATURE(attribute_availability, true)
51FEATURE(attribute_availability_with_message, true)
52FEATURE(attribute_availability_app_extension, true)
53FEATURE(attribute_availability_with_version_underscores, true)
54FEATURE(attribute_availability_tvos, true)
55FEATURE(attribute_availability_watchos, true)
56FEATURE(attribute_availability_with_strict, true)
57FEATURE(attribute_availability_with_replacement, true)
58FEATURE(attribute_availability_in_templates, true)
59FEATURE(attribute_availability_swift, true)
60FEATURE(attribute_cf_returns_not_retained, true)
61FEATURE(attribute_cf_returns_retained, true)
62FEATURE(attribute_cf_returns_on_parameters, true)
63FEATURE(attribute_deprecated_with_message, true)
64FEATURE(attribute_deprecated_with_replacement, true)
65FEATURE(attribute_ext_vector_type, true)
66FEATURE(attribute_ns_returns_not_retained, true)
67FEATURE(attribute_ns_returns_retained, true)
68FEATURE(attribute_ns_consumes_self, true)
69FEATURE(attribute_ns_consumed, true)
70FEATURE(attribute_cf_consumed, true)
71FEATURE(attribute_objc_ivar_unused, true)
72FEATURE(attribute_objc_method_family, true)
73FEATURE(attribute_overloadable, true)
74FEATURE(attribute_unavailable_with_message, true)
75FEATURE(attribute_unused_on_fields, true)
76FEATURE(attribute_diagnose_if_objc, true)
77FEATURE(blocks, LangOpts.Blocks)
78FEATURE(c_thread_safety_attributes, true)
79FEATURE(cxx_exceptions, LangOpts.CXXExceptions)
80FEATURE(cxx_rtti, LangOpts.RTTI &&LangOpts.RTTIData)
81FEATURE(enumerator_attributes, true)
82FEATURE(nullability, true)
83FEATURE(nullability_on_arrays, true)
84FEATURE(memory_sanitizer,
85        LangOpts.Sanitize.hasOneOf(SanitizerKind::Memory |
86                                   SanitizerKind::KernelMemory))
87FEATURE(thread_sanitizer, LangOpts.Sanitize.has(SanitizerKind::Thread))
88FEATURE(dataflow_sanitizer, LangOpts.Sanitize.has(SanitizerKind::DataFlow))
89FEATURE(scudo, LangOpts.Sanitize.hasOneOf(SanitizerKind::Scudo))
90// Objective-C features
91FEATURE(objc_arr, LangOpts.ObjCAutoRefCount) // FIXME: REMOVE?
92FEATURE(objc_arc, LangOpts.ObjCAutoRefCount)
93FEATURE(objc_arc_fields, true)
94FEATURE(objc_arc_weak, LangOpts.ObjCWeak)
95FEATURE(objc_default_synthesize_properties, LangOpts.ObjC)
96FEATURE(objc_fixed_enum, LangOpts.ObjC)
97FEATURE(objc_instancetype, LangOpts.ObjC)
98FEATURE(objc_kindof, LangOpts.ObjC)
99FEATURE(objc_modules, LangOpts.ObjC && LangOpts.Modules)
100FEATURE(objc_nonfragile_abi, LangOpts.ObjCRuntime.isNonFragile())
101FEATURE(objc_property_explicit_atomic, true)
102FEATURE(objc_protocol_qualifier_mangling, true)
103FEATURE(objc_weak_class, LangOpts.ObjCRuntime.hasWeakClassImport())
104FEATURE(ownership_holds, true)
105FEATURE(ownership_returns, true)
106FEATURE(ownership_takes, true)
107FEATURE(objc_bool, true)
108FEATURE(objc_subscripting, LangOpts.ObjCRuntime.isNonFragile())
109FEATURE(objc_array_literals, LangOpts.ObjC)
110FEATURE(objc_dictionary_literals, LangOpts.ObjC)
111FEATURE(objc_boxed_expressions, LangOpts.ObjC)
112FEATURE(objc_boxed_nsvalue_expressions, LangOpts.ObjC)
113FEATURE(arc_cf_code_audited, true)
114FEATURE(objc_bridge_id, true)
115FEATURE(objc_bridge_id_on_typedefs, true)
116FEATURE(objc_generics, LangOpts.ObjC)
117FEATURE(objc_generics_variance, LangOpts.ObjC)
118FEATURE(objc_class_property, LangOpts.ObjC)
119FEATURE(objc_c_static_assert, LangOpts.C11)
120FEATURE(objc_cxx_static_assert, LangOpts.CPlusPlus11)
121EXTENSION(objc_c_static_assert, true)
122// C11 features
123FEATURE(c_alignas, LangOpts.C11)
124FEATURE(c_alignof, LangOpts.C11)
125FEATURE(c_atomic, LangOpts.C11)
126FEATURE(c_generic_selections, LangOpts.C11)
127FEATURE(c_static_assert, LangOpts.C11)
128FEATURE(c_thread_local, LangOpts.C11 &&PP.getTargetInfo().isTLSSupported())
129// C++11 features
130FEATURE(cxx_access_control_sfinae, LangOpts.CPlusPlus11)
131FEATURE(cxx_alias_templates, LangOpts.CPlusPlus11)
132FEATURE(cxx_alignas, LangOpts.CPlusPlus11)
133FEATURE(cxx_alignof, LangOpts.CPlusPlus11)
134FEATURE(cxx_atomic, LangOpts.CPlusPlus11)
135FEATURE(cxx_attributes, LangOpts.CPlusPlus11)
136FEATURE(cxx_auto_type, LangOpts.CPlusPlus11)
137FEATURE(cxx_constexpr, LangOpts.CPlusPlus11)
138FEATURE(cxx_constexpr_string_builtins, LangOpts.CPlusPlus11)
139FEATURE(cxx_decltype, LangOpts.CPlusPlus11)
140FEATURE(cxx_decltype_incomplete_return_types, LangOpts.CPlusPlus11)
141FEATURE(cxx_default_function_template_args, LangOpts.CPlusPlus11)
142FEATURE(cxx_defaulted_functions, LangOpts.CPlusPlus11)
143FEATURE(cxx_delegating_constructors, LangOpts.CPlusPlus11)
144FEATURE(cxx_deleted_functions, LangOpts.CPlusPlus11)
145FEATURE(cxx_explicit_conversions, LangOpts.CPlusPlus11)
146FEATURE(cxx_generalized_initializers, LangOpts.CPlusPlus11)
147FEATURE(cxx_implicit_moves, LangOpts.CPlusPlus11)
148FEATURE(cxx_inheriting_constructors, LangOpts.CPlusPlus11)
149FEATURE(cxx_inline_namespaces, LangOpts.CPlusPlus11)
150FEATURE(cxx_lambdas, LangOpts.CPlusPlus11)
151FEATURE(cxx_local_type_template_args, LangOpts.CPlusPlus11)
152FEATURE(cxx_nonstatic_member_init, LangOpts.CPlusPlus11)
153FEATURE(cxx_noexcept, LangOpts.CPlusPlus11)
154FEATURE(cxx_nullptr, LangOpts.CPlusPlus11)
155FEATURE(cxx_override_control, LangOpts.CPlusPlus11)
156FEATURE(cxx_range_for, LangOpts.CPlusPlus11)
157FEATURE(cxx_raw_string_literals, LangOpts.CPlusPlus11)
158FEATURE(cxx_reference_qualified_functions, LangOpts.CPlusPlus11)
159FEATURE(cxx_rvalue_references, LangOpts.CPlusPlus11)
160FEATURE(cxx_strong_enums, LangOpts.CPlusPlus11)
161FEATURE(cxx_static_assert, LangOpts.CPlusPlus11)
162FEATURE(cxx_thread_local,
163        LangOpts.CPlusPlus11 &&PP.getTargetInfo().isTLSSupported())
164FEATURE(cxx_trailing_return, LangOpts.CPlusPlus11)
165FEATURE(cxx_unicode_literals, LangOpts.CPlusPlus11)
166FEATURE(cxx_unrestricted_unions, LangOpts.CPlusPlus11)
167FEATURE(cxx_user_literals, LangOpts.CPlusPlus11)
168FEATURE(cxx_variadic_templates, LangOpts.CPlusPlus11)
169// C++14 features
170FEATURE(cxx_aggregate_nsdmi, LangOpts.CPlusPlus14)
171FEATURE(cxx_binary_literals, LangOpts.CPlusPlus14)
172FEATURE(cxx_contextual_conversions, LangOpts.CPlusPlus14)
173FEATURE(cxx_decltype_auto, LangOpts.CPlusPlus14)
174FEATURE(cxx_generic_lambdas, LangOpts.CPlusPlus14)
175FEATURE(cxx_init_captures, LangOpts.CPlusPlus14)
176FEATURE(cxx_relaxed_constexpr, LangOpts.CPlusPlus14)
177FEATURE(cxx_return_type_deduction, LangOpts.CPlusPlus14)
178FEATURE(cxx_variable_templates, LangOpts.CPlusPlus14)
179// NOTE: For features covered by SD-6, it is preferable to provide *only*
180// the SD-6 macro and not a __has_feature check.
181
182// C++ TSes
183// FEATURE(cxx_runtime_arrays, LangOpts.CPlusPlusTSArrays)
184// FEATURE(cxx_concepts, LangOpts.CPlusPlusTSConcepts)
185// FIXME: Should this be __has_feature or __has_extension?
186// FEATURE(raw_invocation_type, LangOpts.CPlusPlus)
187// Type traits
188// N.B. Additional type traits should not be added to the following list.
189// Instead, they should be detected by has_extension.
190FEATURE(has_nothrow_assign, LangOpts.CPlusPlus)
191FEATURE(has_nothrow_copy, LangOpts.CPlusPlus)
192FEATURE(has_nothrow_constructor, LangOpts.CPlusPlus)
193FEATURE(has_trivial_assign, LangOpts.CPlusPlus)
194FEATURE(has_trivial_copy, LangOpts.CPlusPlus)
195FEATURE(has_trivial_constructor, LangOpts.CPlusPlus)
196FEATURE(has_trivial_destructor, LangOpts.CPlusPlus)
197FEATURE(has_virtual_destructor, LangOpts.CPlusPlus)
198FEATURE(is_abstract, LangOpts.CPlusPlus)
199FEATURE(is_base_of, LangOpts.CPlusPlus)
200FEATURE(is_class, LangOpts.CPlusPlus)
201FEATURE(is_constructible, LangOpts.CPlusPlus)
202FEATURE(is_convertible_to, LangOpts.CPlusPlus)
203FEATURE(is_empty, LangOpts.CPlusPlus)
204FEATURE(is_enum, LangOpts.CPlusPlus)
205FEATURE(is_final, LangOpts.CPlusPlus)
206FEATURE(is_literal, LangOpts.CPlusPlus)
207FEATURE(is_standard_layout, LangOpts.CPlusPlus)
208FEATURE(is_pod, LangOpts.CPlusPlus)
209FEATURE(is_polymorphic, LangOpts.CPlusPlus)
210FEATURE(is_sealed, LangOpts.CPlusPlus &&LangOpts.MicrosoftExt)
211FEATURE(is_trivial, LangOpts.CPlusPlus)
212FEATURE(is_trivially_assignable, LangOpts.CPlusPlus)
213FEATURE(is_trivially_constructible, LangOpts.CPlusPlus)
214FEATURE(is_trivially_copyable, LangOpts.CPlusPlus)
215FEATURE(is_union, LangOpts.CPlusPlus)
216FEATURE(modules, LangOpts.Modules)
217FEATURE(safe_stack, LangOpts.Sanitize.has(SanitizerKind::SafeStack))
218FEATURE(shadow_call_stack,
219        LangOpts.Sanitize.has(SanitizerKind::ShadowCallStack))
220FEATURE(tls, PP.getTargetInfo().isTLSSupported())
221FEATURE(underlying_type, LangOpts.CPlusPlus)
222
223// C11 features supported by other languages as extensions.
224EXTENSION(c_alignas, true)
225EXTENSION(c_alignof, true)
226EXTENSION(c_atomic, true)
227EXTENSION(c_generic_selections, true)
228EXTENSION(c_static_assert, true)
229EXTENSION(c_thread_local, PP.getTargetInfo().isTLSSupported())
230// C++11 features supported by other languages as extensions.
231EXTENSION(cxx_atomic, LangOpts.CPlusPlus)
232EXTENSION(cxx_deleted_functions, LangOpts.CPlusPlus)
233EXTENSION(cxx_explicit_conversions, LangOpts.CPlusPlus)
234EXTENSION(cxx_inline_namespaces, LangOpts.CPlusPlus)
235EXTENSION(cxx_local_type_template_args, LangOpts.CPlusPlus)
236EXTENSION(cxx_nonstatic_member_init, LangOpts.CPlusPlus)
237EXTENSION(cxx_override_control, LangOpts.CPlusPlus)
238EXTENSION(cxx_range_for, LangOpts.CPlusPlus)
239EXTENSION(cxx_reference_qualified_functions, LangOpts.CPlusPlus)
240EXTENSION(cxx_rvalue_references, LangOpts.CPlusPlus)
241EXTENSION(cxx_variadic_templates, LangOpts.CPlusPlus)
242EXTENSION(cxx_fixed_enum, true)
243// C++14 features supported by other languages as extensions.
244EXTENSION(cxx_binary_literals, true)
245EXTENSION(cxx_init_captures, LangOpts.CPlusPlus11)
246EXTENSION(cxx_variable_templates, LangOpts.CPlusPlus)
247// Miscellaneous language extensions
248EXTENSION(overloadable_unmarked, true)
249EXTENSION(pragma_clang_attribute_namespaces, true)
250EXTENSION(pragma_clang_attribute_external_declaration, true)
251
252#undef EXTENSION
253#undef FEATURE
254
CodeThinker, Enjoy your reading code