1 //! List of the accepted feature gates.
3 use super::{to_nonzero, Feature, State};
4 use rustc_span::symbol::sym;
6 macro_rules! declare_features {
8 $(#[doc = $doc:tt])* (accepted, $feature:ident, $ver:expr, $issue:expr, None),
10 /// Those language feature has since been Accepted (it was once Active)
11 pub const ACCEPTED_FEATURES: &[Feature] = &[
14 state: State::Accepted,
17 issue: to_nonzero($issue),
27 // -------------------------------------------------------------------------
28 // feature-group-start: for testing purposes
29 // -------------------------------------------------------------------------
31 /// A temporary feature gate used to enable parser extensions needed
32 /// to bootstrap fix for #5723.
33 (accepted, issue_5723_bootstrap, "1.0.0", None, None),
34 /// These are used to test this portion of the compiler,
35 /// they don't actually mean anything.
36 (accepted, test_accepted_feature, "1.0.0", None, None),
37 // !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!!
38 // Features are listed in alphabetical order. Tidy will fail if you don't keep it this way.
39 // !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!!
41 // -------------------------------------------------------------------------
42 // feature-group-end: for testing purposes
43 // -------------------------------------------------------------------------
45 // -------------------------------------------------------------------------
46 // feature-group-start: accepted features
47 // -------------------------------------------------------------------------
49 /// Allows `#[target_feature(...)]` on aarch64 platforms
50 (accepted, aarch64_target_feature, "1.61.0", Some(44839), None),
51 /// Allows the sysV64 ABI to be specified on all platforms
52 /// instead of just the platforms on which it is the C ABI.
53 (accepted, abi_sysv64, "1.24.0", Some(36167), None),
54 /// Allows using ADX intrinsics from `core::arch::{x86, x86_64}`.
55 (accepted, adx_target_feature, "1.61.0", Some(44839), None),
56 /// Allows the definition of associated constants in `trait` or `impl` blocks.
57 (accepted, associated_consts, "1.20.0", Some(29646), None),
58 /// Allows using associated `type`s in `trait`s.
59 (accepted, associated_types, "1.0.0", None, None),
60 /// Allows free and inherent `async fn`s, `async` blocks, and `<expr>.await` expressions.
61 (accepted, async_await, "1.39.0", Some(50547), None),
62 /// Allows all literals in attribute lists and values of key-value pairs.
63 (accepted, attr_literals, "1.30.0", Some(34981), None),
64 /// Allows overloading augmented assignment operations like `a += b`.
65 (accepted, augmented_assignments, "1.8.0", Some(28235), None),
66 /// Allows mixing bind-by-move in patterns and references to those identifiers in guards.
67 (accepted, bind_by_move_pattern_guards, "1.39.0", Some(15287), None),
68 /// Allows bindings in the subpattern of a binding pattern.
69 /// For example, you can write `x @ Some(y)`.
70 (accepted, bindings_after_at, "1.56.0", Some(65490), None),
71 /// Allows empty structs and enum variants with braces.
72 (accepted, braced_empty_structs, "1.8.0", Some(29720), None),
73 /// Allows `#[cfg_attr(predicate, multiple, attributes, here)]`.
74 (accepted, cfg_attr_multi, "1.33.0", Some(54881), None),
75 /// Allows the use of `#[cfg(doctest)]`, set when rustdoc is collecting doctests.
76 (accepted, cfg_doctest, "1.40.0", Some(62210), None),
77 /// Enables `#[cfg(panic = "...")]` config key.
78 (accepted, cfg_panic, "1.60.0", Some(77443), None),
79 /// Allows `cfg(target_feature = "...")`.
80 (accepted, cfg_target_feature, "1.27.0", Some(29717), None),
81 /// Allows `cfg(target_vendor = "...")`.
82 (accepted, cfg_target_vendor, "1.33.0", Some(29718), None),
83 /// Allows implementing `Clone` for closures where possible (RFC 2132).
84 (accepted, clone_closures, "1.26.0", Some(44490), None),
85 /// Allows coercing non capturing closures to function pointers.
86 (accepted, closure_to_fn_coercion, "1.19.0", Some(39817), None),
87 /// Allows usage of the `compile_error!` macro.
88 (accepted, compile_error, "1.20.0", Some(40872), None),
89 /// Allows `impl Trait` in function return types.
90 (accepted, conservative_impl_trait, "1.26.0", Some(34511), None),
91 /// Allows calling constructor functions in `const fn`.
92 (accepted, const_constructor, "1.40.0", Some(61456), None),
93 /// Allows using and casting function pointers in a `const fn`.
94 (accepted, const_fn_fn_ptr_basics, "1.61.0", Some(57563), None),
95 /// Allows trait bounds in `const fn`.
96 (accepted, const_fn_trait_bound, "1.61.0", Some(93706), None),
97 /// Allows calling `transmute` in const fn
98 (accepted, const_fn_transmute, "1.56.0", Some(53605), None),
99 /// Allows accessing fields of unions inside `const` functions.
100 (accepted, const_fn_union, "1.56.0", Some(51909), None),
101 /// Allows unsizing coercions in `const fn`.
102 (accepted, const_fn_unsize, "1.54.0", Some(64992), None),
103 /// Allows const generics to have default values (e.g. `struct Foo<const N: usize = 3>(...);`).
104 (accepted, const_generics_defaults, "1.59.0", Some(44580), None),
105 /// Allows the use of `if` and `match` in constants.
106 (accepted, const_if_match, "1.46.0", Some(49146), None),
107 /// Allows argument and return position `impl Trait` in a `const fn`.
108 (accepted, const_impl_trait, "1.61.0", Some(77463), None),
109 /// Allows indexing into constant arrays.
110 (accepted, const_indexing, "1.26.0", Some(29947), None),
111 /// Allows let bindings, assignments and destructuring in `const` functions and constants.
112 /// As long as control flow is not implemented in const eval, `&&` and `||` may not be used
113 /// at the same time as let bindings.
114 (accepted, const_let, "1.33.0", Some(48821), None),
115 /// Allows the use of `loop` and `while` in constants.
116 (accepted, const_loop, "1.46.0", Some(52000), None),
117 /// Allows panicking during const eval (producing compile-time errors).
118 (accepted, const_panic, "1.57.0", Some(51999), None),
119 /// Allows dereferencing raw pointers during const eval.
120 (accepted, const_raw_ptr_deref, "1.58.0", Some(51911), None),
121 /// Allows implementing `Copy` for closures where possible (RFC 2132).
122 (accepted, copy_closures, "1.26.0", Some(44490), None),
123 /// Allows `crate` in paths.
124 (accepted, crate_in_paths, "1.30.0", Some(45477), None),
125 /// Allows using assigning a default type to type parameters in algebraic data type definitions.
126 (accepted, default_type_params, "1.0.0", None, None),
127 /// Allows `#[deprecated]` attribute.
128 (accepted, deprecated, "1.9.0", Some(29935), None),
129 /// Allows the use of destructuring assignments.
130 (accepted, destructuring_assignment, "1.59.0", Some(71126), None),
131 /// Allows `#[doc(alias = "...")]`.
132 (accepted, doc_alias, "1.48.0", Some(50146), None),
133 /// Allows `..` in tuple (struct) patterns.
134 (accepted, dotdot_in_tuple_patterns, "1.14.0", Some(33627), None),
135 /// Allows `..=` in patterns (RFC 1192).
136 (accepted, dotdoteq_in_patterns, "1.26.0", Some(28237), None),
137 /// Allows `Drop` types in constants (RFC 1440).
138 (accepted, drop_types_in_const, "1.22.0", Some(33156), None),
139 /// Allows using `dyn Trait` as a syntax for trait objects.
140 (accepted, dyn_trait, "1.27.0", Some(44662), None),
141 /// Allows integer match exhaustiveness checking (RFC 2591).
142 (accepted, exhaustive_integer_patterns, "1.33.0", Some(50907), None),
143 /// Allows arbitrary expressions in key-value attributes at parse time.
144 (accepted, extended_key_value_attributes, "1.54.0", Some(78835), None),
145 /// Allows resolving absolute paths as paths from other crates.
146 (accepted, extern_absolute_paths, "1.30.0", Some(44660), None),
147 /// Allows `extern crate foo as bar;`. This puts `bar` into extern prelude.
148 (accepted, extern_crate_item_prelude, "1.31.0", Some(55599), None),
149 /// Allows `extern crate self as foo;`.
150 /// This puts local crate root into extern prelude under name `foo`.
151 (accepted, extern_crate_self, "1.34.0", Some(56409), None),
152 /// Allows access to crate names passed via `--extern` through prelude.
153 (accepted, extern_prelude, "1.30.0", Some(44660), None),
154 /// Allows field shorthands (`x` meaning `x: x`) in struct literal expressions.
155 (accepted, field_init_shorthand, "1.17.0", Some(37340), None),
156 /// Allows `#[must_use]` on functions, and introduces must-use operators (RFC 1940).
157 (accepted, fn_must_use, "1.27.0", Some(43302), None),
158 /// Allows capturing variables in scope using format_args!
159 (accepted, format_args_capture, "1.58.0", Some(67984), None),
160 /// Allows attributes on lifetime/type formal parameters in generics (RFC 1327).
161 (accepted, generic_param_attrs, "1.27.0", Some(48848), None),
162 /// Allows the `#[global_allocator]` attribute.
163 (accepted, global_allocator, "1.28.0", Some(27389), None),
164 // FIXME: explain `globs`.
165 (accepted, globs, "1.0.0", None, None),
166 /// Allows using the `u128` and `i128` types.
167 (accepted, i128_type, "1.26.0", Some(35118), None),
168 /// Allows the use of `if let` expressions.
169 (accepted, if_let, "1.0.0", None, None),
170 /// Allows top level or-patterns (`p | q`) in `if let` and `while let`.
171 (accepted, if_while_or_patterns, "1.33.0", Some(48215), None),
172 /// Allows lifetime elision in `impl` headers. For example:
173 /// + `impl<I:Iterator> Iterator for &mut Iterator`
174 /// + `impl Debug for Foo<'_>`
175 (accepted, impl_header_lifetime_elision, "1.31.0", Some(15872), None),
176 /// Allows using `a..=b` and `..=b` as inclusive range syntaxes.
177 (accepted, inclusive_range_syntax, "1.26.0", Some(28237), None),
178 /// Allows inferring outlives requirements (RFC 2093).
179 (accepted, infer_outlives_requirements, "1.30.0", Some(44493), None),
180 /// Allows irrefutable patterns in `if let` and `while let` statements (RFC 2086).
181 (accepted, irrefutable_let_patterns, "1.33.0", Some(44495), None),
182 /// Allows some increased flexibility in the name resolution rules,
183 /// especially around globs and shadowing (RFC 1560).
184 (accepted, item_like_imports, "1.15.0", Some(35120), None),
185 /// Allows `break {expr}` with a value inside `loop`s.
186 (accepted, loop_break_value, "1.19.0", Some(37339), None),
187 /// Allows use of `?` as the Kleene "at most one" operator in macros.
188 (accepted, macro_at_most_once_rep, "1.32.0", Some(48075), None),
189 /// Allows macro attributes to observe output of `#[derive]`.
190 (accepted, macro_attributes_in_derive_output, "1.57.0", Some(81119), None),
191 /// Allows use of the `:lifetime` macro fragment specifier.
192 (accepted, macro_lifetime_matcher, "1.27.0", Some(34303), None),
193 /// Allows use of the `:literal` macro fragment specifier (RFC 1576).
194 (accepted, macro_literal_matcher, "1.32.0", Some(35625), None),
195 /// Allows `macro_rules!` items.
196 (accepted, macro_rules, "1.0.0", None, None),
197 /// Allows use of the `:vis` macro fragment specifier
198 (accepted, macro_vis_matcher, "1.30.0", Some(41022), None),
199 /// Allows macro invocations in `extern {}` blocks.
200 (accepted, macros_in_extern, "1.40.0", Some(49476), None),
201 /// Allows '|' at beginning of match arms (RFC 1925).
202 (accepted, match_beginning_vert, "1.25.0", Some(44101), None),
203 /// Allows default match binding modes (RFC 2005).
204 (accepted, match_default_bindings, "1.26.0", Some(42640), None),
205 /// Allows `impl Trait` with multiple unrelated lifetimes.
206 (accepted, member_constraints, "1.54.0", Some(61997), None),
207 /// Allows the definition of `const fn` functions.
208 (accepted, min_const_fn, "1.31.0", Some(53555), None),
209 /// The smallest useful subset of const generics.
210 (accepted, min_const_generics, "1.51.0", Some(74878), None),
211 /// Allows calling `const unsafe fn` inside `unsafe` blocks in `const fn` functions.
212 (accepted, min_const_unsafe_fn, "1.33.0", Some(55607), None),
213 /// Allows using `Self` and associated types in struct expressions and patterns.
214 (accepted, more_struct_aliases, "1.16.0", Some(37544), None),
215 /// Allows patterns with concurrent by-move and by-ref bindings.
216 /// For example, you can write `Foo(a, ref b)` where `a` is by-move and `b` is by-ref.
217 (accepted, move_ref_pattern, "1.49.0", Some(68354), None),
218 /// Allows using `#![no_std]`.
219 (accepted, no_std, "1.6.0", None, None),
220 /// Allows defining identifiers beyond ASCII.
221 (accepted, non_ascii_idents, "1.53.0", Some(55467), None),
222 /// Allows future-proofing enums/structs with the `#[non_exhaustive]` attribute (RFC 2008).
223 (accepted, non_exhaustive, "1.40.0", Some(44109), None),
224 /// Allows `foo.rs` as an alternative to `foo/mod.rs`.
225 (accepted, non_modrs_mods, "1.30.0", Some(44660), None),
226 /// Allows the use of or-patterns (e.g., `0 | 1`).
227 (accepted, or_patterns, "1.53.0", Some(54883), None),
228 /// Allows annotating functions conforming to `fn(&PanicInfo) -> !` with `#[panic_handler]`.
229 /// This defines the behavior of panics.
230 (accepted, panic_handler, "1.30.0", Some(44489), None),
231 /// Allows attributes in formal function parameters.
232 (accepted, param_attrs, "1.39.0", Some(60406), None),
233 /// Allows parentheses in patterns.
234 (accepted, pattern_parentheses, "1.31.0", Some(51087), None),
235 /// Allows procedural macros in `proc-macro` crates.
236 (accepted, proc_macro, "1.29.0", Some(38356), None),
237 /// Allows multi-segment paths in attributes and derives.
238 (accepted, proc_macro_path_invoc, "1.30.0", Some(38356), None),
239 /// Allows `pub(restricted)` visibilities (RFC 1422).
240 (accepted, pub_restricted, "1.18.0", Some(32409), None),
241 /// Allows use of the postfix `?` operator in expressions.
242 (accepted, question_mark, "1.13.0", Some(31436), None),
243 /// Allows keywords to be escaped for use as identifiers.
244 (accepted, raw_identifiers, "1.30.0", Some(48589), None),
245 /// Allows relaxing the coherence rules such that
246 /// `impl<T> ForeignTrait<LocalType> for ForeignType<T>` is permitted.
247 (accepted, re_rebalance_coherence, "1.41.0", Some(55437), None),
248 /// Allows numeric fields in struct expressions and patterns.
249 (accepted, relaxed_adts, "1.19.0", Some(35626), None),
250 /// Lessens the requirements for structs to implement `Unsize`.
251 (accepted, relaxed_struct_unsize, "1.58.0", Some(81793), None),
252 /// Allows `repr(align(16))` struct attribute (RFC 1358).
253 (accepted, repr_align, "1.25.0", Some(33626), None),
254 /// Allows using `#[repr(align(X))]` on enums with equivalent semantics
255 /// to wrapping an enum in a wrapper struct with `#[repr(align(X))]`.
256 (accepted, repr_align_enum, "1.37.0", Some(57996), None),
257 /// Allows `#[repr(packed(N))]` attribute on structs.
258 (accepted, repr_packed, "1.33.0", Some(33158), None),
259 /// Allows `#[repr(transparent)]` attribute on newtype structs.
260 (accepted, repr_transparent, "1.28.0", Some(43036), None),
261 /// Allows code like `let x: &'static u32 = &42` to work (RFC 1414).
262 (accepted, rvalue_static_promotion, "1.21.0", Some(38865), None),
263 /// Allows `Self` in type definitions (RFC 2300).
264 (accepted, self_in_typedefs, "1.32.0", Some(49303), None),
265 /// Allows `Self` struct constructor (RFC 2302).
266 (accepted, self_struct_ctor, "1.32.0", Some(51994), None),
267 /// Allows using subslice patterns, `[a, .., b]` and `[a, xs @ .., b]`.
268 (accepted, slice_patterns, "1.42.0", Some(62254), None),
269 /// Allows use of `&foo[a..b]` as a slicing syntax.
270 (accepted, slicing_syntax, "1.0.0", None, None),
271 /// Allows elision of `'static` lifetimes in `static`s and `const`s.
272 (accepted, static_in_const, "1.17.0", Some(35897), None),
273 /// Allows the definition recursive static items.
274 (accepted, static_recursion, "1.17.0", Some(29719), None),
275 /// Allows attributes on struct literal fields.
276 (accepted, struct_field_attributes, "1.20.0", Some(38814), None),
277 /// Allows struct variants `Foo { baz: u8, .. }` in enums (RFC 418).
278 (accepted, struct_variant, "1.0.0", None, None),
279 /// Allows `#[target_feature(...)]`.
280 (accepted, target_feature, "1.27.0", None, None),
281 /// Allows `fn main()` with return types which implements `Termination` (RFC 1937).
282 (accepted, termination_trait, "1.26.0", Some(43301), None),
283 /// Allows `#[test]` functions where the return type implements `Termination` (RFC 1937).
284 (accepted, termination_trait_test, "1.27.0", Some(48854), None),
285 /// Allows attributes scoped to tools.
286 (accepted, tool_attributes, "1.30.0", Some(44690), None),
287 /// Allows scoped lints.
288 (accepted, tool_lints, "1.31.0", Some(44690), None),
289 /// Allows `#[track_caller]` to be used which provides
290 /// accurate caller location reporting during panic (RFC 2091).
291 (accepted, track_caller, "1.46.0", Some(47809), None),
292 /// Allows #[repr(transparent)] on univariant enums (RFC 2645).
293 (accepted, transparent_enums, "1.42.0", Some(60405), None),
294 /// Allows indexing tuples.
295 (accepted, tuple_indexing, "1.0.0", None, None),
296 /// Allows paths to enum variants on type aliases including `Self`.
297 (accepted, type_alias_enum_variants, "1.37.0", Some(49683), None),
298 /// Allows macros to appear in the type position.
299 (accepted, type_macros, "1.13.0", Some(27245), None),
300 /// Allows `const _: TYPE = VALUE`.
301 (accepted, underscore_const_names, "1.37.0", Some(54912), None),
302 /// Allows `use path as _;` and `extern crate c as _;`.
303 (accepted, underscore_imports, "1.33.0", Some(48216), None),
304 /// Allows `'_` placeholder lifetimes.
305 (accepted, underscore_lifetimes, "1.26.0", Some(44524), None),
306 /// Allows `use x::y;` to search `x` in the current scope.
307 (accepted, uniform_paths, "1.32.0", Some(53130), None),
308 /// Allows `impl Trait` in function arguments.
309 (accepted, universal_impl_trait, "1.26.0", Some(34511), None),
310 /// Allows arbitrary delimited token streams in non-macro attributes.
311 (accepted, unrestricted_attribute_tokens, "1.34.0", Some(55208), None),
312 /// The `unsafe_op_in_unsafe_fn` lint (allowed by default): no longer treat an unsafe function as an unsafe block.
313 (accepted, unsafe_block_in_unsafe_fn, "1.52.0", Some(71668), None),
314 /// Allows importing and reexporting macros with `use`,
315 /// enables macro modularization in general.
316 (accepted, use_extern_macros, "1.30.0", Some(35896), None),
317 /// Allows nested groups in `use` items (RFC 2128).
318 (accepted, use_nested_groups, "1.25.0", Some(44494), None),
319 /// Allows `#[used]` to preserve symbols (see llvm.compiler.used).
320 (accepted, used, "1.30.0", Some(40289), None),
321 /// Allows the use of `while let` expressions.
322 (accepted, while_let, "1.0.0", None, None),
323 /// Allows `#![windows_subsystem]`.
324 (accepted, windows_subsystem, "1.18.0", Some(37499), None),
325 // !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!!
326 // Features are listed in alphabetical order. Tidy will fail if you don't keep it this way.
327 // !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!! !!!!
329 // -------------------------------------------------------------------------
330 // feature-group-end: accepted features
331 // -------------------------------------------------------------------------