1 use super::{Parser, PathStyle, TokenType}
;
3 use crate::{maybe_recover_from_interpolated_ty_qpath, maybe_whole}
;
6 use rustc_ast
::token
::{self, Token, TokenKind}
;
7 use rustc_ast
::{self as ast, BareFnTy, FnRetTy, GenericParam, Lifetime, MutTy, Ty, TyKind}
;
8 use rustc_ast
::{GenericBound, GenericBounds, MacCall, Mutability}
;
9 use rustc_ast
::{PolyTraitRef, TraitBoundModifier, TraitObjectSyntax}
;
10 use rustc_errors
::{pluralize, struct_span_err, Applicability, PResult}
;
11 use rustc_span
::source_map
::Span
;
12 use rustc_span
::symbol
::{kw, sym}
;
14 /// Any `?` or `?const` modifiers that appear at the start of a bound.
15 struct BoundModifiers
{
20 maybe_const
: Option
<Span
>,
24 fn to_trait_bound_modifier(&self) -> TraitBoundModifier
{
25 match (self.maybe
, self.maybe_const
) {
26 (None
, None
) => TraitBoundModifier
::None
,
27 (Some(_
), None
) => TraitBoundModifier
::Maybe
,
28 (None
, Some(_
)) => TraitBoundModifier
::MaybeConst
,
29 (Some(_
), Some(_
)) => TraitBoundModifier
::MaybeConstMaybe
,
34 #[derive(Copy, Clone, PartialEq)]
35 pub(super) enum AllowPlus
{
41 pub(super) enum RecoverQPath
{
46 /// Signals whether parsing a type should recover `->`.
48 /// More specifically, when parsing a function like:
50 /// fn foo() => u8 { 0 }
51 /// fn bar(): u8 { 0 }
53 /// The compiler will try to recover interpreting `foo() => u8` as `foo() -> u8` when calling
54 /// `parse_ty` with anything except `RecoverReturnSign::No`, and it will try to recover `bar(): u8`
55 /// as `bar() -> u8` when passing `RecoverReturnSign::Yes` to `parse_ty`
56 #[derive(Copy, Clone, PartialEq)]
57 pub(super) enum RecoverReturnSign
{
63 impl RecoverReturnSign
{
64 /// [RecoverReturnSign::Yes] allows for recovering `fn foo() => u8` and `fn foo(): u8`,
65 /// [RecoverReturnSign::OnlyFatArrow] allows for recovering only `fn foo() => u8` (recovering
66 /// colons can cause problems when parsing where clauses), and
67 /// [RecoverReturnSign::No] doesn't allow for any recovery of the return type arrow
68 fn can_recover(self, token
: &TokenKind
) -> bool
{
70 Self::Yes
=> matches
!(token
, token
::FatArrow
| token
::Colon
),
71 Self::OnlyFatArrow
=> matches
!(token
, token
::FatArrow
),
77 // Is `...` (`CVarArgs`) legal at this level of type parsing?
84 /// Returns `true` if `IDENT t` can start a type -- `IDENT::a::b`, `IDENT<u8, u8>`,
85 /// `IDENT<<u8 as Trait>::AssocTy>`.
87 /// Types can also be of the form `IDENT(u8, u8) -> u8`, however this assumes
88 /// that `IDENT` is not the ident of a fn trait.
89 fn can_continue_type_after_non_fn_ident(t
: &Token
) -> bool
{
90 t
== &token
::ModSep
|| t
== &token
::Lt
|| t
== &token
::BinOp(token
::Shl
)
95 pub fn parse_ty(&mut self) -> PResult
<'a
, P
<Ty
>> {
100 RecoverReturnSign
::Yes
,
104 /// Parse a type suitable for a function or function pointer parameter.
105 /// The difference from `parse_ty` is that this version allows `...`
106 /// (`CVarArgs`) at the top level of the type.
107 pub(super) fn parse_ty_for_param(&mut self) -> PResult
<'a
, P
<Ty
>> {
108 self.parse_ty_common(
112 RecoverReturnSign
::Yes
,
116 /// Parses a type in restricted contexts where `+` is not permitted.
118 /// Example 1: `&'a TYPE`
119 /// `+` is prohibited to maintain operator priority (P(+) < P(&)).
120 /// Example 2: `value1 as TYPE + value2`
121 /// `+` is prohibited to avoid interactions with expression grammar.
122 pub(super) fn parse_ty_no_plus(&mut self) -> PResult
<'a
, P
<Ty
>> {
123 self.parse_ty_common(
127 RecoverReturnSign
::Yes
,
131 /// Parse a type without recovering `:` as `->` to avoid breaking code such as `where fn() : for<'a>`
132 pub(super) fn parse_ty_for_where_clause(&mut self) -> PResult
<'a
, P
<Ty
>> {
133 self.parse_ty_common(
137 RecoverReturnSign
::OnlyFatArrow
,
141 /// Parses an optional return type `[ -> TY ]` in a function declaration.
142 pub(super) fn parse_ret_ty(
144 allow_plus
: AllowPlus
,
145 recover_qpath
: RecoverQPath
,
146 recover_return_sign
: RecoverReturnSign
,
147 ) -> PResult
<'a
, FnRetTy
> {
148 Ok(if self.eat(&token
::RArrow
) {
149 // FIXME(Centril): Can we unconditionally `allow_plus`?
150 let ty
= self.parse_ty_common(
157 } else if recover_return_sign
.can_recover(&self.token
.kind
) {
158 // Don't `eat` to prevent `=>` from being added as an expected token which isn't
159 // actually expected and could only confuse users
161 self.struct_span_err(self.prev_token
.span
, "return types are denoted using `->`")
162 .span_suggestion_short(
163 self.prev_token
.span
,
166 Applicability
::MachineApplicable
,
169 let ty
= self.parse_ty_common(
177 FnRetTy
::Default(self.token
.span
.shrink_to_lo())
183 allow_plus
: AllowPlus
,
184 allow_c_variadic
: AllowCVariadic
,
185 recover_qpath
: RecoverQPath
,
186 recover_return_sign
: RecoverReturnSign
,
187 ) -> PResult
<'a
, P
<Ty
>> {
188 let allow_qpath_recovery
= recover_qpath
== RecoverQPath
::Yes
;
189 maybe_recover_from_interpolated_ty_qpath
!(self, allow_qpath_recovery
);
190 maybe_whole
!(self, NtTy
, |x
| x
);
192 let lo
= self.token
.span
;
193 let mut impl_dyn_multi
= false;
194 let kind
= if self.check(&token
::OpenDelim(token
::Paren
)) {
195 self.parse_ty_tuple_or_parens(lo
, allow_plus
)?
196 } else if self.eat(&token
::Not
) {
199 } else if self.eat(&token
::BinOp(token
::Star
)) {
201 } else if self.eat(&token
::OpenDelim(token
::Bracket
)) {
202 self.parse_array_or_slice_ty()?
203 } else if self.check(&token
::BinOp(token
::And
)) || self.check(&token
::AndAnd
) {
206 self.parse_borrowed_pointee()?
207 } else if self.eat_keyword_noexpect(kw
::Typeof
) {
208 self.parse_typeof_ty()?
209 } else if self.eat_keyword(kw
::Underscore
) {
210 // A type to be inferred `_`
212 } else if self.check_fn_front_matter(false) {
213 // Function pointer type
214 self.parse_ty_bare_fn(lo
, Vec
::new(), recover_return_sign
)?
215 } else if self.check_keyword(kw
::For
) {
216 // Function pointer type or bound list (trait object type) starting with a poly-trait.
217 // `for<'lt> [unsafe] [extern "ABI"] fn (&'lt S) -> T`
218 // `for<'lt> Trait1<'lt> + Trait2 + 'a`
219 let lifetime_defs
= self.parse_late_bound_lifetime_defs()?
;
220 if self.check_fn_front_matter(false) {
221 self.parse_ty_bare_fn(lo
, lifetime_defs
, recover_return_sign
)?
223 let path
= self.parse_path(PathStyle
::Type
)?
;
224 let parse_plus
= allow_plus
== AllowPlus
::Yes
&& self.check_plus();
225 self.parse_remaining_bounds_path(lifetime_defs
, path
, lo
, parse_plus
)?
227 } else if self.eat_keyword(kw
::Impl
) {
228 self.parse_impl_ty(&mut impl_dyn_multi
)?
229 } else if self.token
.is_keyword(kw
::Union
)
230 && self.look_ahead(1, |t
| t
== &token
::OpenDelim(token
::Brace
))
233 let (fields
, recovered
) = self.parse_record_struct_body("union")?
;
234 let span
= lo
.to(self.prev_token
.span
);
235 self.sess
.gated_spans
.gate(sym
::unnamed_fields
, span
);
236 TyKind
::AnonymousUnion(fields
, recovered
)
237 } else if self.eat_keyword(kw
::Struct
) {
238 let (fields
, recovered
) = self.parse_record_struct_body("struct")?
;
239 let span
= lo
.to(self.prev_token
.span
);
240 self.sess
.gated_spans
.gate(sym
::unnamed_fields
, span
);
241 TyKind
::AnonymousStruct(fields
, recovered
)
242 } else if self.is_explicit_dyn_type() {
243 self.parse_dyn_ty(&mut impl_dyn_multi
)?
244 } else if self.eat_lt() {
246 let (qself
, path
) = self.parse_qpath(PathStyle
::Type
)?
;
247 TyKind
::Path(Some(qself
), path
)
248 } else if self.check_path() {
249 self.parse_path_start_ty(lo
, allow_plus
)?
250 } else if self.can_begin_bound() {
251 self.parse_bare_trait_object(lo
, allow_plus
)?
252 } else if self.eat(&token
::DotDotDot
) {
253 if allow_c_variadic
== AllowCVariadic
::Yes
{
256 // FIXME(Centril): Should we just allow `...` syntactically
257 // anywhere in a type and use semantic restrictions instead?
258 self.error_illegal_c_varadic_ty(lo
);
262 let msg
= format
!("expected type, found {}", super::token_descr(&self.token
));
263 let mut err
= self.struct_span_err(self.token
.span
, &msg
);
264 err
.span_label(self.token
.span
, "expected type");
265 self.maybe_annotate_with_ascription(&mut err
, true);
269 let span
= lo
.to(self.prev_token
.span
);
270 let ty
= self.mk_ty(span
, kind
);
272 // Try to recover from use of `+` with incorrect priority.
273 self.maybe_report_ambiguous_plus(allow_plus
, impl_dyn_multi
, &ty
);
274 self.maybe_recover_from_bad_type_plus(allow_plus
, &ty
)?
;
275 self.maybe_recover_from_bad_qpath(ty
, allow_qpath_recovery
)
279 /// - `(TYPE)`, a parenthesized type.
280 /// - `(TYPE,)`, a tuple with a single field of type TYPE.
281 fn parse_ty_tuple_or_parens(&mut self, lo
: Span
, allow_plus
: AllowPlus
) -> PResult
<'a
, TyKind
> {
282 let mut trailing_plus
= false;
283 let (ts
, trailing
) = self.parse_paren_comma_seq(|p
| {
284 let ty
= p
.parse_ty()?
;
285 trailing_plus
= p
.prev_token
.kind
== TokenKind
::BinOp(token
::Plus
);
289 if ts
.len() == 1 && !trailing
{
290 let ty
= ts
.into_iter().next().unwrap().into_inner();
291 let maybe_bounds
= allow_plus
== AllowPlus
::Yes
&& self.token
.is_like_plus();
293 // `(TY_BOUND_NOPAREN) + BOUND + ...`.
294 TyKind
::Path(None
, path
) if maybe_bounds
=> {
295 self.parse_remaining_bounds_path(Vec
::new(), path
, lo
, true)
297 TyKind
::TraitObject(bounds
, TraitObjectSyntax
::None
)
298 if maybe_bounds
&& bounds
.len() == 1 && !trailing_plus
=>
300 self.parse_remaining_bounds(bounds
, true)
303 _
=> Ok(TyKind
::Paren(P(ty
))),
310 fn parse_bare_trait_object(&mut self, lo
: Span
, allow_plus
: AllowPlus
) -> PResult
<'a
, TyKind
> {
311 let lt_no_plus
= self.check_lifetime() && !self.look_ahead(1, |t
| t
.is_like_plus());
312 let bounds
= self.parse_generic_bounds_common(allow_plus
, None
)?
;
314 self.struct_span_err(lo
, "lifetime in trait object type must be followed by `+`").emit()
316 Ok(TyKind
::TraitObject(bounds
, TraitObjectSyntax
::None
))
319 fn parse_remaining_bounds_path(
321 generic_params
: Vec
<GenericParam
>,
325 ) -> PResult
<'a
, TyKind
> {
326 let poly_trait_ref
= PolyTraitRef
::new(generic_params
, path
, lo
.to(self.prev_token
.span
));
327 let bounds
= vec
![GenericBound
::Trait(poly_trait_ref
, TraitBoundModifier
::None
)];
328 self.parse_remaining_bounds(bounds
, parse_plus
)
331 /// Parse the remainder of a bare trait object type given an already parsed list.
332 fn parse_remaining_bounds(
334 mut bounds
: GenericBounds
,
336 ) -> PResult
<'a
, TyKind
> {
338 self.eat_plus(); // `+`, or `+=` gets split and `+` is discarded
339 bounds
.append(&mut self.parse_generic_bounds(Some(self.prev_token
.span
))?
);
341 Ok(TyKind
::TraitObject(bounds
, TraitObjectSyntax
::None
))
344 /// Parses a raw pointer type: `*[const | mut] $type`.
345 fn parse_ty_ptr(&mut self) -> PResult
<'a
, TyKind
> {
346 let mutbl
= self.parse_const_or_mut().unwrap_or_else(|| {
347 let span
= self.prev_token
.span
;
348 let msg
= "expected mut or const in raw pointer type";
349 self.struct_span_err(span
, msg
)
350 .span_label(span
, msg
)
351 .help("use `*mut T` or `*const T` as appropriate")
355 let ty
= self.parse_ty_no_plus()?
;
356 Ok(TyKind
::Ptr(MutTy { ty, mutbl }
))
359 /// Parses an array (`[TYPE; EXPR]`) or slice (`[TYPE]`) type.
360 /// The opening `[` bracket is already eaten.
361 fn parse_array_or_slice_ty(&mut self) -> PResult
<'a
, TyKind
> {
362 let elt_ty
= match self.parse_ty() {
365 if self.look_ahead(1, |t
| t
.kind
== token
::CloseDelim(token
::Bracket
))
366 | self.look_ahead(1, |t
| t
.kind
== token
::Semi
) =>
368 // Recover from `[LIT; EXPR]` and `[LIT]`
371 self.mk_ty(self.prev_token
.span
, TyKind
::Err
)
373 Err(err
) => return Err(err
),
376 let ty
= if self.eat(&token
::Semi
) {
377 let mut length
= self.parse_anon_const_expr()?
;
378 if let Err(e
) = self.expect(&token
::CloseDelim(token
::Bracket
)) {
379 // Try to recover from `X<Y, ...>` when `X::<Y, ...>` works
380 self.check_mistyped_turbofish_with_multiple_type_params(e
, &mut length
.value
)?
;
381 self.expect(&token
::CloseDelim(token
::Bracket
))?
;
383 TyKind
::Array(elt_ty
, length
)
385 self.expect(&token
::CloseDelim(token
::Bracket
))?
;
386 TyKind
::Slice(elt_ty
)
392 fn parse_borrowed_pointee(&mut self) -> PResult
<'a
, TyKind
> {
393 let and_span
= self.prev_token
.span
;
394 let mut opt_lifetime
=
395 if self.check_lifetime() { Some(self.expect_lifetime()) }
else { None }
;
396 let mut mutbl
= self.parse_mutability();
397 if self.token
.is_lifetime() && mutbl
== Mutability
::Mut
&& opt_lifetime
.is_none() {
398 // A lifetime is invalid here: it would be part of a bare trait bound, which requires
399 // it to be followed by a plus, but we disallow plus in the pointee type.
400 // So we can handle this case as an error here, and suggest `'a mut`.
401 // If there *is* a plus next though, handling the error later provides better suggestions
402 // (like adding parentheses)
403 if !self.look_ahead(1, |t
| t
.is_like_plus()) {
404 let lifetime_span
= self.token
.span
;
405 let span
= and_span
.to(lifetime_span
);
407 let mut err
= self.struct_span_err(span
, "lifetime must precede `mut`");
408 if let Ok(lifetime_src
) = self.span_to_snippet(lifetime_span
) {
411 "place the lifetime before `mut`",
412 format
!("&{} mut", lifetime_src
),
413 Applicability
::MaybeIncorrect
,
418 opt_lifetime
= Some(self.expect_lifetime());
420 } else if self.token
.is_keyword(kw
::Dyn
)
421 && mutbl
== Mutability
::Not
422 && self.look_ahead(1, |t
| t
.is_keyword(kw
::Mut
))
424 // We have `&dyn mut ...`, which is invalid and should be `&mut dyn ...`.
425 let span
= and_span
.to(self.look_ahead(1, |t
| t
.span
));
426 let mut err
= self.struct_span_err(span
, "`mut` must precede `dyn`");
429 "place `mut` before `dyn`",
430 "&mut dyn".to_string(),
431 Applicability
::MachineApplicable
,
436 mutbl
= Mutability
::Mut
;
437 let (dyn_tok
, dyn_tok_sp
) = (self.token
.clone(), self.token_spacing
);
439 self.bump_with((dyn_tok
, dyn_tok_sp
));
441 let ty
= self.parse_ty_no_plus()?
;
442 Ok(TyKind
::Rptr(opt_lifetime
, MutTy { ty, mutbl }
))
445 // Parses the `typeof(EXPR)`.
446 // To avoid ambiguity, the type is surrounded by parenthesis.
447 fn parse_typeof_ty(&mut self) -> PResult
<'a
, TyKind
> {
448 self.expect(&token
::OpenDelim(token
::Paren
))?
;
449 let expr
= self.parse_anon_const_expr()?
;
450 self.expect(&token
::CloseDelim(token
::Paren
))?
;
451 Ok(TyKind
::Typeof(expr
))
454 /// Parses a function pointer type (`TyKind::BareFn`).
456 /// [unsafe] [extern "ABI"] fn (S) -> T
457 /// ^~~~~^ ^~~~^ ^~^ ^
459 /// | | | Return type
460 /// Function Style ABI Parameter types
462 /// We actually parse `FnHeader FnDecl`, but we error on `const` and `async` qualifiers.
466 params
: Vec
<GenericParam
>,
467 recover_return_sign
: RecoverReturnSign
,
468 ) -> PResult
<'a
, TyKind
> {
469 let ast
::FnHeader { ext, unsafety, constness, asyncness }
= self.parse_fn_front_matter()?
;
470 let decl
= self.parse_fn_decl(|_
| false, AllowPlus
::No
, recover_return_sign
)?
;
471 let whole_span
= lo
.to(self.prev_token
.span
);
472 if let ast
::Const
::Yes(span
) = constness
{
473 self.error_fn_ptr_bad_qualifier(whole_span
, span
, "const");
475 if let ast
::Async
::Yes { span, .. }
= asyncness
{
476 self.error_fn_ptr_bad_qualifier(whole_span
, span
, "async");
478 Ok(TyKind
::BareFn(P(BareFnTy { ext, unsafety, generic_params: params, decl }
)))
481 /// Emit an error for the given bad function pointer qualifier.
482 fn error_fn_ptr_bad_qualifier(&self, span
: Span
, qual_span
: Span
, qual
: &str) {
483 self.struct_span_err(span
, &format
!("an `fn` pointer type cannot be `{}`", qual
))
484 .span_label(qual_span
, format
!("`{}` because of this", qual
))
485 .span_suggestion_short(
487 &format
!("remove the `{}` qualifier", qual
),
489 Applicability
::MaybeIncorrect
,
494 /// Parses an `impl B0 + ... + Bn` type.
495 fn parse_impl_ty(&mut self, impl_dyn_multi
: &mut bool
) -> PResult
<'a
, TyKind
> {
496 // Always parse bounds greedily for better error recovery.
497 let bounds
= self.parse_generic_bounds(None
)?
;
498 *impl_dyn_multi
= bounds
.len() > 1 || self.prev_token
.kind
== TokenKind
::BinOp(token
::Plus
);
499 Ok(TyKind
::ImplTrait(ast
::DUMMY_NODE_ID
, bounds
))
502 /// Is a `dyn B0 + ... + Bn` type allowed here?
503 fn is_explicit_dyn_type(&mut self) -> bool
{
504 self.check_keyword(kw
::Dyn
)
505 && (!self.token
.uninterpolated_span().rust_2015()
506 || self.look_ahead(1, |t
| {
507 t
.can_begin_bound() && !can_continue_type_after_non_fn_ident(t
)
511 /// Parses a `dyn B0 + ... + Bn` type.
513 /// Note that this does *not* parse bare trait objects.
514 fn parse_dyn_ty(&mut self, impl_dyn_multi
: &mut bool
) -> PResult
<'a
, TyKind
> {
515 self.bump(); // `dyn`
516 // Always parse bounds greedily for better error recovery.
517 let bounds
= self.parse_generic_bounds(None
)?
;
518 *impl_dyn_multi
= bounds
.len() > 1 || self.prev_token
.kind
== TokenKind
::BinOp(token
::Plus
);
519 Ok(TyKind
::TraitObject(bounds
, TraitObjectSyntax
::Dyn
))
522 /// Parses a type starting with a path.
525 /// 1. a type macro, `mac!(...)`,
526 /// 2. a bare trait object, `B0 + ... + Bn`,
527 /// 3. or a path, `path::to::MyType`.
528 fn parse_path_start_ty(&mut self, lo
: Span
, allow_plus
: AllowPlus
) -> PResult
<'a
, TyKind
> {
530 let path
= self.parse_path(PathStyle
::Type
)?
;
531 if self.eat(&token
::Not
) {
532 // Macro invocation in type position
533 Ok(TyKind
::MacCall(MacCall
{
535 args
: self.parse_mac_args()?
,
536 prior_type_ascription
: self.last_type_ascription
,
538 } else if allow_plus
== AllowPlus
::Yes
&& self.check_plus() {
539 // `Trait1 + Trait2 + 'a`
540 self.parse_remaining_bounds_path(Vec
::new(), path
, lo
, true)
543 Ok(TyKind
::Path(None
, path
))
547 fn error_illegal_c_varadic_ty(&self, lo
: Span
) {
549 self.sess
.span_diagnostic
,
550 lo
.to(self.prev_token
.span
),
552 "C-variadic type `...` may not be nested inside another type",
557 pub(super) fn parse_generic_bounds(
559 colon_span
: Option
<Span
>,
560 ) -> PResult
<'a
, GenericBounds
> {
561 self.parse_generic_bounds_common(AllowPlus
::Yes
, colon_span
)
564 /// Parses bounds of a type parameter `BOUND + BOUND + ...`, possibly with trailing `+`.
566 /// See `parse_generic_bound` for the `BOUND` grammar.
567 fn parse_generic_bounds_common(
569 allow_plus
: AllowPlus
,
570 colon_span
: Option
<Span
>,
571 ) -> PResult
<'a
, GenericBounds
> {
572 let mut bounds
= Vec
::new();
573 let mut negative_bounds
= Vec
::new();
575 while self.can_begin_bound() || self.token
.is_keyword(kw
::Dyn
) {
576 if self.token
.is_keyword(kw
::Dyn
) {
577 // Account for `&dyn Trait + dyn Other`.
578 self.struct_span_err(self.token
.span
, "invalid `dyn` keyword")
579 .help("`dyn` is only needed at the start of a trait `+`-separated list")
582 "remove this keyword",
584 Applicability
::MachineApplicable
,
589 match self.parse_generic_bound()?
{
590 Ok(bound
) => bounds
.push(bound
),
591 Err(neg_sp
) => negative_bounds
.push(neg_sp
),
593 if allow_plus
== AllowPlus
::No
|| !self.eat_plus() {
598 if !negative_bounds
.is_empty() {
599 self.error_negative_bounds(colon_span
, &bounds
, negative_bounds
);
605 /// Can the current token begin a bound?
606 fn can_begin_bound(&mut self) -> bool
{
607 // This needs to be synchronized with `TokenKind::can_begin_bound`.
609 || self.check_lifetime()
610 || self.check(&token
::Not
) // Used for error reporting only.
611 || self.check(&token
::Question
)
612 || self.check_keyword(kw
::For
)
613 || self.check(&token
::OpenDelim(token
::Paren
))
616 fn error_negative_bounds(
618 colon_span
: Option
<Span
>,
619 bounds
: &[GenericBound
],
620 negative_bounds
: Vec
<Span
>,
622 let negative_bounds_len
= negative_bounds
.len();
623 let last_span
= *negative_bounds
.last().expect("no negative bounds, but still error?");
624 let mut err
= self.struct_span_err(negative_bounds
, "negative bounds are not supported");
625 err
.span_label(last_span
, "negative bounds are not supported");
626 if let Some(bound_list
) = colon_span
{
627 let bound_list
= bound_list
.to(self.prev_token
.span
);
628 let mut new_bound_list
= String
::new();
629 if !bounds
.is_empty() {
630 let mut snippets
= bounds
.iter().map(|bound
| self.span_to_snippet(bound
.span()));
631 while let Some(Ok(snippet
)) = snippets
.next() {
632 new_bound_list
.push_str(" + ");
633 new_bound_list
.push_str(&snippet
);
635 new_bound_list
= new_bound_list
.replacen(" +", ":", 1);
637 err
.tool_only_span_suggestion(
639 &format
!("remove the bound{}", pluralize
!(negative_bounds_len
)),
641 Applicability
::MachineApplicable
,
647 /// Parses a bound according to the grammar:
649 /// BOUND = TY_BOUND | LT_BOUND
651 fn parse_generic_bound(&mut self) -> PResult
<'a
, Result
<GenericBound
, Span
>> {
652 let anchor_lo
= self.prev_token
.span
;
653 let lo
= self.token
.span
;
654 let has_parens
= self.eat(&token
::OpenDelim(token
::Paren
));
655 let inner_lo
= self.token
.span
;
656 let is_negative
= self.eat(&token
::Not
);
658 let modifiers
= self.parse_ty_bound_modifiers();
659 let bound
= if self.token
.is_lifetime() {
660 self.error_lt_bound_with_modifiers(modifiers
);
661 self.parse_generic_lt_bound(lo
, inner_lo
, has_parens
)?
663 self.parse_generic_ty_bound(lo
, has_parens
, modifiers
)?
666 Ok(if is_negative { Err(anchor_lo.to(self.prev_token.span)) }
else { Ok(bound) }
)
669 /// Parses a lifetime ("outlives") bound, e.g. `'a`, according to:
671 /// LT_BOUND = LIFETIME
673 fn parse_generic_lt_bound(
678 ) -> PResult
<'a
, GenericBound
> {
679 let bound
= GenericBound
::Outlives(self.expect_lifetime());
681 // FIXME(Centril): Consider not erroring here and accepting `('lt)` instead,
682 // possibly introducing `GenericBound::Paren(P<GenericBound>)`?
683 self.recover_paren_lifetime(lo
, inner_lo
)?
;
688 /// Emits an error if any trait bound modifiers were present.
689 fn error_lt_bound_with_modifiers(&self, modifiers
: BoundModifiers
) {
690 if let Some(span
) = modifiers
.maybe_const
{
691 self.struct_span_err(
693 "`?const` may only modify trait bounds, not lifetime bounds",
698 if let Some(span
) = modifiers
.maybe
{
699 self.struct_span_err(span
, "`?` may only modify trait bounds, not lifetime bounds")
704 /// Recover on `('lifetime)` with `(` already eaten.
705 fn recover_paren_lifetime(&mut self, lo
: Span
, inner_lo
: Span
) -> PResult
<'a
, ()> {
706 let inner_span
= inner_lo
.to(self.prev_token
.span
);
707 self.expect(&token
::CloseDelim(token
::Paren
))?
;
708 let mut err
= self.struct_span_err(
709 lo
.to(self.prev_token
.span
),
710 "parenthesized lifetime bounds are not supported",
712 if let Ok(snippet
) = self.span_to_snippet(inner_span
) {
713 err
.span_suggestion_short(
714 lo
.to(self.prev_token
.span
),
715 "remove the parentheses",
717 Applicability
::MachineApplicable
,
724 /// Parses the modifiers that may precede a trait in a bound, e.g. `?Trait` or `?const Trait`.
726 /// If no modifiers are present, this does not consume any tokens.
729 /// TY_BOUND_MODIFIERS = "?" ["const" ["?"]]
731 fn parse_ty_bound_modifiers(&mut self) -> BoundModifiers
{
732 if !self.eat(&token
::Question
) {
733 return BoundModifiers { maybe: None, maybe_const: None }
;
737 let first_question
= self.prev_token
.span
;
738 if !self.eat_keyword(kw
::Const
) {
739 return BoundModifiers { maybe: Some(first_question), maybe_const: None }
;
743 let maybe_const
= first_question
.to(self.prev_token
.span
);
744 self.sess
.gated_spans
.gate(sym
::const_trait_bound_opt_out
, maybe_const
);
745 if !self.eat(&token
::Question
) {
746 return BoundModifiers { maybe: None, maybe_const: Some(maybe_const) }
;
750 let second_question
= self.prev_token
.span
;
751 BoundModifiers { maybe: Some(second_question), maybe_const: Some(maybe_const) }
754 /// Parses a type bound according to:
756 /// TY_BOUND = TY_BOUND_NOPAREN | (TY_BOUND_NOPAREN)
757 /// TY_BOUND_NOPAREN = [TY_BOUND_MODIFIERS] [for<LT_PARAM_DEFS>] SIMPLE_PATH
760 /// For example, this grammar accepts `?const ?for<'a: 'b> m::Trait<'a>`.
761 fn parse_generic_ty_bound(
765 modifiers
: BoundModifiers
,
766 ) -> PResult
<'a
, GenericBound
> {
767 let lifetime_defs
= self.parse_late_bound_lifetime_defs()?
;
768 let path
= self.parse_path(PathStyle
::Type
)?
;
770 if self.token
.is_like_plus() {
771 // Someone has written something like `&dyn (Trait + Other)`. The correct code
772 // would be `&(dyn Trait + Other)`, but we don't have access to the appropriate
773 // span to suggest that. When written as `&dyn Trait + Other`, an appropriate
774 // suggestion is given.
776 self.parse_remaining_bounds(bounds
, true)?
;
777 self.expect(&token
::CloseDelim(token
::Paren
))?
;
778 let sp
= vec
![lo
, self.prev_token
.span
];
779 let sugg
: Vec
<_
> = sp
.iter().map(|sp
| (*sp
, String
::new())).collect();
780 self.struct_span_err(sp
, "incorrect braces around trait bounds")
781 .multipart_suggestion(
782 "remove the parentheses",
784 Applicability
::MachineApplicable
,
788 self.expect(&token
::CloseDelim(token
::Paren
))?
;
792 let modifier
= modifiers
.to_trait_bound_modifier();
793 let poly_trait
= PolyTraitRef
::new(lifetime_defs
, path
, lo
.to(self.prev_token
.span
));
794 Ok(GenericBound
::Trait(poly_trait
, modifier
))
797 /// Optionally parses `for<$generic_params>`.
798 pub(super) fn parse_late_bound_lifetime_defs(&mut self) -> PResult
<'a
, Vec
<GenericParam
>> {
799 if self.eat_keyword(kw
::For
) {
801 let params
= self.parse_generic_params()?
;
803 // We rely on AST validation to rule out invalid cases: There must not be type
804 // parameters, and the lifetime parameters must not have bounds.
811 pub(super) fn check_lifetime(&mut self) -> bool
{
812 self.expected_tokens
.push(TokenType
::Lifetime
);
813 self.token
.is_lifetime()
816 /// Parses a single lifetime `'a` or panics.
817 pub(super) fn expect_lifetime(&mut self) -> Lifetime
{
818 if let Some(ident
) = self.token
.lifetime() {
820 Lifetime { ident, id: ast::DUMMY_NODE_ID }
822 self.span_bug(self.token
.span
, "not a lifetime")
826 pub(super) fn mk_ty(&self, span
: Span
, kind
: TyKind
) -> P
<Ty
> {
827 P(Ty { kind, span, id: ast::DUMMY_NODE_ID, tokens: None }
)