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 occurring 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::FnPtr(function_declaration) => {
1063                    let FnPtrTy { 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, parens: _ } = 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, Spanned { span, node: _include_end }) => {
1206                    visit_opt!(vis, visit_anon_const, start);
1207                    visit_opt!(vis, visit_anon_const, end);
1208                    try_visit!(visit_span(vis, span));
1209                }
1210                TyPatKind::Or(variants) => walk_list!(vis, visit_ty_pat, variants),
1211                TyPatKind::Err(_) => {}
1212            }
1213            visit_span(vis, span)
1214        }
1215
1216        fn walk_qself<$($lt,)? V: $Visitor$(<$lt>)?>(
1217            vis: &mut V,
1218            qself: &$($lt)? $($mut)? Option<P<QSelf>>,
1219        ) -> V::Result {
1220            if let Some(qself) = qself {
1221                let QSelf { ty, path_span, position: _ } = &$($mut)? **qself;
1222                try_visit!(vis.visit_ty(ty));
1223                try_visit!(visit_span(vis, path_span));
1224            }
1225            V::Result::output()
1226        }
1227
1228        pub fn walk_path<$($lt,)? V: $Visitor$(<$lt>)?>(
1229            vis: &mut V,
1230            path: &$($lt)? $($mut)? Path,
1231        ) -> V::Result {
1232            let Path { span, segments, tokens: _ } = path;
1233            walk_list!(vis, visit_path_segment, segments);
1234            visit_span(vis, span)
1235        }
1236
1237        pub fn walk_use_tree<$($lt,)? V: $Visitor$(<$lt>)?>(
1238            vis: &mut V,
1239            use_tree: &$($lt)? $($mut)? UseTree,
1240        ) -> V::Result {
1241            let UseTree { prefix, kind, span } = use_tree;
1242            try_visit!(vis.visit_path(prefix));
1243            match kind {
1244                UseTreeKind::Simple(rename) => {
1245                    // The extra IDs are handled during AST lowering.
1246                    visit_opt!(vis, visit_ident, rename);
1247                }
1248                UseTreeKind::Glob => {}
1249                UseTreeKind::Nested { items, span } => {
1250                    for (nested_tree, nested_id) in items {
1251                        try_visit!(visit_nested_use_tree(vis, nested_tree, nested_id));
1252                    }
1253                    try_visit!(visit_span(vis, span));
1254                }
1255            }
1256            visit_span(vis, span)
1257        }
1258
1259        pub fn walk_generic_args<$($lt,)? V: $Visitor$(<$lt>)?>(
1260            vis: &mut V,
1261            generic_args: &$($lt)? $($mut)? GenericArgs
1262        ) -> V::Result {
1263            match generic_args {
1264                GenericArgs::AngleBracketed(AngleBracketedArgs { span, args }) => {
1265                    for arg in args {
1266                        match arg {
1267                            AngleBracketedArg::Arg(a) => try_visit!(vis.visit_generic_arg(a)),
1268                            AngleBracketedArg::Constraint(c) => {
1269                                try_visit!(vis.visit_assoc_item_constraint(c))
1270                            }
1271                        }
1272                    }
1273                    visit_span(vis, span)
1274                }
1275                GenericArgs::Parenthesized(data) => {
1276                    let ParenthesizedArgs { span, inputs, inputs_span, output } = data;
1277                    walk_list!(vis, visit_ty, inputs);
1278                    try_visit!(vis.visit_fn_ret_ty(output));
1279                    try_visit!(visit_span(vis, span));
1280                    visit_span(vis, inputs_span)
1281                }
1282                GenericArgs::ParenthesizedElided(span) => visit_span(vis, span)
1283            }
1284        }
1285
1286        pub fn walk_generic_arg<$($lt,)? V: $Visitor$(<$lt>)?>(
1287            vis: &mut V,
1288            generic_arg: &$($lt)? $($mut)? GenericArg,
1289        ) -> V::Result {
1290            match generic_arg {
1291                GenericArg::Lifetime(lt) => vis.visit_lifetime(lt, $(${ignore($lt)} LifetimeCtxt::GenericArg)? ),
1292                GenericArg::Type(ty) => vis.visit_ty(ty),
1293                GenericArg::Const(ct) => vis.visit_anon_const(ct),
1294            }
1295        }
1296
1297        pub fn walk_assoc_item_constraint<$($lt,)? V: $Visitor$(<$lt>)?>(
1298            vis: &mut V,
1299            constraint: &$($lt)? $($mut)? AssocItemConstraint,
1300        ) -> V::Result {
1301            let AssocItemConstraint { id, ident, gen_args, kind, span } = constraint;
1302            try_visit!(visit_id(vis, id));
1303            try_visit!(vis.visit_ident(ident));
1304            visit_opt!(vis, visit_generic_args, gen_args);
1305            match kind {
1306                AssocItemConstraintKind::Equality { term } => match term {
1307                    Term::Ty(ty) => try_visit!(vis.visit_ty(ty)),
1308                    Term::Const(c) => try_visit!(vis.visit_anon_const(c)),
1309                },
1310                AssocItemConstraintKind::Bound { bounds } => {
1311                    try_visit!(visit_bounds(vis, bounds, BoundKind::Bound));
1312                }
1313            }
1314            visit_span(vis, span)
1315        }
1316
1317        pub fn walk_param_bound<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, bound: &$($lt)? $($mut)? GenericBound) -> V::Result {
1318            match bound {
1319                GenericBound::Trait(trait_ref) => vis.visit_poly_trait_ref(trait_ref),
1320                GenericBound::Outlives(lifetime) => vis.visit_lifetime(lifetime, $(${ignore($lt)} LifetimeCtxt::Bound)?),
1321                GenericBound::Use(args, span) => {
1322                    walk_list!(vis, visit_precise_capturing_arg, args);
1323                    visit_span(vis, span)
1324                }
1325            }
1326        }
1327
1328        pub fn walk_precise_capturing_arg<$($lt,)? V: $Visitor$(<$lt>)?>(
1329            vis: &mut V,
1330            arg: &$($lt)? $($mut)? PreciseCapturingArg,
1331        ) -> V::Result {
1332            match arg {
1333                PreciseCapturingArg::Lifetime(lt) => vis.visit_lifetime(lt, $(${ignore($lt)} LifetimeCtxt::GenericArg)?),
1334                PreciseCapturingArg::Arg(path, id) => {
1335                    try_visit!(visit_id(vis, id));
1336                    vis.visit_path(path)
1337                }
1338            }
1339        }
1340
1341        pub fn walk_generic_param<$($lt,)? V: $Visitor$(<$lt>)?>(
1342            vis: &mut V,
1343            param: &$($lt)? $($mut)? GenericParam,
1344        ) -> V::Result {
1345            let GenericParam { id, ident, attrs, bounds, is_placeholder: _, kind, colon_span } =
1346                param;
1347            try_visit!(visit_id(vis, id));
1348            walk_list!(vis, visit_attribute, attrs);
1349            try_visit!(vis.visit_ident(ident));
1350            walk_list!(vis, visit_param_bound, bounds, BoundKind::Bound);
1351            match kind {
1352                GenericParamKind::Lifetime => (),
1353                GenericParamKind::Type { default } => visit_opt!(vis, visit_ty, default),
1354                GenericParamKind::Const { ty, default, span } => {
1355                    try_visit!(vis.visit_ty(ty));
1356                    visit_opt!(vis, visit_anon_const, default);
1357                    try_visit!(visit_span(vis, span));
1358                }
1359            }
1360            if let Some(sp) = colon_span {
1361                try_visit!(visit_span(vis, sp))
1362            }
1363            V::Result::output()
1364        }
1365
1366        pub fn walk_generics<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, generics: &$($lt)? $($mut)? Generics) -> V::Result {
1367            let Generics { params, where_clause, span } = generics;
1368            let WhereClause { has_where_token: _, predicates, span: where_clause_span } = where_clause;
1369            try_visit!(visit_generic_params(vis, params));
1370            try_visit!(visit_where_predicates(vis, predicates));
1371            try_visit!(visit_span(vis, span));
1372            visit_span(vis, where_clause_span)
1373        }
1374
1375        pub fn walk_contract<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, c: &$($lt)? $($mut)? FnContract) -> V::Result {
1376            let FnContract { requires, ensures } = c;
1377            visit_opt!(vis, visit_expr, requires);
1378            visit_opt!(vis, visit_expr, ensures);
1379            V::Result::output()
1380        }
1381
1382        pub fn walk_where_predicate<$($lt,)? V: $Visitor$(<$lt>)?>(
1383            vis: &mut V,
1384            predicate: &$($lt)? $($mut)? WherePredicate,
1385        ) -> V::Result {
1386            let WherePredicate { attrs, kind, id, span, is_placeholder: _ } = predicate;
1387            try_visit!(visit_id(vis, id));
1388            walk_list!(vis, visit_attribute, attrs);
1389            try_visit!(visit_span(vis, span));
1390            vis.visit_where_predicate_kind(kind)
1391        }
1392
1393        pub fn walk_closure_binder<$($lt,)? V: $Visitor$(<$lt>)?>(
1394            vis: &mut V,
1395            binder: &$($lt)? $($mut)? ClosureBinder,
1396        ) -> V::Result {
1397            match binder {
1398                ClosureBinder::NotPresent => {}
1399                ClosureBinder::For { generic_params, span } => {
1400                    try_visit!(visit_generic_params(vis, generic_params));
1401                    try_visit!(visit_span(vis, span));
1402                }
1403            }
1404            V::Result::output()
1405        }
1406
1407        pub fn walk_where_predicate_kind<$($lt,)? V: $Visitor$(<$lt>)?>(
1408            vis: &mut V,
1409            kind: &$($lt)? $($mut)? WherePredicateKind,
1410        ) -> V::Result {
1411            match kind {
1412                WherePredicateKind::BoundPredicate(WhereBoundPredicate {
1413                    bounded_ty,
1414                    bounds,
1415                    bound_generic_params,
1416                }) => {
1417                    try_visit!(visit_generic_params(vis, bound_generic_params));
1418                    try_visit!(vis.visit_ty(bounded_ty));
1419                    walk_list!(vis, visit_param_bound, bounds, BoundKind::Bound);
1420                }
1421                WherePredicateKind::RegionPredicate(WhereRegionPredicate { lifetime, bounds }) => {
1422                    try_visit!(vis.visit_lifetime(lifetime, $(${ignore($lt)} LifetimeCtxt::Bound )?));
1423                    walk_list!(vis, visit_param_bound, bounds, BoundKind::Bound);
1424                }
1425                WherePredicateKind::EqPredicate(WhereEqPredicate { lhs_ty, rhs_ty }) => {
1426                    try_visit!(vis.visit_ty(lhs_ty));
1427                    try_visit!(vis.visit_ty(rhs_ty));
1428                }
1429            }
1430            V::Result::output()
1431        }
1432
1433        pub fn walk_fn_decl<$($lt,)? V: $Visitor$(<$lt>)?>(
1434            vis: &mut V,
1435            FnDecl { inputs, output }: &$($lt)? $($mut)? FnDecl,
1436        ) -> V::Result {
1437            try_visit!(visit_params(vis, inputs));
1438            vis.visit_fn_ret_ty(output)
1439        }
1440
1441        pub fn walk_fn_ret_ty<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, ret_ty: &$($lt)? $($mut)? FnRetTy) -> V::Result {
1442            match ret_ty {
1443                FnRetTy::Default(span) => visit_span(vis, span),
1444                FnRetTy::Ty(output_ty) => vis.visit_ty(output_ty),
1445            }
1446        }
1447
1448        pub fn walk_fn<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, kind: FnKind<$($lt)? $(${ignore($mut)} '_)?>) -> V::Result {
1449            match kind {
1450                FnKind::Fn(
1451                    _ctxt,
1452                    _vis,
1453                    Fn {
1454                        defaultness,
1455                        ident,
1456                        sig: FnSig { header, decl, span },
1457                        generics,
1458                        contract,
1459                        body,
1460                        define_opaque,
1461                    },
1462                ) => {
1463                    // Visibility is visited as a part of the item.
1464                    try_visit!(visit_defaultness(vis, defaultness));
1465                    try_visit!(vis.visit_ident(ident));
1466                    try_visit!(vis.visit_fn_header(header));
1467                    try_visit!(vis.visit_generics(generics));
1468                    try_visit!(vis.visit_fn_decl(decl));
1469                    visit_opt!(vis, visit_contract, contract);
1470                    visit_opt!(vis, visit_block, body);
1471                    try_visit!(visit_span(vis, span));
1472                    walk_define_opaques(vis, define_opaque)
1473                }
1474                FnKind::Closure(binder, coroutine_kind, decl, body) => {
1475                    try_visit!(vis.visit_closure_binder(binder));
1476                    visit_opt!(vis, visit_coroutine_kind, coroutine_kind);
1477                    try_visit!(vis.visit_fn_decl(decl));
1478                    vis.visit_expr(body)
1479                }
1480            }
1481        }
1482
1483        pub fn walk_variant_data<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, data: &$($lt)? $($mut)? VariantData) -> V::Result {
1484            match data {
1485                VariantData::Struct { fields, recovered: _ } => {
1486                    visit_field_defs(vis, fields)
1487                }
1488                VariantData::Tuple(fields, id) => {
1489                    try_visit!(visit_id(vis, id));
1490                    visit_field_defs(vis, fields)
1491                }
1492                VariantData::Unit(id) => visit_id(vis, id),
1493            }
1494        }
1495
1496        pub fn walk_field_def<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, field: &$($lt)? $($mut)? FieldDef) -> V::Result {
1497            let FieldDef { attrs, id, span, vis: visibility, ident, ty, is_placeholder: _, safety: _, default } =
1498                field;
1499            try_visit!(visit_id(vis, id));
1500            walk_list!(vis, visit_attribute, attrs);
1501            try_visit!(vis.visit_vis(visibility));
1502            visit_opt!(vis, visit_ident, ident);
1503            try_visit!(vis.visit_ty(ty));
1504            visit_opt!(vis, visit_anon_const, default);
1505            visit_span(vis, span)
1506        }
1507
1508        fn visit_delim_args<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, args: &$($lt)? $($mut)? DelimArgs) -> V::Result {
1509            let DelimArgs { dspan, delim: _, tokens: _ } = args;
1510            let DelimSpan { open, close } = dspan;
1511            try_visit!(visit_span(vis, open));
1512            visit_span(vis, close)
1513        }
1514
1515        pub fn walk_mac<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, mac: &$($lt)? $($mut)? MacCall) -> V::Result {
1516            let MacCall { path, args } = mac;
1517            try_visit!(vis.visit_path(path));
1518            visit_delim_args(vis, args)
1519        }
1520
1521        fn walk_macro_def<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, macro_def: &$($lt)? $($mut)? MacroDef) -> V::Result {
1522            let MacroDef { body, macro_rules: _ } = macro_def;
1523            visit_delim_args(vis, body)
1524        }
1525
1526        pub fn walk_inline_asm<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, asm: &$($lt)? $($mut)? InlineAsm) -> V::Result {
1527            let InlineAsm {
1528                asm_macro: _,
1529                template,
1530                template_strs,
1531                operands,
1532                clobber_abis,
1533                options: _,
1534                line_spans,
1535            } = asm;
1536            for piece in template {
1537                match piece {
1538                    InlineAsmTemplatePiece::String(_str) => {}
1539                    InlineAsmTemplatePiece::Placeholder { operand_idx: _, modifier: _, span } => {
1540                        try_visit!(visit_span(vis, span));
1541                    }
1542                }
1543            }
1544            for (_s1, _s2, span) in template_strs {
1545                try_visit!(visit_span(vis, span));
1546            }
1547            for (op, span) in operands {
1548                match op {
1549                    InlineAsmOperand::In { expr, reg: _ }
1550                    | InlineAsmOperand::Out { expr: Some(expr), reg: _, late: _ }
1551                    | InlineAsmOperand::InOut { expr, reg: _, late: _ } => {
1552                        try_visit!(vis.visit_expr(expr))
1553                    }
1554                    InlineAsmOperand::Out { expr: None, reg: _, late: _ } => {}
1555                    InlineAsmOperand::SplitInOut { in_expr, out_expr, reg: _, late: _ } => {
1556                        try_visit!(vis.visit_expr(in_expr));
1557                        visit_opt!(vis, visit_expr, out_expr);
1558                    }
1559                    InlineAsmOperand::Const { anon_const } => {
1560                        try_visit!(vis.visit_anon_const(anon_const))
1561                    }
1562                    InlineAsmOperand::Sym { sym } => try_visit!(vis.visit_inline_asm_sym(sym)),
1563                    InlineAsmOperand::Label { block } => try_visit!(vis.visit_block(block)),
1564                }
1565                try_visit!(visit_span(vis, span));
1566            }
1567            for (_s1, span) in clobber_abis {
1568                try_visit!(visit_span(vis, span))
1569            }
1570            for span in line_spans {
1571                try_visit!(visit_span(vis, span))
1572            }
1573            V::Result::output()
1574        }
1575
1576        pub fn walk_inline_asm_sym<$($lt,)? V: $Visitor$(<$lt>)?>(
1577            vis: &mut V,
1578            InlineAsmSym { id, qself, path }: &$($lt)? $($mut)? InlineAsmSym,
1579        ) -> V::Result {
1580            try_visit!(visit_id(vis, id));
1581            try_visit!(vis.visit_qself(qself));
1582            vis.visit_path(path)
1583        }
1584
1585        pub fn walk_format_args<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, fmt: &$($lt)? $($mut)? FormatArgs) -> V::Result {
1586            let FormatArgs { span, template, arguments, uncooked_fmt_str: _, is_source_literal: _ } = fmt;
1587
1588            let args = $(${ignore($mut)} arguments.all_args_mut())? $(${ignore($lt)} arguments.all_args())? ;
1589            for FormatArgument { kind, expr } in args {
1590                match kind {
1591                    FormatArgumentKind::Named(ident) | FormatArgumentKind::Captured(ident) => {
1592                        try_visit!(vis.visit_ident(ident))
1593                    }
1594                    FormatArgumentKind::Normal => {}
1595                }
1596                try_visit!(vis.visit_expr(expr));
1597            }
1598            for piece in template {
1599                match piece {
1600                    FormatArgsPiece::Literal(_symbol) => {}
1601                    FormatArgsPiece::Placeholder(placeholder) => try_visit!(walk_format_placeholder(vis, placeholder)),
1602                }
1603            }
1604            visit_span(vis, span)
1605        }
1606
1607        fn walk_format_placeholder<$($lt,)? V: $Visitor$(<$lt>)?>(
1608            vis: &mut V,
1609            placeholder: &$($lt)? $($mut)? FormatPlaceholder,
1610        ) -> V::Result {
1611            let FormatPlaceholder { argument, span, format_options, format_trait: _ } = placeholder;
1612            if let Some(span) = span {
1613                try_visit!(visit_span(vis, span));
1614            }
1615            let FormatArgPosition { span, index: _, kind: _ } = argument;
1616            if let Some(span) = span {
1617                try_visit!(visit_span(vis, span));
1618            }
1619            let FormatOptions {
1620                width,
1621                precision,
1622                alignment: _,
1623                fill: _,
1624                sign: _,
1625                alternate: _,
1626                zero_pad: _,
1627                debug_hex: _,
1628            } = format_options;
1629            match width {
1630                None => {}
1631                Some(FormatCount::Literal(_)) => {}
1632                Some(FormatCount::Argument(FormatArgPosition { span, index: _, kind: _ })) => {
1633                    if let Some(span) = span {
1634                        try_visit!(visit_span(vis, span));
1635                    }
1636                }
1637            }
1638            match precision {
1639                None => {}
1640                Some(FormatCount::Literal(_)) => {}
1641                Some(FormatCount::Argument(FormatArgPosition { span, index: _, kind: _ })) => {
1642                    if let Some(span) = span {
1643                        try_visit!(visit_span(vis, span));
1644                    }
1645                }
1646            }
1647            V::Result::output()
1648        }
1649
1650        pub fn walk_expr<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, expression: &$($lt)? $($mut)? Expr) -> V::Result {
1651            let Expr { id, kind, span, attrs, tokens: _ } = expression;
1652            try_visit!(visit_id(vis, id));
1653            walk_list!(vis, visit_attribute, attrs);
1654            match kind {
1655                ExprKind::Array(exprs) => {
1656                    try_visit!(visit_exprs(vis, exprs));
1657                }
1658                ExprKind::ConstBlock(anon_const) => try_visit!(vis.visit_anon_const(anon_const)),
1659                ExprKind::Repeat(element, count) => {
1660                    try_visit!(vis.visit_expr(element));
1661                    try_visit!(vis.visit_anon_const(count));
1662                }
1663                ExprKind::Struct(se) => {
1664                    let StructExpr { qself, path, fields, rest } = &$($mut)?**se;
1665                    try_visit!(vis.visit_qself(qself));
1666                    try_visit!(vis.visit_path(path));
1667                    try_visit!(visit_expr_fields(vis, fields));
1668                    match rest {
1669                        StructRest::Base(expr) => try_visit!(vis.visit_expr(expr)),
1670                        StructRest::Rest(span) => try_visit!(visit_span(vis, span)),
1671                        StructRest::None => {}
1672                    }
1673                }
1674                ExprKind::Tup(exprs) => {
1675                    try_visit!(visit_exprs(vis, exprs));
1676                }
1677                ExprKind::Call(callee_expression, arguments) => {
1678                    try_visit!(vis.visit_expr(callee_expression));
1679                    try_visit!(visit_exprs(vis, arguments));
1680                }
1681                ExprKind::MethodCall(box MethodCall { seg, receiver, args, span }) => {
1682                    try_visit!(vis.visit_method_receiver_expr(receiver));
1683                    try_visit!(vis.visit_path_segment(seg));
1684                    try_visit!(visit_exprs(vis, args));
1685                    try_visit!(visit_span(vis, span));
1686                }
1687                ExprKind::Binary(Spanned { span, node: _ }, left_expression, right_expression) => {
1688                    try_visit!(vis.visit_expr(left_expression));
1689                    try_visit!(vis.visit_expr(right_expression));
1690                    try_visit!(visit_span(vis, span))
1691                }
1692                ExprKind::AddrOf(_kind, _mutbl, subexpression) => {
1693                    try_visit!(vis.visit_expr(subexpression));
1694                }
1695                ExprKind::Unary(_op, subexpression) => {
1696                    try_visit!(vis.visit_expr(subexpression));
1697                }
1698                ExprKind::Cast(subexpression, typ) | ExprKind::Type(subexpression, typ) => {
1699                    try_visit!(vis.visit_expr(subexpression));
1700                    try_visit!(vis.visit_ty(typ));
1701                }
1702                ExprKind::Let(pat, expr, span, _recovered) => {
1703                    try_visit!(vis.visit_pat(pat));
1704                    try_visit!(vis.visit_expr(expr));
1705                    try_visit!(visit_span(vis, span))
1706                }
1707                ExprKind::If(head_expression, if_block, optional_else) => {
1708                    try_visit!(vis.visit_expr(head_expression));
1709                    try_visit!(vis.visit_block(if_block));
1710                    visit_opt!(vis, visit_expr, optional_else);
1711                }
1712                ExprKind::While(subexpression, block, opt_label) => {
1713                    visit_opt!(vis, visit_label, opt_label);
1714                    try_visit!(vis.visit_expr(subexpression));
1715                    try_visit!(vis.visit_block(block));
1716                }
1717                ExprKind::ForLoop { pat, iter, body, label, kind: _ } => {
1718                    visit_opt!(vis, visit_label, label);
1719                    try_visit!(vis.visit_pat(pat));
1720                    try_visit!(vis.visit_expr(iter));
1721                    try_visit!(vis.visit_block(body));
1722                }
1723                ExprKind::Loop(block, opt_label, span) => {
1724                    visit_opt!(vis, visit_label, opt_label);
1725                    try_visit!(vis.visit_block(block));
1726                    try_visit!(visit_span(vis, span))
1727                }
1728                ExprKind::Match(subexpression, arms, _kind) => {
1729                    try_visit!(vis.visit_expr(subexpression));
1730                    try_visit!(visit_arms(vis, arms));
1731                }
1732                ExprKind::Closure(box Closure {
1733                    binder,
1734                    capture_clause,
1735                    coroutine_kind,
1736                    constness,
1737                    movability: _,
1738                    fn_decl,
1739                    body,
1740                    fn_decl_span,
1741                    fn_arg_span,
1742                }) => {
1743                    try_visit!(visit_constness(vis, constness));
1744                    try_visit!(vis.visit_capture_by(capture_clause));
1745                    try_visit!(vis.visit_fn(
1746                        FnKind::Closure(binder, coroutine_kind, fn_decl, body),
1747                        *span,
1748                        *id
1749                    ));
1750                    try_visit!(visit_span(vis, fn_decl_span));
1751                    try_visit!(visit_span(vis, fn_arg_span));
1752                }
1753                ExprKind::Block(block, opt_label) => {
1754                    visit_opt!(vis, visit_label, opt_label);
1755                    try_visit!(vis.visit_block(block));
1756                }
1757                ExprKind::Gen(capture_clause, body, _kind, decl_span) => {
1758                    try_visit!(vis.visit_capture_by(capture_clause));
1759                    try_visit!(vis.visit_block(body));
1760                    try_visit!(visit_span(vis, decl_span));
1761                }
1762                ExprKind::Await(expr, span) => {
1763                    try_visit!(vis.visit_expr(expr));
1764                    try_visit!(visit_span(vis, span));
1765                }
1766                ExprKind::Use(expr, span) => {
1767                    try_visit!(vis.visit_expr(expr));
1768                    try_visit!(visit_span(vis, span));
1769                }
1770                ExprKind::Assign(lhs, rhs, span) => {
1771                    try_visit!(vis.visit_expr(lhs));
1772                    try_visit!(vis.visit_expr(rhs));
1773                    try_visit!(visit_span(vis, span));
1774                }
1775                ExprKind::AssignOp(Spanned { span, node: _ }, left_expression, right_expression) => {
1776                    try_visit!(vis.visit_expr(left_expression));
1777                    try_visit!(vis.visit_expr(right_expression));
1778                    try_visit!(visit_span(vis, span));
1779                }
1780                ExprKind::Field(subexpression, ident) => {
1781                    try_visit!(vis.visit_expr(subexpression));
1782                    try_visit!(vis.visit_ident(ident));
1783                }
1784                ExprKind::Index(main_expression, index_expression, span) => {
1785                    try_visit!(vis.visit_expr(main_expression));
1786                    try_visit!(vis.visit_expr(index_expression));
1787                    try_visit!(visit_span(vis, span));
1788                }
1789                ExprKind::Range(start, end, _limit) => {
1790                    visit_opt!(vis, visit_expr, start);
1791                    visit_opt!(vis, visit_expr, end);
1792                }
1793                ExprKind::Underscore => {}
1794                ExprKind::Path(maybe_qself, path) => {
1795                    try_visit!(vis.visit_qself(maybe_qself));
1796                    try_visit!(vis.visit_path(path));
1797                }
1798                ExprKind::Break(opt_label, opt_expr) => {
1799                    visit_opt!(vis, visit_label, opt_label);
1800                    visit_opt!(vis, visit_expr, opt_expr);
1801                }
1802                ExprKind::Continue(opt_label) => {
1803                    visit_opt!(vis, visit_label, opt_label);
1804                }
1805                ExprKind::Ret(optional_expression) => {
1806                    visit_opt!(vis, visit_expr, optional_expression);
1807                }
1808                ExprKind::Yeet(optional_expression) => {
1809                    visit_opt!(vis, visit_expr, optional_expression);
1810                }
1811                ExprKind::Become(expr) => try_visit!(vis.visit_expr(expr)),
1812                ExprKind::MacCall(mac) => try_visit!(vis.visit_mac_call(mac)),
1813                ExprKind::Paren(subexpression) => try_visit!(vis.visit_expr(subexpression)),
1814                ExprKind::InlineAsm(asm) => try_visit!(vis.visit_inline_asm(asm)),
1815                ExprKind::FormatArgs(f) => try_visit!(vis.visit_format_args(f)),
1816                ExprKind::OffsetOf(container, fields) => {
1817                    try_visit!(vis.visit_ty(container));
1818                    walk_list!(vis, visit_ident, fields);
1819                }
1820                ExprKind::Yield(kind) => {
1821                    match kind {
1822                        YieldKind::Postfix(expr) => {
1823                            try_visit!(vis.visit_expr(expr));
1824                        }
1825                        YieldKind::Prefix(expr) => {
1826                            visit_opt!(vis, visit_expr, expr);
1827                        }
1828                    }
1829                }
1830                ExprKind::Try(subexpression) => try_visit!(vis.visit_expr(subexpression)),
1831                ExprKind::TryBlock(body) => try_visit!(vis.visit_block(body)),
1832                ExprKind::Lit(_token) => {}
1833                ExprKind::IncludedBytes(_bytes) => {}
1834                ExprKind::UnsafeBinderCast(_kind, expr, ty) => {
1835                    try_visit!(vis.visit_expr(expr));
1836                    visit_opt!(vis, visit_ty, ty);
1837                }
1838                ExprKind::Err(_guar) => {}
1839                ExprKind::Dummy => {}
1840            }
1841
1842            visit_span(vis, span)
1843        }
1844
1845        pub fn walk_param<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, param: &$($lt)? $($mut)? Param) -> V::Result {
1846            let Param { attrs, ty, pat, id, span, is_placeholder: _ } = param;
1847            try_visit!(visit_id(vis, id));
1848            walk_list!(vis, visit_attribute, attrs);
1849            try_visit!(vis.visit_pat(pat));
1850            try_visit!(vis.visit_ty(ty));
1851            visit_span(vis, span)
1852        }
1853
1854        pub fn walk_arm<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, arm: &$($lt)? $($mut)? Arm) -> V::Result {
1855            let Arm { attrs, pat, guard, body, span, id, is_placeholder: _ } = arm;
1856            try_visit!(visit_id(vis, id));
1857            walk_list!(vis, visit_attribute, attrs);
1858            try_visit!(vis.visit_pat(pat));
1859            visit_opt!(vis, visit_expr, guard);
1860            visit_opt!(vis, visit_expr, body);
1861            visit_span(vis, span)
1862        }
1863
1864        pub fn walk_vis<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, visibility: &$($lt)? $($mut)? Visibility) -> V::Result {
1865            let Visibility { kind, span, tokens: _ } = visibility;
1866            match kind {
1867                VisibilityKind::Restricted { path, id, shorthand: _ } => {
1868                    try_visit!(visit_id(vis, id));
1869                    try_visit!(vis.visit_path(path));
1870                }
1871                VisibilityKind::Public | VisibilityKind::Inherited => {}
1872            }
1873            visit_span(vis, span)
1874        }
1875
1876        pub fn walk_attribute<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, attr: &$($lt)? $($mut)? Attribute) -> V::Result {
1877            let Attribute { kind, id: _, style: _, span } = attr;
1878            match kind {
1879                AttrKind::Normal(normal) => {
1880                    let NormalAttr { item, tokens: _ } = &$($mut)?**normal;
1881                    let AttrItem { unsafety: _, path, args, tokens: _ } = item;
1882                    try_visit!(vis.visit_path(path));
1883                    try_visit!(walk_attr_args(vis, args));
1884                }
1885                AttrKind::DocComment(_kind, _sym) => {}
1886            }
1887            visit_span(vis, span)
1888        }
1889
1890        pub fn walk_attr_args<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, args: &$($lt)? $($mut)? AttrArgs) -> V::Result {
1891            match args {
1892                AttrArgs::Empty => {}
1893                AttrArgs::Delimited(args) => try_visit!(visit_delim_args(vis, args)),
1894                AttrArgs::Eq { eq_span, expr } => {
1895                    try_visit!(vis.visit_expr(expr));
1896                    try_visit!(visit_span(vis, eq_span));
1897                }
1898            }
1899            V::Result::output()
1900        }
1901    };
1902}
1903
1904common_visitor_and_walkers!(Visitor<'a>);
1905
1906macro_rules! generate_list_visit_fns {
1907    ($($name:ident, $Ty:ty, $visit_fn:ident$(, $param:ident: $ParamTy:ty)*;)+) => {
1908        $(
1909            fn $name<'a, V: Visitor<'a>>(
1910                vis: &mut V,
1911                values: &'a ThinVec<$Ty>,
1912                $(
1913                    $param: $ParamTy,
1914                )*
1915            ) -> V::Result {
1916                walk_list!(vis, $visit_fn, values$(,$param)*);
1917                V::Result::output()
1918            }
1919        )+
1920    }
1921}
1922
1923generate_list_visit_fns! {
1924    visit_items, P<Item>, visit_item;
1925    visit_foreign_items, P<ForeignItem>, visit_foreign_item;
1926    visit_generic_params, GenericParam, visit_generic_param;
1927    visit_stmts, Stmt, visit_stmt;
1928    visit_exprs, P<Expr>, visit_expr;
1929    visit_expr_fields, ExprField, visit_expr_field;
1930    visit_pat_fields, PatField, visit_pat_field;
1931    visit_variants, Variant, visit_variant;
1932    visit_assoc_items, P<AssocItem>, visit_assoc_item, ctxt: AssocCtxt;
1933    visit_where_predicates, WherePredicate, visit_where_predicate;
1934    visit_params, Param, visit_param;
1935    visit_field_defs, FieldDef, visit_field_def;
1936    visit_arms, Arm, visit_arm;
1937}
1938
1939#[expect(rustc::pass_by_value)] // needed for symmetry with mut_visit
1940fn visit_nested_use_tree<'a, V: Visitor<'a>>(
1941    vis: &mut V,
1942    nested_tree: &'a UseTree,
1943    &nested_id: &NodeId,
1944) -> V::Result {
1945    vis.visit_nested_use_tree(nested_tree, nested_id)
1946}
1947
1948pub fn walk_stmt<'a, V: Visitor<'a>>(visitor: &mut V, statement: &'a Stmt) -> V::Result {
1949    let Stmt { id, kind, span: _ } = statement;
1950    try_visit!(visit_id(visitor, id));
1951    match kind {
1952        StmtKind::Let(local) => try_visit!(visitor.visit_local(local)),
1953        StmtKind::Item(item) => try_visit!(visitor.visit_item(item)),
1954        StmtKind::Expr(expr) | StmtKind::Semi(expr) => try_visit!(visitor.visit_expr(expr)),
1955        StmtKind::Empty => {}
1956        StmtKind::MacCall(mac) => {
1957            let MacCallStmt { mac, attrs, style: _, tokens: _ } = &**mac;
1958            walk_list!(visitor, visit_attribute, attrs);
1959            try_visit!(visitor.visit_mac_call(mac));
1960        }
1961    }
1962    V::Result::output()
1963}