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