rustc_ast/
visit.rs

1//! AST walker. Each overridden visit method has full control over what
2//! happens with its node, it can do its own traversal of the node's children,
3//! call `visit::walk_*` to apply the default traversal algorithm, or prevent
4//! deeper traversal by doing nothing.
5//!
6//! Note: it is an important invariant that the default visitor walks the body
7//! of a function in "execution order" (more concretely, reverse post-order
8//! with respect to the CFG implied by the AST), meaning that if AST node A may
9//! execute before AST node B, then A is visited first. The borrow checker in
10//! particular relies on this property.
11//!
12//! Note: walking an AST before macro expansion is probably a bad idea. For
13//! instance, a walker looking for item names in a module will miss all of
14//! those that are created by the expansion of a macro.
15
16pub use rustc_ast_ir::visit::VisitorResult;
17pub use rustc_ast_ir::{try_visit, visit_opt, walk_list, walk_visitable_list};
18use rustc_span::source_map::Spanned;
19use rustc_span::{Ident, Span};
20use thin_vec::ThinVec;
21
22use crate::ast::*;
23use crate::ptr::P;
24use crate::tokenstream::DelimSpan;
25
26#[derive(Copy, Clone, Debug, PartialEq)]
27pub enum AssocCtxt {
28    Trait,
29    Impl { of_trait: bool },
30}
31
32#[derive(Copy, Clone, Debug, PartialEq)]
33pub enum FnCtxt {
34    Free,
35    Foreign,
36    Assoc(AssocCtxt),
37}
38
39#[derive(Copy, Clone, Debug)]
40pub enum BoundKind {
41    /// Trait bounds in generics bounds and type/trait alias.
42    /// E.g., `<T: Bound>`, `type A: Bound`, or `where T: Bound`.
43    Bound,
44
45    /// Trait bounds in `impl` type.
46    /// E.g., `type Foo = impl Bound1 + Bound2 + Bound3`.
47    Impl,
48
49    /// Trait bounds in trait object type.
50    /// E.g., `dyn Bound1 + Bound2 + Bound3`.
51    TraitObject,
52
53    /// Super traits of a trait.
54    /// E.g., `trait A: B`
55    SuperTraits,
56}
57impl BoundKind {
58    pub fn descr(self) -> &'static str {
59        match self {
60            BoundKind::Bound => "bounds",
61            BoundKind::Impl => "`impl Trait`",
62            BoundKind::TraitObject => "`dyn` trait object bounds",
63            BoundKind::SuperTraits => "supertrait bounds",
64        }
65    }
66}
67
68#[derive(Copy, Clone, Debug)]
69pub enum LifetimeCtxt {
70    /// Appears in a reference type.
71    Ref,
72    /// Appears as a bound on a type or another lifetime.
73    Bound,
74    /// Appears as a generic argument.
75    GenericArg,
76}
77
78#[macro_export]
79macro_rules! common_visitor_and_walkers {
80    ($(($mut: ident))? $Visitor:ident$(<$lt:lifetime>)?) => {
81        $(${ignore($lt)}
82            #[derive(Copy, Clone)]
83        )?
84        #[derive(Debug)]
85        pub enum FnKind<'a> {
86            /// E.g., `fn foo()`, `fn foo(&self)`, or `extern "Abi" fn foo()`.
87            Fn(FnCtxt, &'a $($mut)? Visibility, &'a $($mut)? Fn),
88
89            /// E.g., `|x, y| body`.
90            Closure(&'a $($mut)? ClosureBinder, &'a $($mut)? Option<CoroutineKind>, &'a $($mut)? P<FnDecl>, &'a $($mut)? P<Expr>),
91        }
92
93        impl<'a> FnKind<'a> {
94            pub fn header(&'a $($mut)? self) -> Option<&'a $($mut)? FnHeader> {
95                match *self {
96                    FnKind::Fn(_, _, Fn { sig, .. }) => Some(&$($mut)? sig.header),
97                    FnKind::Closure(..) => None,
98                }
99            }
100
101            pub fn ident(&'a $($mut)? self) -> Option<&'a $($mut)? Ident> {
102                match self {
103                    FnKind::Fn(_, _, Fn { ident, .. }) => Some(ident),
104                    _ => None,
105                }
106            }
107
108            pub fn decl(&'a $($mut)? self) -> &'a $($mut)? FnDecl {
109                match self {
110                    FnKind::Fn(_, _, Fn { sig, .. }) => &$($mut)? sig.decl,
111                    FnKind::Closure(_, _, decl, _) => decl,
112                }
113            }
114
115            pub fn ctxt(&self) -> Option<FnCtxt> {
116                match self {
117                    FnKind::Fn(ctxt, ..) => Some(*ctxt),
118                    FnKind::Closure(..) => None,
119                }
120            }
121        }
122
123        /// Each method of this trait is a hook to be potentially
124        /// overridden. Each method's default implementation recursively visits
125        /// the substructure of the input via the corresponding `walk` method;
126        #[doc = concat!(" e.g., the `visit_item` method by default calls `visit"$(, "_", stringify!($mut))?, "::walk_item`.")]
127        ///
128        /// If you want to ensure that your code handles every variant
129        /// explicitly, you need to override each method. (And you also need
130        /// to monitor future changes to this trait in case a new method with a
131        /// new default implementation gets introduced.)
132        ///
133        /// Every `walk_*` method uses deconstruction to access fields of structs and
134        /// enums. This will result in a compile error if a field is added, which makes
135        /// it more likely the appropriate visit call will be added for it.
136        pub trait $Visitor<$($lt)?> : Sized $(${ignore($mut)} + MutVisitorResult<Result = ()>)? {
137            $(
138                ${ignore($lt)}
139                /// The result type of the `visit_*` methods. Can be either `()`,
140                /// or `ControlFlow<T>`.
141                type Result: VisitorResult = ();
142            )?
143
144            // Methods in this trait have one of three forms, with the last two forms
145            // only occuring on `MutVisitor`:
146            //
147            //   fn visit_t(&mut self, t: &mut T);                      // common
148            //   fn flat_map_t(&mut self, t: T) -> SmallVec<[T; 1]>;    // rare
149            //   fn filter_map_t(&mut self, t: T) -> Option<T>;         // rarest
150            //
151            // When writing these methods, it is better to use destructuring like this:
152            //
153            //   fn visit_abc(&mut self, ABC { a, b, c: _ }: &mut ABC) {
154            //       visit_a(a);
155            //       visit_b(b);
156            //   }
157            //
158            // than to use field access like this:
159            //
160            //   fn visit_abc(&mut self, abc: &mut ABC) {
161            //       visit_a(&mut abc.a);
162            //       visit_b(&mut abc.b);
163            //       // ignore abc.c
164            //   }
165            //
166            // As well as being more concise, the former is explicit about which fields
167            // are skipped. Furthermore, if a new field is added, the destructuring
168            // version will cause a compile error, which is good. In comparison, the
169            // field access version will continue working and it would be easy to
170            // forget to add handling for it.
171            fn visit_ident(&mut self, Ident { name: _, span }: &$($lt)? $($mut)? Ident) -> Self::Result {
172                visit_span(self, span)
173            }
174
175            fn visit_foreign_mod(&mut self, nm: &$($lt)? $($mut)? ForeignMod) -> Self::Result {
176                walk_foreign_mod(self, nm)
177            }
178
179            fn visit_foreign_item(&mut self, i: &$($lt)? $($mut)? ForeignItem) -> Self::Result {
180                walk_item(self, i)
181            }
182
183            fn visit_item(&mut self, i: &$($lt)? $($mut)? Item) -> Self::Result {
184                walk_item(self, i)
185            }
186
187            fn visit_local(&mut self, l: &$($lt)? $($mut)? Local) -> Self::Result {
188                walk_local(self, l)
189            }
190
191            fn visit_block(&mut self, b: &$($lt)? $($mut)? Block) -> Self::Result {
192                walk_block(self, b)
193            }
194
195            fn visit_param(&mut self, param: &$($lt)? $($mut)? Param) -> Self::Result {
196                walk_param(self, param)
197            }
198
199            fn visit_arm(&mut self, a: &$($lt)? $($mut)? Arm) -> Self::Result {
200                walk_arm(self, a)
201            }
202
203            fn visit_pat(&mut self, p: &$($lt)? $($mut)? Pat) -> Self::Result {
204                walk_pat(self, p)
205            }
206
207            fn visit_anon_const(&mut self, c: &$($lt)? $($mut)? AnonConst) -> Self::Result {
208                walk_anon_const(self, c)
209            }
210
211            fn visit_expr(&mut self, ex: &$($lt)? $($mut)? Expr) -> Self::Result {
212                walk_expr(self, ex)
213            }
214
215            /// This method is a hack to workaround unstable of `stmt_expr_attributes`.
216            /// It can be removed once that feature is stabilized.
217            fn visit_method_receiver_expr(&mut self, ex: &$($lt)? $($mut)? Expr) -> Self::Result {
218                self.visit_expr(ex)
219            }
220
221            fn visit_ty(&mut self, t: &$($lt)? $($mut)? Ty) -> Self::Result {
222                walk_ty(self, t)
223            }
224
225            fn visit_ty_pat(&mut self, t: &$($lt)? $($mut)? TyPat) -> Self::Result {
226                walk_ty_pat(self, t)
227            }
228
229            fn visit_generic_param(&mut self, param: &$($lt)? $($mut)? GenericParam) -> Self::Result {
230                walk_generic_param(self, param)
231            }
232
233            fn visit_generics(&mut self, g: &$($lt)? $($mut)? Generics) -> Self::Result {
234                walk_generics(self, g)
235            }
236            fn visit_closure_binder(&mut self, b: &$($lt)? $($mut)? ClosureBinder) -> Self::Result {
237                walk_closure_binder(self, b)
238            }
239            fn visit_contract(&mut self, c: &$($lt)? $($mut)? FnContract) -> Self::Result {
240                walk_contract(self, c)
241            }
242
243            fn visit_where_predicate(&mut self, p: &$($lt)? $($mut)? WherePredicate) -> Self::Result {
244                walk_where_predicate(self, p)
245            }
246
247            fn visit_where_predicate_kind(&mut self, k: &$($lt)? $($mut)? WherePredicateKind) -> Self::Result {
248                walk_where_predicate_kind(self, k)
249            }
250
251            // for `MutVisitor`: `Span` and `NodeId` are mutated at the caller site.
252            fn visit_fn(
253                &mut self,
254                fk: FnKind<$($lt)? $(${ignore($mut)} '_)?>,
255                _: Span,
256                _: NodeId
257            ) -> Self::Result {
258                walk_fn(self, fk)
259            }
260
261            fn visit_assoc_item(&mut self, i: &$($lt)? $($mut)? AssocItem, ctxt: AssocCtxt) -> Self::Result {
262                walk_assoc_item(self, i, ctxt)
263            }
264
265            fn visit_trait_ref(&mut self, t: &$($lt)? $($mut)? TraitRef) -> Self::Result {
266                walk_trait_ref(self, t)
267            }
268
269            fn visit_param_bound(&mut self, bounds: &$($lt)? $($mut)? GenericBound, _ctxt: BoundKind) -> Self::Result {
270                walk_param_bound(self, bounds)
271            }
272
273            fn visit_precise_capturing_arg(&mut self, arg: &$($lt)? $($mut)? PreciseCapturingArg) -> Self::Result {
274                walk_precise_capturing_arg(self, arg)
275            }
276
277            fn visit_poly_trait_ref(&mut self, t: &$($lt)? $($mut)? PolyTraitRef) -> Self::Result {
278                walk_poly_trait_ref(self, t)
279            }
280
281            fn visit_variant_data(&mut self, s: &$($lt)? $($mut)? VariantData) -> Self::Result {
282                walk_variant_data(self, s)
283            }
284
285            fn visit_field_def(&mut self, s: &$($lt)? $($mut)? FieldDef) -> Self::Result {
286                walk_field_def(self, s)
287            }
288
289            fn visit_variant(&mut self, v: &$($lt)? $($mut)? Variant) -> Self::Result {
290                walk_variant(self, v)
291            }
292
293            fn visit_label(&mut self, label: &$($lt)? $($mut)? Label) -> Self::Result {
294                walk_label(self, label)
295            }
296
297            fn visit_lifetime(&mut self, lifetime: &$($lt)? $($mut)? Lifetime, $(${ignore($lt)} _: LifetimeCtxt )?) -> Self::Result {
298                walk_lifetime(self, lifetime)
299            }
300
301            fn visit_mac_call(&mut self, mac: &$($lt)? $($mut)? MacCall) -> Self::Result {
302                walk_mac(self, mac)
303            }
304
305            fn visit_id(&mut self, _id: $(&$mut)? NodeId) -> Self::Result {
306                Self::Result::output()
307            }
308
309            fn visit_macro_def(&mut self, macro_def: &$($lt)? $($mut)? MacroDef) -> Self::Result {
310                walk_macro_def(self, macro_def)
311            }
312
313            fn visit_path(&mut self, path: &$($lt)? $($mut)? Path) -> Self::Result {
314                walk_path(self, path)
315            }
316
317            fn visit_use_tree(&mut self, use_tree: &$($lt)? $($mut)? UseTree) -> Self::Result {
318                walk_use_tree(self, use_tree)
319            }
320
321            fn visit_path_segment(&mut self, path_segment: &$($lt)? $($mut)? PathSegment) -> Self::Result {
322                walk_path_segment(self, path_segment)
323            }
324
325            fn visit_generic_args(&mut self, generic_args: &$($lt)? $($mut)? GenericArgs) -> Self::Result {
326                walk_generic_args(self, generic_args)
327            }
328
329            fn visit_generic_arg(&mut self, generic_arg: &$($lt)? $($mut)? GenericArg) -> Self::Result {
330                walk_generic_arg(self, generic_arg)
331            }
332
333            fn visit_assoc_item_constraint(
334                &mut self,
335                constraint: &$($lt)? $($mut)? AssocItemConstraint,
336            ) -> Self::Result {
337                walk_assoc_item_constraint(self, constraint)
338            }
339
340            fn visit_attribute(&mut self, attr: &$($lt)? $($mut)? Attribute) -> Self::Result {
341                walk_attribute(self, attr)
342            }
343
344            fn visit_vis(&mut self, vis: &$($lt)? $($mut)? Visibility) -> Self::Result {
345                walk_vis(self, vis)
346            }
347
348            fn visit_fn_ret_ty(&mut self, ret_ty: &$($lt)? $($mut)? FnRetTy) -> Self::Result {
349                walk_fn_ret_ty(self, ret_ty)
350            }
351
352            fn visit_fn_header(&mut self, header: &$($lt)? $($mut)? FnHeader) -> Self::Result {
353                walk_fn_header(self, header)
354            }
355
356            fn visit_expr_field(&mut self, f: &$($lt)? $($mut)? ExprField) -> Self::Result {
357                walk_expr_field(self, f)
358            }
359
360            fn visit_pat_field(&mut self, fp: &$($lt)? $($mut)? PatField) -> Self::Result {
361                walk_pat_field(self, fp)
362            }
363
364            fn visit_crate(&mut self, krate: &$($lt)? $($mut)? Crate) -> Self::Result {
365                walk_crate(self, krate)
366            }
367
368            fn visit_inline_asm(&mut self, asm: &$($lt)? $($mut)? InlineAsm) -> Self::Result {
369                walk_inline_asm(self, asm)
370            }
371
372            fn visit_format_args(&mut self, fmt: &$($lt)? $($mut)? FormatArgs) -> Self::Result {
373                walk_format_args(self, fmt)
374            }
375
376            fn visit_inline_asm_sym(&mut self, sym: &$($lt)? $($mut)? InlineAsmSym) -> Self::Result {
377                walk_inline_asm_sym(self, sym)
378            }
379
380            fn visit_capture_by(&mut self, capture_by: &$($lt)? $($mut)? CaptureBy) -> Self::Result {
381                walk_capture_by(self, capture_by)
382            }
383
384            fn visit_coroutine_kind(&mut self, coroutine_kind: &$($lt)? $($mut)? CoroutineKind) -> Self::Result {
385                walk_coroutine_kind(self, coroutine_kind)
386            }
387
388            fn visit_fn_decl(&mut self, fn_decl: &$($lt)? $($mut)? FnDecl) -> Self::Result {
389                walk_fn_decl(self, fn_decl)
390            }
391
392            fn visit_qself(&mut self, qs: &$($lt)? $($mut)? Option<P<QSelf>>) -> Self::Result {
393                walk_qself(self, qs)
394            }
395
396            // (non-mut) `Visitor`-only methods
397            $(
398                fn visit_stmt(&mut self, s: &$lt Stmt) -> Self::Result {
399                    walk_stmt(self, s)
400                }
401
402                fn visit_nested_use_tree(&mut self, use_tree: &$lt UseTree, id: NodeId) -> Self::Result {
403                    try_visit!(self.visit_id(id));
404                    self.visit_use_tree(use_tree)
405                }
406            )?
407
408            // `MutVisitor`-only methods
409            $(
410                fn flat_map_foreign_item(&mut self, ni: P<ForeignItem>) -> SmallVec<[P<ForeignItem>; 1]> {
411                    walk_flat_map_foreign_item(self, ni)
412                }
413
414                fn flat_map_item(&mut self, i: P<Item>) -> SmallVec<[P<Item>; 1]> {
415                    walk_flat_map_item(self, i)
416                }
417
418                fn flat_map_field_def(&mut self, fd: FieldDef) -> SmallVec<[FieldDef; 1]> {
419                    walk_flat_map_field_def(self, fd)
420                }
421
422                fn flat_map_assoc_item(
423                    &mut self,
424                    i: P<AssocItem>,
425                    ctxt: AssocCtxt,
426                ) -> SmallVec<[P<AssocItem>; 1]> {
427                    walk_flat_map_assoc_item(self, i, ctxt)
428                }
429
430                fn flat_map_stmt(&mut self, s: Stmt) -> SmallVec<[Stmt; 1]> {
431                    walk_flat_map_stmt(self, s)
432                }
433
434                fn flat_map_arm(&mut self, arm: Arm) -> SmallVec<[Arm; 1]> {
435                    walk_flat_map_arm(self, arm)
436                }
437
438                fn filter_map_expr(&mut self, e: P<Expr>) -> Option<P<Expr>> {
439                    walk_filter_map_expr(self, e)
440                }
441
442                fn flat_map_variant(&mut self, v: Variant) -> SmallVec<[Variant; 1]> {
443                    walk_flat_map_variant(self, v)
444                }
445
446                fn flat_map_param(&mut self, param: Param) -> SmallVec<[Param; 1]> {
447                    walk_flat_map_param(self, param)
448                }
449
450                fn flat_map_generic_param(&mut self, param: GenericParam) -> SmallVec<[GenericParam; 1]> {
451                    walk_flat_map_generic_param(self, param)
452                }
453
454                fn flat_map_expr_field(&mut self, f: ExprField) -> SmallVec<[ExprField; 1]> {
455                    walk_flat_map_expr_field(self, f)
456                }
457
458                fn flat_map_where_predicate(
459                    &mut self,
460                    where_predicate: WherePredicate,
461                ) -> SmallVec<[WherePredicate; 1]> {
462                    walk_flat_map_where_predicate(self, where_predicate)
463                }
464
465                // Span visiting is no longer used, but we keep it for now,
466                // in case it's needed for something like #127241.
467                fn visit_span(&mut self, _sp: &$mut Span) {
468                    // Do nothing.
469                }
470
471                fn flat_map_pat_field(&mut self, fp: PatField) -> SmallVec<[PatField; 1]> {
472                    walk_flat_map_pat_field(self, fp)
473                }
474            )?
475        }
476
477        pub trait WalkItemKind {
478            type Ctxt;
479            fn walk<$($lt,)? V: $Visitor$(<$lt>)?>(
480                &$($lt)? $($mut)? self,
481                span: Span,
482                id: NodeId,
483                visibility: &$($lt)? $($mut)? Visibility,
484                ctxt: Self::Ctxt,
485                vis: &mut V,
486            ) -> V::Result;
487        }
488
489        // this is only used by the MutVisitor. We include this symmetry here to make writing other functions easier
490        $(${ignore($lt)}
491            #[expect(unused, rustc::pass_by_value)]
492            #[inline]
493        )?
494        fn visit_span<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, span: &$($lt)? $($mut)? Span) -> V::Result {
495            $(
496                ${ignore($mut)}
497                vis.visit_span(span);
498            )?
499            V::Result::output()
500        }
501
502        /// helper since `Visitor` wants `NodeId` but `MutVisitor` wants `&mut NodeId`
503        $(${ignore($lt)}
504            #[expect(rustc::pass_by_value)]
505        )?
506        #[inline]
507        fn visit_id<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, id: &$($lt)? $($mut)? NodeId) -> V::Result {
508            // deref `&NodeId` into `NodeId` only for `Visitor`
509            vis.visit_id( $(${ignore($lt)} * )? id)
510        }
511
512        // this is only used by the MutVisitor. We include this symmetry here to make writing other functions easier
513        fn visit_safety<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, safety: &$($lt)? $($mut)? Safety) -> V::Result {
514            match safety {
515                Safety::Unsafe(span) => visit_span(vis, span),
516                Safety::Safe(span) => visit_span(vis, span),
517                Safety::Default => { V::Result::output() }
518            }
519        }
520
521        fn visit_constness<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, constness: &$($lt)? $($mut)? Const) -> V::Result {
522            match constness {
523                Const::Yes(span) => visit_span(vis, span),
524                Const::No => {
525                    V::Result::output()
526                }
527            }
528        }
529
530        fn visit_defaultness<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, defaultness: &$($lt)? $($mut)? Defaultness) -> V::Result {
531            match defaultness {
532                Defaultness::Default(span) => visit_span(vis, span),
533                Defaultness::Final => {
534                    V::Result::output()
535                }
536            }
537        }
538
539        fn visit_polarity<$($lt,)? V: $Visitor$(<$lt>)?>(
540            vis: &mut V,
541            polarity: &$($lt)? $($mut)? ImplPolarity,
542        ) -> V::Result {
543            match polarity {
544                ImplPolarity::Positive => { V::Result::output() }
545                ImplPolarity::Negative(span) => visit_span(vis, span),
546            }
547        }
548
549        $(${ignore($lt)}
550            #[inline]
551        )?
552        fn visit_modifiers<$($lt,)? V: $Visitor$(<$lt>)?>(
553            vis: &mut V,
554            m: &$($lt)? $($mut)? TraitBoundModifiers
555        ) -> V::Result {
556            let TraitBoundModifiers { constness, asyncness, polarity } = m;
557            match constness {
558                BoundConstness::Never => {}
559                BoundConstness::Always(span) | BoundConstness::Maybe(span) => try_visit!(visit_span(vis, span)),
560            }
561            match asyncness {
562                BoundAsyncness::Normal => {}
563                BoundAsyncness::Async(span) => try_visit!(visit_span(vis, span)),
564            }
565            match polarity {
566                BoundPolarity::Positive => {}
567                BoundPolarity::Negative(span) | BoundPolarity::Maybe(span) => try_visit!(visit_span(vis, span)),
568            }
569            V::Result::output()
570        }
571
572        $(${ignore($lt)}
573            #[inline]
574        )?
575        fn walk_capture_by<$($lt,)? V: $Visitor$(<$lt>)?>(
576            vis: &mut V,
577            capture_by: &$($lt)? $($mut)? CaptureBy
578        ) -> V::Result {
579            match capture_by {
580                CaptureBy::Ref => { V::Result::output() }
581                CaptureBy::Value { move_kw } => {
582                    visit_span(vis, move_kw)
583                }
584                CaptureBy::Use { use_kw } => {
585                    visit_span(vis, use_kw)
586                }
587            }
588        }
589
590        fn visit_bounds<$($lt,)? V: $Visitor$(<$lt>)?>(visitor: &mut V, bounds: &$($lt)? $($mut)? GenericBounds, ctxt: BoundKind) -> V::Result {
591            walk_list!(visitor, visit_param_bound, bounds, ctxt);
592            V::Result::output()
593        }
594
595        pub fn walk_label<$($lt,)? V: $Visitor$(<$lt>)?>(visitor: &mut V, Label { ident }: &$($lt)? $($mut)? Label) -> V::Result {
596            visitor.visit_ident(ident)
597        }
598
599        pub fn walk_fn_header<$($lt,)? V: $Visitor$(<$lt>)?>(visitor: &mut V, header: &$($lt)? $($mut)? FnHeader) -> V::Result {
600            let FnHeader { safety, coroutine_kind, constness, ext: _ } = header;
601            try_visit!(visit_constness(visitor, constness));
602            visit_opt!(visitor, visit_coroutine_kind, coroutine_kind);
603            visit_safety(visitor, safety)
604        }
605
606        pub fn walk_lifetime<$($lt,)? V: $Visitor$(<$lt>)?>(visitor: &mut V, Lifetime { id, ident }: &$($lt)? $($mut)? Lifetime) -> V::Result {
607            try_visit!(visit_id(visitor, id));
608            visitor.visit_ident(ident)
609        }
610
611        fn walk_item_ctxt<$($lt,)? V: $Visitor$(<$lt>)?, K: WalkItemKind>(
612            visitor: &mut V,
613            item: &$($mut)? $($lt)? Item<K>,
614            ctxt: K::Ctxt,
615        ) -> V::Result {
616            let Item { attrs, id, kind, vis, span, tokens: _ } = item;
617            try_visit!(visit_id(visitor, id));
618            walk_list!(visitor, visit_attribute, attrs);
619            try_visit!(visitor.visit_vis(vis));
620            try_visit!(kind.walk(*span, *id, vis, ctxt, visitor));
621            visit_span(visitor, span)
622        }
623
624        pub fn walk_item<$($lt,)? V: $Visitor$(<$lt>)?, K: WalkItemKind<Ctxt = ()>>(
625            visitor: &mut V,
626            item: &$($mut)? $($lt)? Item<K>,
627        ) -> V::Result {
628            walk_item_ctxt(visitor, item, ())
629        }
630
631        pub fn walk_assoc_item<$($lt,)? V: $Visitor$(<$lt>)?>(
632            visitor: &mut V,
633            item: &$($mut)? $($lt)? AssocItem,
634            ctxt: AssocCtxt,
635        ) -> V::Result {
636            walk_item_ctxt(visitor, item, ctxt)
637        }
638
639        impl WalkItemKind for ItemKind {
640            type Ctxt = ();
641            fn walk<$($lt,)? V: $Visitor$(<$lt>)?>(
642                &$($lt)? $($mut)? self,
643                span: Span,
644                id: NodeId,
645                visibility: &$($lt)? $($mut)? Visibility,
646                _ctxt: Self::Ctxt,
647                vis: &mut V,
648            ) -> V::Result {
649                match self {
650                    ItemKind::ExternCrate(_orig_name, ident) => vis.visit_ident(ident),
651                    ItemKind::Use(use_tree) => vis.visit_use_tree(use_tree),
652                    ItemKind::Static(box StaticItem {
653                        ident,
654                        ty,
655                        safety: _,
656                        mutability: _,
657                        expr,
658                        define_opaque,
659                    }) => {
660                        try_visit!(vis.visit_ident(ident));
661                        try_visit!(vis.visit_ty(ty));
662                        visit_opt!(vis, visit_expr, expr);
663                        walk_define_opaques(vis, define_opaque)
664                    }
665                    ItemKind::Const(item) => {
666                        walk_const_item(vis, item)
667                    }
668                    ItemKind::Fn(func) => {
669                        let kind = FnKind::Fn(FnCtxt::Free, visibility, &$($mut)? *func);
670                        vis.visit_fn(kind, span, id)
671                    }
672                    ItemKind::Mod(safety, ident, mod_kind) => {
673                        try_visit!(visit_safety(vis, safety));
674                        try_visit!(vis.visit_ident(ident));
675                        match mod_kind {
676                            ModKind::Loaded(
677                                items,
678                                _inline,
679                                ModSpans { inner_span, inject_use_span },
680                                _,
681                            ) => {
682                                try_visit!(visit_items(vis, items));
683                                try_visit!(visit_span(vis, inner_span));
684                                try_visit!(visit_span(vis, inject_use_span));
685                            }
686                            ModKind::Unloaded => {}
687                        }
688                        V::Result::output()
689                    }
690                    ItemKind::ForeignMod(nm) => vis.visit_foreign_mod(nm),
691                    ItemKind::GlobalAsm(asm) => vis.visit_inline_asm(asm),
692                    ItemKind::TyAlias(box TyAlias {
693                        defaultness,
694                        ident,
695                        generics,
696                        $(${ignore($lt)} #[expect(unused)])?
697                        where_clauses,
698                        bounds,
699                        ty,
700                    }) => {
701                        try_visit!(visit_defaultness(vis, defaultness));
702                        try_visit!(vis.visit_ident(ident));
703                        try_visit!(vis.visit_generics(generics));
704                        try_visit!(visit_bounds(vis, bounds, BoundKind::Bound));
705                        visit_opt!(vis, visit_ty, ty);
706                        $(${ignore($mut)}
707                            walk_ty_alias_where_clauses(vis, where_clauses);
708                        )?
709                        V::Result::output()
710                    }
711                    ItemKind::Enum(ident, generics, enum_definition) => {
712                        try_visit!(vis.visit_ident(ident));
713                        try_visit!(vis.visit_generics(generics));
714                        visit_variants(vis, &$($mut)? enum_definition.variants)
715                    }
716                    ItemKind::Struct(ident, generics, variant_data)
717                    | ItemKind::Union(ident, generics, variant_data) => {
718                        try_visit!(vis.visit_ident(ident));
719                        try_visit!(vis.visit_generics(generics));
720                        vis.visit_variant_data(variant_data)
721                    }
722                    ItemKind::Impl(box Impl {
723                        defaultness,
724                        safety,
725                        generics,
726                        constness,
727                        polarity,
728                        of_trait,
729                        self_ty,
730                        items,
731                    }) => {
732                        try_visit!(visit_defaultness(vis, defaultness));
733                        try_visit!(visit_safety(vis, safety));
734                        try_visit!(vis.visit_generics(generics));
735                        try_visit!(visit_constness(vis, constness));
736                        try_visit!(visit_polarity(vis, polarity));
737                        visit_opt!(vis, visit_trait_ref, of_trait);
738                        try_visit!(vis.visit_ty(self_ty));
739                        visit_assoc_items(vis, items, AssocCtxt::Impl { of_trait: of_trait.is_some() })
740                    }
741                    ItemKind::Trait(box Trait { safety, is_auto: _, ident, generics, bounds, items }) => {
742                        try_visit!(visit_safety(vis, safety));
743                        try_visit!(vis.visit_ident(ident));
744                        try_visit!(vis.visit_generics(generics));
745                        try_visit!(visit_bounds(vis, bounds, BoundKind::Bound));
746                        visit_assoc_items(vis, items, AssocCtxt::Trait)
747                    }
748                    ItemKind::TraitAlias(ident, generics, bounds) => {
749                        try_visit!(vis.visit_ident(ident));
750                        try_visit!(vis.visit_generics(generics));
751                        visit_bounds(vis, bounds, BoundKind::Bound)
752                    }
753                    ItemKind::MacCall(m) => vis.visit_mac_call(m),
754                    ItemKind::MacroDef(ident, def) => {
755                        try_visit!(vis.visit_ident(ident));
756                        vis.visit_macro_def(def)
757                    }
758                    ItemKind::Delegation(box Delegation {
759                        id,
760                        qself,
761                        path,
762                        ident,
763                        rename,
764                        body,
765                        from_glob: _,
766                    }) => {
767                        try_visit!(visit_id(vis, id));
768                        try_visit!(vis.visit_qself(qself));
769                        try_visit!(vis.visit_path(path));
770                        try_visit!(vis.visit_ident(ident));
771                        visit_opt!(vis, visit_ident, rename);
772                        visit_opt!(vis, visit_block, body);
773                        V::Result::output()
774                    }
775                    ItemKind::DelegationMac(box DelegationMac { qself, prefix, suffixes, body }) => {
776                        try_visit!(vis.visit_qself(qself));
777                        try_visit!(vis.visit_path(prefix));
778                        if let Some(suffixes) = suffixes {
779                            for (ident, rename) in suffixes {
780                                try_visit!(vis.visit_ident(ident));
781                                visit_opt!(vis, visit_ident, rename);
782                            }
783                        }
784                        visit_opt!(vis, visit_block, body);
785                        V::Result::output()
786                    }
787                }
788            }
789        }
790
791        fn walk_const_item<$($lt,)? V: $Visitor$(<$lt>)?>(
792            vis: &mut V,
793            item: &$($lt)? $($mut)? ConstItem,
794        ) -> V::Result {
795            let ConstItem { defaultness, ident, generics, ty, expr, define_opaque } = item;
796            try_visit!(visit_defaultness(vis, defaultness));
797            try_visit!(vis.visit_ident(ident));
798            try_visit!(vis.visit_generics(generics));
799            try_visit!(vis.visit_ty(ty));
800            visit_opt!(vis, visit_expr, expr);
801            walk_define_opaques(vis, define_opaque)
802        }
803
804        fn walk_foreign_mod<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, foreign_mod: &$($lt)? $($mut)? ForeignMod) -> V::Result {
805            let ForeignMod { extern_span: _, safety, abi: _, items } = foreign_mod;
806            try_visit!(visit_safety(vis, safety));
807            visit_foreign_items(vis, items)
808        }
809
810        fn walk_define_opaques<$($lt,)? V: $Visitor$(<$lt>)?>(
811            visitor: &mut V,
812            define_opaque: &$($lt)? $($mut)? Option<ThinVec<(NodeId, Path)>>,
813        ) -> V::Result {
814            if let Some(define_opaque) = define_opaque {
815                for (id, path) in define_opaque {
816                    try_visit!(visit_id(visitor, id));
817                    try_visit!(visitor.visit_path(path));
818                }
819            }
820            V::Result::output()
821        }
822
823        impl WalkItemKind for AssocItemKind {
824            type Ctxt = AssocCtxt;
825            fn walk<$($lt,)? V: $Visitor$(<$lt>)?>(
826                &$($lt)? $($mut)? self,
827                span: Span,
828                id: NodeId,
829                visibility: &$($lt)? $($mut)? Visibility,
830                ctxt: Self::Ctxt,
831                vis: &mut V,
832            ) -> V::Result {
833                match self {
834                    AssocItemKind::Const(item) => {
835                        walk_const_item(vis, item)
836                    }
837                    AssocItemKind::Fn(func) => {
838                        vis.visit_fn(FnKind::Fn(FnCtxt::Assoc(ctxt), visibility, &$($mut)? *func), span, id)
839                    }
840                    AssocItemKind::Type(box TyAlias {
841                        generics,
842                        ident,
843                        bounds,
844                        ty,
845                        defaultness,
846                        $(${ignore($lt)} #[expect(unused)])?
847                        where_clauses,
848                    }) => {
849                        try_visit!(visit_defaultness(vis, defaultness));
850                        try_visit!(vis.visit_ident(ident));
851                        try_visit!(vis.visit_generics(generics));
852                        try_visit!(visit_bounds(vis, bounds, BoundKind::Bound));
853                        visit_opt!(vis, visit_ty, ty);
854                        $(${ignore($mut)}
855                            walk_ty_alias_where_clauses(vis, where_clauses);
856                        )?
857                        V::Result::output()
858                    }
859                    AssocItemKind::MacCall(mac) => {
860                        vis.visit_mac_call(mac)
861                    }
862                    AssocItemKind::Delegation(box Delegation {
863                        id,
864                        qself,
865                        path,
866                        ident,
867                        rename,
868                        body,
869                        from_glob: _,
870                    }) => {
871                        try_visit!(visit_id(vis, id));
872                        try_visit!(vis.visit_qself(qself));
873                        try_visit!(vis.visit_path(path));
874                        try_visit!(vis.visit_ident(ident));
875                        visit_opt!(vis, visit_ident, rename);
876                        visit_opt!(vis, visit_block, body);
877                        V::Result::output()
878                    }
879                    AssocItemKind::DelegationMac(box DelegationMac { qself, prefix, suffixes, body }) => {
880                        try_visit!(vis.visit_qself(qself));
881                        try_visit!(vis.visit_path(prefix));
882                        if let Some(suffixes) = suffixes {
883                            for (ident, rename) in suffixes {
884                                try_visit!(vis.visit_ident(ident));
885                                visit_opt!(vis, visit_ident, rename);
886                            }
887                        }
888                        visit_opt!(vis, visit_block, body);
889                        V::Result::output()
890                    }
891                }
892            }
893        }
894
895        impl WalkItemKind for ForeignItemKind {
896            type Ctxt = ();
897            fn walk<$($lt,)? V: $Visitor$(<$lt>)?>(
898                &$($lt)? $($mut)? self,
899                span: Span,
900                id: NodeId,
901                visibility: &$($lt)? $($mut)? Visibility,
902                _ctxt: Self::Ctxt,
903                vis: &mut V,
904            ) -> V::Result {
905                match self {
906                    ForeignItemKind::Static(box StaticItem {
907                        ident,
908                        ty,
909                        mutability: _,
910                        expr,
911                        safety: _,
912                        define_opaque,
913                    }) => {
914                        try_visit!(vis.visit_ident(ident));
915                        try_visit!(vis.visit_ty(ty));
916                        visit_opt!(vis, visit_expr, expr);
917                        walk_define_opaques(vis, define_opaque)
918                    }
919                    ForeignItemKind::Fn(func) => {
920                        vis.visit_fn(FnKind::Fn(FnCtxt::Foreign, visibility, &$($mut)?*func), span, id)
921                    }
922                    ForeignItemKind::TyAlias(box TyAlias {
923                        defaultness,
924                        ident,
925                        generics,
926                        bounds,
927                        ty,
928                        $(${ignore($lt)} #[expect(unused)])?
929                        where_clauses,
930                    }) => {
931                        try_visit!(visit_defaultness(vis, defaultness));
932                        try_visit!(vis.visit_ident(ident));
933                        try_visit!(vis.visit_generics(generics));
934                        try_visit!(visit_bounds(vis, bounds, BoundKind::Bound));
935                        visit_opt!(vis, visit_ty, ty);
936                        $(${ignore($mut)}
937                            walk_ty_alias_where_clauses(vis, where_clauses);
938                        )?
939                        V::Result::output()
940                    }
941                    ForeignItemKind::MacCall(mac) => {
942                        vis.visit_mac_call(mac)
943                    }
944                }
945            }
946        }
947
948        fn walk_coroutine_kind<$($lt,)? V: $Visitor$(<$lt>)?>(
949            vis: &mut V,
950            coroutine_kind: &$($lt)? $($mut)? CoroutineKind,
951        ) -> V::Result {
952            let (CoroutineKind::Async { span, closure_id, return_impl_trait_id }
953                | CoroutineKind::Gen { span, closure_id, return_impl_trait_id }
954                | CoroutineKind::AsyncGen { span, closure_id, return_impl_trait_id })
955                = coroutine_kind;
956            try_visit!(visit_id(vis, closure_id));
957            try_visit!(visit_id(vis, return_impl_trait_id));
958            visit_span(vis, span)
959        }
960
961        pub fn walk_pat<$($lt,)? V: $Visitor$(<$lt>)?>(
962            vis: &mut V,
963            pattern: &$($lt)? $($mut)? Pat
964        ) -> V::Result {
965            let Pat { id, kind, span, tokens: _ } = pattern;
966            try_visit!(visit_id(vis, id));
967            match kind {
968                PatKind::Err(_guar) => {}
969                PatKind::Missing | PatKind::Wild | PatKind::Rest | PatKind::Never => {}
970                PatKind::Ident(_bmode, ident, optional_subpattern) => {
971                    try_visit!(vis.visit_ident(ident));
972                    visit_opt!(vis, visit_pat, optional_subpattern);
973                }
974                PatKind::Expr(expression) => try_visit!(vis.visit_expr(expression)),
975                PatKind::TupleStruct(opt_qself, path, elems) => {
976                    try_visit!(vis.visit_qself(opt_qself));
977                    try_visit!(vis.visit_path(path));
978                    walk_list!(vis, visit_pat, elems);
979                }
980                PatKind::Path(opt_qself, path) => {
981                    try_visit!(vis.visit_qself(opt_qself));
982                    try_visit!(vis.visit_path(path))
983                }
984                PatKind::Struct(opt_qself, path, fields, _rest) => {
985                    try_visit!(vis.visit_qself(opt_qself));
986                    try_visit!(vis.visit_path(path));
987                    try_visit!(visit_pat_fields(vis, fields));
988                }
989                PatKind::Box(subpattern) | PatKind::Deref(subpattern) | PatKind::Paren(subpattern) => {
990                    try_visit!(vis.visit_pat(subpattern));
991                }
992                PatKind::Ref(subpattern, _ /*mutbl*/) => {
993                    try_visit!(vis.visit_pat(subpattern));
994                }
995                PatKind::Range(lower_bound, upper_bound, _end) => {
996                    visit_opt!(vis, visit_expr, lower_bound);
997                    visit_opt!(vis, visit_expr, upper_bound);
998                    try_visit!(visit_span(vis, span));
999                }
1000                PatKind::Guard(subpattern, guard_condition) => {
1001                    try_visit!(vis.visit_pat(subpattern));
1002                    try_visit!(vis.visit_expr(guard_condition));
1003                }
1004                PatKind::Tuple(elems) | PatKind::Slice(elems) | PatKind::Or(elems) => {
1005                    walk_list!(vis, visit_pat, elems);
1006                }
1007                PatKind::MacCall(mac) => try_visit!(vis.visit_mac_call(mac)),
1008            }
1009            visit_span(vis, span)
1010        }
1011
1012        pub fn walk_anon_const<$($lt,)? V: $Visitor$(<$lt>)?>(
1013            vis: &mut V,
1014            constant: &$($lt)? $($mut)? AnonConst,
1015        ) -> V::Result {
1016            let AnonConst { id, value } = constant;
1017            try_visit!(visit_id(vis, id));
1018            vis.visit_expr(value)
1019        }
1020
1021        pub fn walk_path_segment<$($lt,)? V: $Visitor$(<$lt>)?>(
1022            vis: &mut V,
1023            segment: &$($lt)? $($mut)? PathSegment,
1024        ) -> V::Result {
1025            let PathSegment { ident, id, args } = segment;
1026            try_visit!(visit_id(vis, id));
1027            try_visit!(vis.visit_ident(ident));
1028            visit_opt!(vis, visit_generic_args, args);
1029            V::Result::output()
1030        }
1031
1032        pub fn walk_block<$($lt,)? V: $Visitor$(<$lt>)?>(
1033            vis: &mut V,
1034            block: &$($lt)? $($mut)? Block
1035        ) -> V::Result {
1036            let Block { stmts, id, rules: _, span, tokens: _ } = block;
1037            try_visit!(visit_id(vis, id));
1038            try_visit!(visit_stmts(vis, stmts));
1039            visit_span(vis, span)
1040        }
1041
1042
1043        pub fn walk_ty<$($lt,)? V: $Visitor$(<$lt>)?>(
1044            vis: &mut V, ty: &$($lt)? $($mut)? Ty
1045        ) -> V::Result {
1046            let Ty { id, kind, span, tokens: _ } = ty;
1047            try_visit!(visit_id(vis, id));
1048            match kind {
1049                TyKind::Err(_guar) => {}
1050                TyKind::Infer | TyKind::ImplicitSelf | TyKind::Dummy | TyKind::Never | TyKind::CVarArgs => {}
1051                TyKind::Slice(ty) | TyKind::Paren(ty) => try_visit!(vis.visit_ty(ty)),
1052                TyKind::Ptr(MutTy { ty, mutbl: _ }) => try_visit!(vis.visit_ty(ty)),
1053                TyKind::Ref(opt_lifetime, MutTy { ty, mutbl: _ })
1054                | TyKind::PinnedRef(opt_lifetime, MutTy { ty, mutbl: _ }) => {
1055                    // FIXME(fee1-dead) asymmetry
1056                    visit_opt!(vis, visit_lifetime, opt_lifetime$(${ignore($lt)}, LifetimeCtxt::Ref)?);
1057                    try_visit!(vis.visit_ty(ty));
1058                }
1059                TyKind::Tup(tuple_element_types) => {
1060                    walk_list!(vis, visit_ty, tuple_element_types);
1061                }
1062                TyKind::BareFn(function_declaration) => {
1063                    let BareFnTy { safety, ext: _, generic_params, decl, decl_span } =
1064                        &$($mut)? **function_declaration;
1065                    try_visit!(visit_safety(vis, safety));
1066                    try_visit!(visit_generic_params(vis, generic_params));
1067                    try_visit!(vis.visit_fn_decl(decl));
1068                    try_visit!(visit_span(vis, decl_span));
1069                }
1070                TyKind::UnsafeBinder(binder) => {
1071                    try_visit!(visit_generic_params(vis, &$($mut)? binder.generic_params));
1072                    try_visit!(vis.visit_ty(&$($mut)? binder.inner_ty));
1073                }
1074                TyKind::Path(maybe_qself, path) => {
1075                    try_visit!(vis.visit_qself(maybe_qself));
1076                    try_visit!(vis.visit_path(path));
1077                }
1078                TyKind::Pat(ty, pat) => {
1079                    try_visit!(vis.visit_ty(ty));
1080                    try_visit!(vis.visit_ty_pat(pat));
1081                }
1082                TyKind::Array(ty, length) => {
1083                    try_visit!(vis.visit_ty(ty));
1084                    try_visit!(vis.visit_anon_const(length));
1085                }
1086                TyKind::TraitObject(bounds, _syntax) => {
1087                    walk_list!(vis, visit_param_bound, bounds, BoundKind::TraitObject);
1088                }
1089                TyKind::ImplTrait(id, bounds) => {
1090                    try_visit!(visit_id(vis, id));
1091                    walk_list!(vis, visit_param_bound, bounds, BoundKind::Impl);
1092                }
1093                TyKind::Typeof(expression) => try_visit!(vis.visit_anon_const(expression)),
1094
1095                TyKind::MacCall(mac) => try_visit!(vis.visit_mac_call(mac)),
1096            }
1097            visit_span(vis, span)
1098        }
1099
1100        pub fn walk_crate<$($lt,)? V: $Visitor$(<$lt>)?>(
1101            vis: &mut V,
1102            krate: &$($lt)? $($mut)? Crate,
1103        ) -> V::Result {
1104            let Crate { attrs, items, spans, id, is_placeholder: _ } = krate;
1105            try_visit!(visit_id(vis, id));
1106            walk_list!(vis, visit_attribute, attrs);
1107            try_visit!(visit_items(vis, items));
1108            let ModSpans { inner_span, inject_use_span } = spans;
1109            try_visit!(visit_span(vis, inner_span));
1110            visit_span(vis, inject_use_span)
1111        }
1112
1113        pub fn walk_local<$($lt,)? V: $Visitor$(<$lt>)?>(
1114            vis: &mut V,
1115            local: &$($lt)? $($mut)? Local,
1116        ) -> V::Result {
1117            let Local { id, super_, pat, ty, kind, span, colon_sp, attrs, tokens: _ } = local;
1118            if let Some(sp) = super_ {
1119                try_visit!(visit_span(vis, sp));
1120            }
1121            try_visit!(visit_id(vis, id));
1122            walk_list!(vis, visit_attribute, attrs);
1123            try_visit!(vis.visit_pat(pat));
1124            visit_opt!(vis, visit_ty, ty);
1125            match kind {
1126                LocalKind::Decl => {}
1127                LocalKind::Init(init) => {
1128                    try_visit!(vis.visit_expr(init))
1129                }
1130                LocalKind::InitElse(init, els) => {
1131                    try_visit!(vis.visit_expr(init));
1132                    try_visit!(vis.visit_block(els));
1133                }
1134            }
1135            if let Some(sp) = colon_sp {
1136                try_visit!(visit_span(vis, sp));
1137            }
1138            visit_span(vis, span)
1139        }
1140
1141        pub fn walk_poly_trait_ref<$($lt,)? V: $Visitor$(<$lt>)?>(
1142            vis: &mut V,
1143            p: &$($lt)? $($mut)? PolyTraitRef,
1144        ) -> V::Result {
1145            let PolyTraitRef { bound_generic_params, modifiers, trait_ref, span } = p;
1146            try_visit!(visit_modifiers(vis, modifiers));
1147            try_visit!(visit_generic_params(vis, bound_generic_params));
1148            try_visit!(vis.visit_trait_ref(trait_ref));
1149            visit_span(vis, span)
1150        }
1151
1152        pub fn walk_trait_ref<$($lt,)? V: $Visitor$(<$lt>)?>(
1153            vis: &mut V,
1154            TraitRef { path, ref_id }: &$($lt)? $($mut)? TraitRef,
1155        ) -> V::Result {
1156            try_visit!(vis.visit_path(path));
1157            visit_id(vis, ref_id)
1158        }
1159
1160        pub fn walk_variant<$($lt,)? V: $Visitor$(<$lt>)?>(
1161            vis: &mut V,
1162            variant: &$($lt)? $($mut)? Variant,
1163        ) -> V::Result {
1164            let Variant { attrs, id, span, vis: visibility, ident, data, disr_expr, is_placeholder: _ } = variant;
1165            try_visit!(visit_id(vis, id));
1166            walk_list!(vis, visit_attribute, attrs);
1167            try_visit!(vis.visit_vis(visibility));
1168            try_visit!(vis.visit_ident(ident));
1169            try_visit!(vis.visit_variant_data(data));
1170            visit_opt!(vis, visit_anon_const, disr_expr);
1171            visit_span(vis, span)
1172        }
1173
1174        pub fn walk_expr_field<$($lt,)? V: $Visitor$(<$lt>)?>(
1175            vis: &mut V,
1176            f: &$($lt)? $($mut)? ExprField,
1177        ) -> V::Result {
1178            let ExprField { attrs, id, span, ident, expr, is_shorthand: _, is_placeholder: _ } = f;
1179            try_visit!(visit_id(vis, id));
1180            walk_list!(vis, visit_attribute, attrs);
1181            try_visit!(vis.visit_ident(ident));
1182            try_visit!(vis.visit_expr(expr));
1183            visit_span(vis, span)
1184        }
1185
1186        pub fn walk_pat_field<$($lt,)? V: $Visitor$(<$lt>)?>(
1187            vis: &mut V,
1188            fp: &$($lt)? $($mut)? PatField,
1189        ) -> V::Result {
1190            let PatField { ident, pat, is_shorthand: _, attrs, id, span, is_placeholder: _ } = fp;
1191            try_visit!(visit_id(vis, id));
1192            walk_list!(vis, visit_attribute, attrs);
1193            try_visit!(vis.visit_ident(ident));
1194            try_visit!(vis.visit_pat(pat));
1195            visit_span(vis, span)
1196        }
1197
1198        pub fn walk_ty_pat<$($lt,)? V: $Visitor$(<$lt>)?>(
1199            vis: &mut V,
1200            tp: &$($lt)? $($mut)? TyPat,
1201        ) -> V::Result {
1202            let TyPat { id, kind, span, tokens: _ } = tp;
1203            try_visit!(visit_id(vis, id));
1204            match kind {
1205                TyPatKind::Range(start, end, _include_end) => {
1206                    visit_opt!(vis, visit_anon_const, start);
1207                    visit_opt!(vis, visit_anon_const, end);
1208                }
1209                TyPatKind::Or(variants) => walk_list!(vis, visit_ty_pat, variants),
1210                TyPatKind::Err(_) => {}
1211            }
1212            visit_span(vis, span)
1213        }
1214
1215        fn walk_qself<$($lt,)? V: $Visitor$(<$lt>)?>(
1216            vis: &mut V,
1217            qself: &$($lt)? $($mut)? Option<P<QSelf>>,
1218        ) -> V::Result {
1219            if let Some(qself) = qself {
1220                let QSelf { ty, path_span, position: _ } = &$($mut)? **qself;
1221                try_visit!(vis.visit_ty(ty));
1222                try_visit!(visit_span(vis, path_span));
1223            }
1224            V::Result::output()
1225        }
1226
1227        pub fn walk_path<$($lt,)? V: $Visitor$(<$lt>)?>(
1228            vis: &mut V,
1229            path: &$($lt)? $($mut)? Path,
1230        ) -> V::Result {
1231            let Path { span, segments, tokens: _ } = path;
1232            walk_list!(vis, visit_path_segment, segments);
1233            visit_span(vis, span)
1234        }
1235
1236        pub fn walk_use_tree<$($lt,)? V: $Visitor$(<$lt>)?>(
1237            vis: &mut V,
1238            use_tree: &$($lt)? $($mut)? UseTree,
1239        ) -> V::Result {
1240            let UseTree { prefix, kind, span } = use_tree;
1241            try_visit!(vis.visit_path(prefix));
1242            match kind {
1243                UseTreeKind::Simple(rename) => {
1244                    // The extra IDs are handled during AST lowering.
1245                    visit_opt!(vis, visit_ident, rename);
1246                }
1247                UseTreeKind::Glob => {}
1248                UseTreeKind::Nested { items, span } => {
1249                    for (nested_tree, nested_id) in items {
1250                        try_visit!(visit_nested_use_tree(vis, nested_tree, nested_id));
1251                    }
1252                    try_visit!(visit_span(vis, span));
1253                }
1254            }
1255            visit_span(vis, span)
1256        }
1257
1258        pub fn walk_generic_args<$($lt,)? V: $Visitor$(<$lt>)?>(
1259            vis: &mut V,
1260            generic_args: &$($lt)? $($mut)? GenericArgs
1261        ) -> V::Result {
1262            match generic_args {
1263                GenericArgs::AngleBracketed(AngleBracketedArgs { span, args }) => {
1264                    for arg in args {
1265                        match arg {
1266                            AngleBracketedArg::Arg(a) => try_visit!(vis.visit_generic_arg(a)),
1267                            AngleBracketedArg::Constraint(c) => {
1268                                try_visit!(vis.visit_assoc_item_constraint(c))
1269                            }
1270                        }
1271                    }
1272                    visit_span(vis, span)
1273                }
1274                GenericArgs::Parenthesized(data) => {
1275                    let ParenthesizedArgs { span, inputs, inputs_span, output } = data;
1276                    walk_list!(vis, visit_ty, inputs);
1277                    try_visit!(vis.visit_fn_ret_ty(output));
1278                    try_visit!(visit_span(vis, span));
1279                    visit_span(vis, inputs_span)
1280                }
1281                GenericArgs::ParenthesizedElided(span) => visit_span(vis, span)
1282            }
1283        }
1284
1285        pub fn walk_generic_arg<$($lt,)? V: $Visitor$(<$lt>)?>(
1286            vis: &mut V,
1287            generic_arg: &$($lt)? $($mut)? GenericArg,
1288        ) -> V::Result {
1289            match generic_arg {
1290                GenericArg::Lifetime(lt) => vis.visit_lifetime(lt, $(${ignore($lt)} LifetimeCtxt::GenericArg)? ),
1291                GenericArg::Type(ty) => vis.visit_ty(ty),
1292                GenericArg::Const(ct) => vis.visit_anon_const(ct),
1293            }
1294        }
1295
1296        pub fn walk_assoc_item_constraint<$($lt,)? V: $Visitor$(<$lt>)?>(
1297            vis: &mut V,
1298            constraint: &$($lt)? $($mut)? AssocItemConstraint,
1299        ) -> V::Result {
1300            let AssocItemConstraint { id, ident, gen_args, kind, span } = constraint;
1301            try_visit!(visit_id(vis, id));
1302            try_visit!(vis.visit_ident(ident));
1303            visit_opt!(vis, visit_generic_args, gen_args);
1304            match kind {
1305                AssocItemConstraintKind::Equality { term } => match term {
1306                    Term::Ty(ty) => try_visit!(vis.visit_ty(ty)),
1307                    Term::Const(c) => try_visit!(vis.visit_anon_const(c)),
1308                },
1309                AssocItemConstraintKind::Bound { bounds } => {
1310                    try_visit!(visit_bounds(vis, bounds, BoundKind::Bound));
1311                }
1312            }
1313            visit_span(vis, span)
1314        }
1315
1316        pub fn walk_param_bound<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, bound: &$($lt)? $($mut)? GenericBound) -> V::Result {
1317            match bound {
1318                GenericBound::Trait(trait_ref) => vis.visit_poly_trait_ref(trait_ref),
1319                GenericBound::Outlives(lifetime) => vis.visit_lifetime(lifetime, $(${ignore($lt)} LifetimeCtxt::Bound)?),
1320                GenericBound::Use(args, span) => {
1321                    walk_list!(vis, visit_precise_capturing_arg, args);
1322                    visit_span(vis, span)
1323                }
1324            }
1325        }
1326
1327        pub fn walk_precise_capturing_arg<$($lt,)? V: $Visitor$(<$lt>)?>(
1328            vis: &mut V,
1329            arg: &$($lt)? $($mut)? PreciseCapturingArg,
1330        ) -> V::Result {
1331            match arg {
1332                PreciseCapturingArg::Lifetime(lt) => vis.visit_lifetime(lt, $(${ignore($lt)} LifetimeCtxt::GenericArg)?),
1333                PreciseCapturingArg::Arg(path, id) => {
1334                    try_visit!(visit_id(vis, id));
1335                    vis.visit_path(path)
1336                }
1337            }
1338        }
1339
1340        pub fn walk_generic_param<$($lt,)? V: $Visitor$(<$lt>)?>(
1341            vis: &mut V,
1342            param: &$($lt)? $($mut)? GenericParam,
1343        ) -> V::Result {
1344            let GenericParam { id, ident, attrs, bounds, is_placeholder: _, kind, colon_span } =
1345                param;
1346            try_visit!(visit_id(vis, id));
1347            walk_list!(vis, visit_attribute, attrs);
1348            try_visit!(vis.visit_ident(ident));
1349            walk_list!(vis, visit_param_bound, bounds, BoundKind::Bound);
1350            match kind {
1351                GenericParamKind::Lifetime => (),
1352                GenericParamKind::Type { default } => visit_opt!(vis, visit_ty, default),
1353                GenericParamKind::Const { ty, default, kw_span: _ } => {
1354                    try_visit!(vis.visit_ty(ty));
1355                    visit_opt!(vis, visit_anon_const, default);
1356                }
1357            }
1358            if let Some(sp) = colon_span {
1359                try_visit!(visit_span(vis, sp))
1360            }
1361            V::Result::output()
1362        }
1363
1364        pub fn walk_generics<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, generics: &$($lt)? $($mut)? Generics) -> V::Result {
1365            let Generics { params, where_clause, span } = generics;
1366            let WhereClause { has_where_token: _, predicates, span: where_clause_span } = where_clause;
1367            try_visit!(visit_generic_params(vis, params));
1368            try_visit!(visit_where_predicates(vis, predicates));
1369            try_visit!(visit_span(vis, span));
1370            visit_span(vis, where_clause_span)
1371        }
1372
1373        pub fn walk_contract<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, c: &$($lt)? $($mut)? FnContract) -> V::Result {
1374            let FnContract { requires, ensures } = c;
1375            visit_opt!(vis, visit_expr, requires);
1376            visit_opt!(vis, visit_expr, ensures);
1377            V::Result::output()
1378        }
1379
1380        pub fn walk_where_predicate<$($lt,)? V: $Visitor$(<$lt>)?>(
1381            vis: &mut V,
1382            predicate: &$($lt)? $($mut)? WherePredicate,
1383        ) -> V::Result {
1384            let WherePredicate { attrs, kind, id, span, is_placeholder: _ } = predicate;
1385            try_visit!(visit_id(vis, id));
1386            walk_list!(vis, visit_attribute, attrs);
1387            try_visit!(visit_span(vis, span));
1388            vis.visit_where_predicate_kind(kind)
1389        }
1390
1391        pub fn walk_closure_binder<$($lt,)? V: $Visitor$(<$lt>)?>(
1392            vis: &mut V,
1393            binder: &$($lt)? $($mut)? ClosureBinder,
1394        ) -> V::Result {
1395            match binder {
1396                ClosureBinder::NotPresent => {}
1397                ClosureBinder::For { generic_params, span } => {
1398                    try_visit!(visit_generic_params(vis, generic_params));
1399                    try_visit!(visit_span(vis, span));
1400                }
1401            }
1402            V::Result::output()
1403        }
1404
1405        pub fn walk_where_predicate_kind<$($lt,)? V: $Visitor$(<$lt>)?>(
1406            vis: &mut V,
1407            kind: &$($lt)? $($mut)? WherePredicateKind,
1408        ) -> V::Result {
1409            match kind {
1410                WherePredicateKind::BoundPredicate(WhereBoundPredicate {
1411                    bounded_ty,
1412                    bounds,
1413                    bound_generic_params,
1414                }) => {
1415                    try_visit!(visit_generic_params(vis, bound_generic_params));
1416                    try_visit!(vis.visit_ty(bounded_ty));
1417                    walk_list!(vis, visit_param_bound, bounds, BoundKind::Bound);
1418                }
1419                WherePredicateKind::RegionPredicate(WhereRegionPredicate { lifetime, bounds }) => {
1420                    try_visit!(vis.visit_lifetime(lifetime, $(${ignore($lt)} LifetimeCtxt::Bound )?));
1421                    walk_list!(vis, visit_param_bound, bounds, BoundKind::Bound);
1422                }
1423                WherePredicateKind::EqPredicate(WhereEqPredicate { lhs_ty, rhs_ty }) => {
1424                    try_visit!(vis.visit_ty(lhs_ty));
1425                    try_visit!(vis.visit_ty(rhs_ty));
1426                }
1427            }
1428            V::Result::output()
1429        }
1430
1431        pub fn walk_fn_decl<$($lt,)? V: $Visitor$(<$lt>)?>(
1432            vis: &mut V,
1433            FnDecl { inputs, output }: &$($lt)? $($mut)? FnDecl,
1434        ) -> V::Result {
1435            try_visit!(visit_params(vis, inputs));
1436            vis.visit_fn_ret_ty(output)
1437        }
1438
1439        pub fn walk_fn_ret_ty<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, ret_ty: &$($lt)? $($mut)? FnRetTy) -> V::Result {
1440            match ret_ty {
1441                FnRetTy::Default(span) => visit_span(vis, span),
1442                FnRetTy::Ty(output_ty) => vis.visit_ty(output_ty),
1443            }
1444        }
1445
1446        pub fn walk_fn<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, kind: FnKind<$($lt)? $(${ignore($mut)} '_)?>) -> V::Result {
1447            match kind {
1448                FnKind::Fn(
1449                    _ctxt,
1450                    _vis,
1451                    Fn {
1452                        defaultness,
1453                        ident,
1454                        sig: FnSig { header, decl, span },
1455                        generics,
1456                        contract,
1457                        body,
1458                        define_opaque,
1459                    },
1460                ) => {
1461                    // Visibility is visited as a part of the item.
1462                    try_visit!(visit_defaultness(vis, defaultness));
1463                    try_visit!(vis.visit_ident(ident));
1464                    try_visit!(vis.visit_fn_header(header));
1465                    try_visit!(vis.visit_generics(generics));
1466                    try_visit!(vis.visit_fn_decl(decl));
1467                    visit_opt!(vis, visit_contract, contract);
1468                    visit_opt!(vis, visit_block, body);
1469                    try_visit!(visit_span(vis, span));
1470                    walk_define_opaques(vis, define_opaque)
1471                }
1472                FnKind::Closure(binder, coroutine_kind, decl, body) => {
1473                    try_visit!(vis.visit_closure_binder(binder));
1474                    visit_opt!(vis, visit_coroutine_kind, coroutine_kind);
1475                    try_visit!(vis.visit_fn_decl(decl));
1476                    vis.visit_expr(body)
1477                }
1478            }
1479        }
1480
1481        pub fn walk_variant_data<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, data: &$($lt)? $($mut)? VariantData) -> V::Result {
1482            match data {
1483                VariantData::Struct { fields, recovered: _ } => {
1484                    visit_field_defs(vis, fields)
1485                }
1486                VariantData::Tuple(fields, id) => {
1487                    try_visit!(visit_id(vis, id));
1488                    visit_field_defs(vis, fields)
1489                }
1490                VariantData::Unit(id) => visit_id(vis, id),
1491            }
1492        }
1493
1494        pub fn walk_field_def<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, field: &$($lt)? $($mut)? FieldDef) -> V::Result {
1495            let FieldDef { attrs, id, span, vis: visibility, ident, ty, is_placeholder: _, safety: _, default } =
1496                field;
1497            try_visit!(visit_id(vis, id));
1498            walk_list!(vis, visit_attribute, attrs);
1499            try_visit!(vis.visit_vis(visibility));
1500            visit_opt!(vis, visit_ident, ident);
1501            try_visit!(vis.visit_ty(ty));
1502            visit_opt!(vis, visit_anon_const, default);
1503            visit_span(vis, span)
1504        }
1505
1506        fn visit_delim_args<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, args: &$($lt)? $($mut)? DelimArgs) -> V::Result {
1507            let DelimArgs { dspan, delim: _, tokens: _ } = args;
1508            let DelimSpan { open, close } = dspan;
1509            try_visit!(visit_span(vis, open));
1510            visit_span(vis, close)
1511        }
1512
1513        pub fn walk_mac<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, mac: &$($lt)? $($mut)? MacCall) -> V::Result {
1514            let MacCall { path, args } = mac;
1515            try_visit!(vis.visit_path(path));
1516            visit_delim_args(vis, args)
1517        }
1518
1519        fn walk_macro_def<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, macro_def: &$($lt)? $($mut)? MacroDef) -> V::Result {
1520            let MacroDef { body, macro_rules: _ } = macro_def;
1521            visit_delim_args(vis, body)
1522        }
1523
1524        pub fn walk_inline_asm<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, asm: &$($lt)? $($mut)? InlineAsm) -> V::Result {
1525            // FIXME: Visit spans inside all this currently ignored stuff.
1526            let InlineAsm {
1527                asm_macro: _,
1528                template: _,
1529                template_strs: _,
1530                operands,
1531                clobber_abis: _,
1532                options: _,
1533                line_spans: _,
1534            } = asm;
1535            for (op, span) in operands {
1536                match op {
1537                    InlineAsmOperand::In { expr, reg: _ }
1538                    | InlineAsmOperand::Out { expr: Some(expr), reg: _, late: _ }
1539                    | InlineAsmOperand::InOut { expr, reg: _, late: _ } => {
1540                        try_visit!(vis.visit_expr(expr))
1541                    }
1542                    InlineAsmOperand::Out { expr: None, reg: _, late: _ } => {}
1543                    InlineAsmOperand::SplitInOut { in_expr, out_expr, reg: _, late: _ } => {
1544                        try_visit!(vis.visit_expr(in_expr));
1545                        visit_opt!(vis, visit_expr, out_expr);
1546                    }
1547                    InlineAsmOperand::Const { anon_const } => {
1548                        try_visit!(vis.visit_anon_const(anon_const))
1549                    }
1550                    InlineAsmOperand::Sym { sym } => try_visit!(vis.visit_inline_asm_sym(sym)),
1551                    InlineAsmOperand::Label { block } => try_visit!(vis.visit_block(block)),
1552                }
1553                try_visit!(visit_span(vis, span));
1554            }
1555            V::Result::output()
1556        }
1557
1558        pub fn walk_inline_asm_sym<$($lt,)? V: $Visitor$(<$lt>)?>(
1559            vis: &mut V,
1560            InlineAsmSym { id, qself, path }: &$($lt)? $($mut)? InlineAsmSym,
1561        ) -> V::Result {
1562            try_visit!(visit_id(vis, id));
1563            try_visit!(vis.visit_qself(qself));
1564            vis.visit_path(path)
1565        }
1566
1567        // FIXME: visit the template exhaustively.
1568        pub fn walk_format_args<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, fmt: &$($lt)? $($mut)? FormatArgs) -> V::Result {
1569            let FormatArgs { span, template: _, arguments, uncooked_fmt_str: _, is_source_literal: _ } = fmt;
1570            let args = $(${ignore($mut)} arguments.all_args_mut())? $(${ignore($lt)} arguments.all_args())? ;
1571            for FormatArgument { kind, expr } in args {
1572                match kind {
1573                    FormatArgumentKind::Named(ident) | FormatArgumentKind::Captured(ident) => {
1574                        try_visit!(vis.visit_ident(ident))
1575                    }
1576                    FormatArgumentKind::Normal => {}
1577                }
1578                try_visit!(vis.visit_expr(expr));
1579            }
1580            visit_span(vis, span)
1581        }
1582
1583        pub fn walk_expr<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, expression: &$($lt)? $($mut)? Expr) -> V::Result {
1584            let Expr { id, kind, span, attrs, tokens: _ } = expression;
1585            try_visit!(visit_id(vis, id));
1586            walk_list!(vis, visit_attribute, attrs);
1587            match kind {
1588                ExprKind::Array(exprs) => {
1589                    try_visit!(visit_exprs(vis, exprs));
1590                }
1591                ExprKind::ConstBlock(anon_const) => try_visit!(vis.visit_anon_const(anon_const)),
1592                ExprKind::Repeat(element, count) => {
1593                    try_visit!(vis.visit_expr(element));
1594                    try_visit!(vis.visit_anon_const(count));
1595                }
1596                ExprKind::Struct(se) => {
1597                    let StructExpr { qself, path, fields, rest } = &$($mut)?**se;
1598                    try_visit!(vis.visit_qself(qself));
1599                    try_visit!(vis.visit_path(path));
1600                    try_visit!(visit_expr_fields(vis, fields));
1601                    match rest {
1602                        StructRest::Base(expr) => try_visit!(vis.visit_expr(expr)),
1603                        StructRest::Rest(_span) => {}
1604                        StructRest::None => {}
1605                    }
1606                }
1607                ExprKind::Tup(exprs) => {
1608                    try_visit!(visit_exprs(vis, exprs));
1609                }
1610                ExprKind::Call(callee_expression, arguments) => {
1611                    try_visit!(vis.visit_expr(callee_expression));
1612                    try_visit!(visit_exprs(vis, arguments));
1613                }
1614                ExprKind::MethodCall(box MethodCall { seg, receiver, args, span }) => {
1615                    try_visit!(vis.visit_method_receiver_expr(receiver));
1616                    try_visit!(vis.visit_path_segment(seg));
1617                    try_visit!(visit_exprs(vis, args));
1618                    try_visit!(visit_span(vis, span));
1619                }
1620                ExprKind::Binary(Spanned { span, node: _ }, left_expression, right_expression) => {
1621                    try_visit!(vis.visit_expr(left_expression));
1622                    try_visit!(vis.visit_expr(right_expression));
1623                    try_visit!(visit_span(vis, span))
1624                }
1625                ExprKind::AddrOf(_kind, _mutbl, subexpression) => {
1626                    try_visit!(vis.visit_expr(subexpression));
1627                }
1628                ExprKind::Unary(_op, subexpression) => {
1629                    try_visit!(vis.visit_expr(subexpression));
1630                }
1631                ExprKind::Cast(subexpression, typ) | ExprKind::Type(subexpression, typ) => {
1632                    try_visit!(vis.visit_expr(subexpression));
1633                    try_visit!(vis.visit_ty(typ));
1634                }
1635                ExprKind::Let(pat, expr, span, _recovered) => {
1636                    try_visit!(vis.visit_pat(pat));
1637                    try_visit!(vis.visit_expr(expr));
1638                    try_visit!(visit_span(vis, span))
1639                }
1640                ExprKind::If(head_expression, if_block, optional_else) => {
1641                    try_visit!(vis.visit_expr(head_expression));
1642                    try_visit!(vis.visit_block(if_block));
1643                    visit_opt!(vis, visit_expr, optional_else);
1644                }
1645                ExprKind::While(subexpression, block, opt_label) => {
1646                    visit_opt!(vis, visit_label, opt_label);
1647                    try_visit!(vis.visit_expr(subexpression));
1648                    try_visit!(vis.visit_block(block));
1649                }
1650                ExprKind::ForLoop { pat, iter, body, label, kind: _ } => {
1651                    visit_opt!(vis, visit_label, label);
1652                    try_visit!(vis.visit_pat(pat));
1653                    try_visit!(vis.visit_expr(iter));
1654                    try_visit!(vis.visit_block(body));
1655                }
1656                ExprKind::Loop(block, opt_label, span) => {
1657                    visit_opt!(vis, visit_label, opt_label);
1658                    try_visit!(vis.visit_block(block));
1659                    try_visit!(visit_span(vis, span))
1660                }
1661                ExprKind::Match(subexpression, arms, _kind) => {
1662                    try_visit!(vis.visit_expr(subexpression));
1663                    try_visit!(visit_arms(vis, arms));
1664                }
1665                ExprKind::Closure(box Closure {
1666                    binder,
1667                    capture_clause,
1668                    coroutine_kind,
1669                    constness,
1670                    movability: _,
1671                    fn_decl,
1672                    body,
1673                    fn_decl_span,
1674                    fn_arg_span,
1675                }) => {
1676                    try_visit!(visit_constness(vis, constness));
1677                    try_visit!(vis.visit_capture_by(capture_clause));
1678                    try_visit!(vis.visit_fn(
1679                        FnKind::Closure(binder, coroutine_kind, fn_decl, body),
1680                        *span,
1681                        *id
1682                    ));
1683                    try_visit!(visit_span(vis, fn_decl_span));
1684                    try_visit!(visit_span(vis, fn_arg_span));
1685                }
1686                ExprKind::Block(block, opt_label) => {
1687                    visit_opt!(vis, visit_label, opt_label);
1688                    try_visit!(vis.visit_block(block));
1689                }
1690                ExprKind::Gen(_capt, body, _kind, decl_span) => {
1691                    try_visit!(vis.visit_block(body));
1692                    try_visit!(visit_span(vis, decl_span));
1693                }
1694                ExprKind::Await(expr, span) => {
1695                    try_visit!(vis.visit_expr(expr));
1696                    try_visit!(visit_span(vis, span));
1697                }
1698                ExprKind::Use(expr, span) => {
1699                    try_visit!(vis.visit_expr(expr));
1700                    try_visit!(visit_span(vis, span));
1701                }
1702                ExprKind::Assign(lhs, rhs, span) => {
1703                    try_visit!(vis.visit_expr(lhs));
1704                    try_visit!(vis.visit_expr(rhs));
1705                    try_visit!(visit_span(vis, span));
1706                }
1707                ExprKind::AssignOp(_op, left_expression, right_expression) => {
1708                    try_visit!(vis.visit_expr(left_expression));
1709                    try_visit!(vis.visit_expr(right_expression));
1710                }
1711                ExprKind::Field(subexpression, ident) => {
1712                    try_visit!(vis.visit_expr(subexpression));
1713                    try_visit!(vis.visit_ident(ident));
1714                }
1715                ExprKind::Index(main_expression, index_expression, span) => {
1716                    try_visit!(vis.visit_expr(main_expression));
1717                    try_visit!(vis.visit_expr(index_expression));
1718                    try_visit!(visit_span(vis, span));
1719                }
1720                ExprKind::Range(start, end, _limit) => {
1721                    visit_opt!(vis, visit_expr, start);
1722                    visit_opt!(vis, visit_expr, end);
1723                }
1724                ExprKind::Underscore => {}
1725                ExprKind::Path(maybe_qself, path) => {
1726                    try_visit!(vis.visit_qself(maybe_qself));
1727                    try_visit!(vis.visit_path(path));
1728                }
1729                ExprKind::Break(opt_label, opt_expr) => {
1730                    visit_opt!(vis, visit_label, opt_label);
1731                    visit_opt!(vis, visit_expr, opt_expr);
1732                }
1733                ExprKind::Continue(opt_label) => {
1734                    visit_opt!(vis, visit_label, opt_label);
1735                }
1736                ExprKind::Ret(optional_expression) => {
1737                    visit_opt!(vis, visit_expr, optional_expression);
1738                }
1739                ExprKind::Yeet(optional_expression) => {
1740                    visit_opt!(vis, visit_expr, optional_expression);
1741                }
1742                ExprKind::Become(expr) => try_visit!(vis.visit_expr(expr)),
1743                ExprKind::MacCall(mac) => try_visit!(vis.visit_mac_call(mac)),
1744                ExprKind::Paren(subexpression) => try_visit!(vis.visit_expr(subexpression)),
1745                ExprKind::InlineAsm(asm) => try_visit!(vis.visit_inline_asm(asm)),
1746                ExprKind::FormatArgs(f) => try_visit!(vis.visit_format_args(f)),
1747                ExprKind::OffsetOf(container, fields) => {
1748                    try_visit!(vis.visit_ty(container));
1749                    walk_list!(vis, visit_ident, fields);
1750                }
1751                ExprKind::Yield(kind) => {
1752                    match kind {
1753                        YieldKind::Postfix(expr) => {
1754                            try_visit!(vis.visit_expr(expr));
1755                        }
1756                        YieldKind::Prefix(expr) => {
1757                            visit_opt!(vis, visit_expr, expr);
1758                        }
1759                    }
1760                }
1761                ExprKind::Try(subexpression) => try_visit!(vis.visit_expr(subexpression)),
1762                ExprKind::TryBlock(body) => try_visit!(vis.visit_block(body)),
1763                ExprKind::Lit(_token) => {}
1764                ExprKind::IncludedBytes(_bytes) => {}
1765                ExprKind::UnsafeBinderCast(_kind, expr, ty) => {
1766                    try_visit!(vis.visit_expr(expr));
1767                    visit_opt!(vis, visit_ty, ty);
1768                }
1769                ExprKind::Err(_guar) => {}
1770                ExprKind::Dummy => {}
1771            }
1772
1773            visit_span(vis, span)
1774        }
1775
1776        pub fn walk_param<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, param: &$($lt)? $($mut)? Param) -> V::Result {
1777            let Param { attrs, ty, pat, id, span, is_placeholder: _ } = param;
1778            try_visit!(visit_id(vis, id));
1779            walk_list!(vis, visit_attribute, attrs);
1780            try_visit!(vis.visit_pat(pat));
1781            try_visit!(vis.visit_ty(ty));
1782            visit_span(vis, span)
1783        }
1784
1785        pub fn walk_arm<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, arm: &$($lt)? $($mut)? Arm) -> V::Result {
1786            let Arm { attrs, pat, guard, body, span, id, is_placeholder: _ } = arm;
1787            try_visit!(visit_id(vis, id));
1788            walk_list!(vis, visit_attribute, attrs);
1789            try_visit!(vis.visit_pat(pat));
1790            visit_opt!(vis, visit_expr, guard);
1791            visit_opt!(vis, visit_expr, body);
1792            visit_span(vis, span)
1793        }
1794
1795        pub fn walk_vis<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, visibility: &$($lt)? $($mut)? Visibility) -> V::Result {
1796            let Visibility { kind, span, tokens: _ } = visibility;
1797            match kind {
1798                VisibilityKind::Restricted { path, id, shorthand: _ } => {
1799                    try_visit!(visit_id(vis, id));
1800                    try_visit!(vis.visit_path(path));
1801                }
1802                VisibilityKind::Public | VisibilityKind::Inherited => {}
1803            }
1804            visit_span(vis, span)
1805        }
1806
1807        pub fn walk_attribute<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, attr: &$($lt)? $($mut)? Attribute) -> V::Result {
1808            let Attribute { kind, id: _, style: _, span } = attr;
1809            match kind {
1810                AttrKind::Normal(normal) => {
1811                    let NormalAttr { item, tokens: _ } = &$($mut)?**normal;
1812                    let AttrItem { unsafety: _, path, args, tokens: _ } = item;
1813                    try_visit!(vis.visit_path(path));
1814                    try_visit!(walk_attr_args(vis, args));
1815                }
1816                AttrKind::DocComment(_kind, _sym) => {}
1817            }
1818            visit_span(vis, span)
1819        }
1820
1821        pub fn walk_attr_args<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, args: &$($lt)? $($mut)? AttrArgs) -> V::Result {
1822            match args {
1823                AttrArgs::Empty => {}
1824                AttrArgs::Delimited(args) => try_visit!(visit_delim_args(vis, args)),
1825                AttrArgs::Eq { eq_span, expr } => {
1826                    try_visit!(vis.visit_expr(expr));
1827                    try_visit!(visit_span(vis, eq_span));
1828                }
1829            }
1830            V::Result::output()
1831        }
1832    };
1833}
1834
1835common_visitor_and_walkers!(Visitor<'a>);
1836
1837macro_rules! generate_list_visit_fns {
1838    ($($name:ident, $Ty:ty, $visit_fn:ident$(, $param:ident: $ParamTy:ty)*;)+) => {
1839        $(
1840            fn $name<'a, V: Visitor<'a>>(
1841                vis: &mut V,
1842                values: &'a ThinVec<$Ty>,
1843                $(
1844                    $param: $ParamTy,
1845                )*
1846            ) -> V::Result {
1847                walk_list!(vis, $visit_fn, values$(,$param)*);
1848                V::Result::output()
1849            }
1850        )+
1851    }
1852}
1853
1854generate_list_visit_fns! {
1855    visit_items, P<Item>, visit_item;
1856    visit_foreign_items, P<ForeignItem>, visit_foreign_item;
1857    visit_generic_params, GenericParam, visit_generic_param;
1858    visit_stmts, Stmt, visit_stmt;
1859    visit_exprs, P<Expr>, visit_expr;
1860    visit_expr_fields, ExprField, visit_expr_field;
1861    visit_pat_fields, PatField, visit_pat_field;
1862    visit_variants, Variant, visit_variant;
1863    visit_assoc_items, P<AssocItem>, visit_assoc_item, ctxt: AssocCtxt;
1864    visit_where_predicates, WherePredicate, visit_where_predicate;
1865    visit_params, Param, visit_param;
1866    visit_field_defs, FieldDef, visit_field_def;
1867    visit_arms, Arm, visit_arm;
1868}
1869
1870#[expect(rustc::pass_by_value)] // needed for symmetry with mut_visit
1871fn visit_nested_use_tree<'a, V: Visitor<'a>>(
1872    vis: &mut V,
1873    nested_tree: &'a UseTree,
1874    &nested_id: &NodeId,
1875) -> V::Result {
1876    vis.visit_nested_use_tree(nested_tree, nested_id)
1877}
1878
1879pub fn walk_stmt<'a, V: Visitor<'a>>(visitor: &mut V, statement: &'a Stmt) -> V::Result {
1880    let Stmt { id, kind, span: _ } = statement;
1881    try_visit!(visit_id(visitor, id));
1882    match kind {
1883        StmtKind::Let(local) => try_visit!(visitor.visit_local(local)),
1884        StmtKind::Item(item) => try_visit!(visitor.visit_item(item)),
1885        StmtKind::Expr(expr) | StmtKind::Semi(expr) => try_visit!(visitor.visit_expr(expr)),
1886        StmtKind::Empty => {}
1887        StmtKind::MacCall(mac) => {
1888            let MacCallStmt { mac, attrs, style: _, tokens: _ } = &**mac;
1889            walk_list!(visitor, visit_attribute, attrs);
1890            try_visit!(visitor.visit_mac_call(mac));
1891        }
1892    }
1893    V::Result::output()
1894}