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 { constness, safety, is_auto: _, ident, generics, bounds, items }) => {
742                        try_visit!(visit_constness(vis, constness));
743                        try_visit!(visit_safety(vis, safety));
744                        try_visit!(vis.visit_ident(ident));
745                        try_visit!(vis.visit_generics(generics));
746                        try_visit!(visit_bounds(vis, bounds, BoundKind::Bound));
747                        visit_assoc_items(vis, items, AssocCtxt::Trait)
748                    }
749                    ItemKind::TraitAlias(ident, generics, bounds) => {
750                        try_visit!(vis.visit_ident(ident));
751                        try_visit!(vis.visit_generics(generics));
752                        visit_bounds(vis, bounds, BoundKind::Bound)
753                    }
754                    ItemKind::MacCall(m) => vis.visit_mac_call(m),
755                    ItemKind::MacroDef(ident, def) => {
756                        try_visit!(vis.visit_ident(ident));
757                        vis.visit_macro_def(def)
758                    }
759                    ItemKind::Delegation(box Delegation {
760                        id,
761                        qself,
762                        path,
763                        ident,
764                        rename,
765                        body,
766                        from_glob: _,
767                    }) => {
768                        try_visit!(visit_id(vis, id));
769                        try_visit!(vis.visit_qself(qself));
770                        try_visit!(vis.visit_path(path));
771                        try_visit!(vis.visit_ident(ident));
772                        visit_opt!(vis, visit_ident, rename);
773                        visit_opt!(vis, visit_block, body);
774                        V::Result::output()
775                    }
776                    ItemKind::DelegationMac(box DelegationMac { qself, prefix, suffixes, body }) => {
777                        try_visit!(vis.visit_qself(qself));
778                        try_visit!(vis.visit_path(prefix));
779                        if let Some(suffixes) = suffixes {
780                            for (ident, rename) in suffixes {
781                                try_visit!(vis.visit_ident(ident));
782                                visit_opt!(vis, visit_ident, rename);
783                            }
784                        }
785                        visit_opt!(vis, visit_block, body);
786                        V::Result::output()
787                    }
788                }
789            }
790        }
791
792        fn walk_const_item<$($lt,)? V: $Visitor$(<$lt>)?>(
793            vis: &mut V,
794            item: &$($lt)? $($mut)? ConstItem,
795        ) -> V::Result {
796            let ConstItem { defaultness, ident, generics, ty, expr, define_opaque } = item;
797            try_visit!(visit_defaultness(vis, defaultness));
798            try_visit!(vis.visit_ident(ident));
799            try_visit!(vis.visit_generics(generics));
800            try_visit!(vis.visit_ty(ty));
801            visit_opt!(vis, visit_expr, expr);
802            walk_define_opaques(vis, define_opaque)
803        }
804
805        fn walk_foreign_mod<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, foreign_mod: &$($lt)? $($mut)? ForeignMod) -> V::Result {
806            let ForeignMod { extern_span: _, safety, abi: _, items } = foreign_mod;
807            try_visit!(visit_safety(vis, safety));
808            visit_foreign_items(vis, items)
809        }
810
811        fn walk_define_opaques<$($lt,)? V: $Visitor$(<$lt>)?>(
812            visitor: &mut V,
813            define_opaque: &$($lt)? $($mut)? Option<ThinVec<(NodeId, Path)>>,
814        ) -> V::Result {
815            if let Some(define_opaque) = define_opaque {
816                for (id, path) in define_opaque {
817                    try_visit!(visit_id(visitor, id));
818                    try_visit!(visitor.visit_path(path));
819                }
820            }
821            V::Result::output()
822        }
823
824        impl WalkItemKind for AssocItemKind {
825            type Ctxt = AssocCtxt;
826            fn walk<$($lt,)? V: $Visitor$(<$lt>)?>(
827                &$($lt)? $($mut)? self,
828                span: Span,
829                id: NodeId,
830                visibility: &$($lt)? $($mut)? Visibility,
831                ctxt: Self::Ctxt,
832                vis: &mut V,
833            ) -> V::Result {
834                match self {
835                    AssocItemKind::Const(item) => {
836                        walk_const_item(vis, item)
837                    }
838                    AssocItemKind::Fn(func) => {
839                        vis.visit_fn(FnKind::Fn(FnCtxt::Assoc(ctxt), visibility, &$($mut)? *func), span, id)
840                    }
841                    AssocItemKind::Type(box TyAlias {
842                        generics,
843                        ident,
844                        bounds,
845                        ty,
846                        defaultness,
847                        $(${ignore($lt)} #[expect(unused)])?
848                        where_clauses,
849                    }) => {
850                        try_visit!(visit_defaultness(vis, defaultness));
851                        try_visit!(vis.visit_ident(ident));
852                        try_visit!(vis.visit_generics(generics));
853                        try_visit!(visit_bounds(vis, bounds, BoundKind::Bound));
854                        visit_opt!(vis, visit_ty, ty);
855                        $(${ignore($mut)}
856                            walk_ty_alias_where_clauses(vis, where_clauses);
857                        )?
858                        V::Result::output()
859                    }
860                    AssocItemKind::MacCall(mac) => {
861                        vis.visit_mac_call(mac)
862                    }
863                    AssocItemKind::Delegation(box Delegation {
864                        id,
865                        qself,
866                        path,
867                        ident,
868                        rename,
869                        body,
870                        from_glob: _,
871                    }) => {
872                        try_visit!(visit_id(vis, id));
873                        try_visit!(vis.visit_qself(qself));
874                        try_visit!(vis.visit_path(path));
875                        try_visit!(vis.visit_ident(ident));
876                        visit_opt!(vis, visit_ident, rename);
877                        visit_opt!(vis, visit_block, body);
878                        V::Result::output()
879                    }
880                    AssocItemKind::DelegationMac(box DelegationMac { qself, prefix, suffixes, body }) => {
881                        try_visit!(vis.visit_qself(qself));
882                        try_visit!(vis.visit_path(prefix));
883                        if let Some(suffixes) = suffixes {
884                            for (ident, rename) in suffixes {
885                                try_visit!(vis.visit_ident(ident));
886                                visit_opt!(vis, visit_ident, rename);
887                            }
888                        }
889                        visit_opt!(vis, visit_block, body);
890                        V::Result::output()
891                    }
892                }
893            }
894        }
895
896        impl WalkItemKind for ForeignItemKind {
897            type Ctxt = ();
898            fn walk<$($lt,)? V: $Visitor$(<$lt>)?>(
899                &$($lt)? $($mut)? self,
900                span: Span,
901                id: NodeId,
902                visibility: &$($lt)? $($mut)? Visibility,
903                _ctxt: Self::Ctxt,
904                vis: &mut V,
905            ) -> V::Result {
906                match self {
907                    ForeignItemKind::Static(box StaticItem {
908                        ident,
909                        ty,
910                        mutability: _,
911                        expr,
912                        safety: _,
913                        define_opaque,
914                    }) => {
915                        try_visit!(vis.visit_ident(ident));
916                        try_visit!(vis.visit_ty(ty));
917                        visit_opt!(vis, visit_expr, expr);
918                        walk_define_opaques(vis, define_opaque)
919                    }
920                    ForeignItemKind::Fn(func) => {
921                        vis.visit_fn(FnKind::Fn(FnCtxt::Foreign, visibility, &$($mut)?*func), span, id)
922                    }
923                    ForeignItemKind::TyAlias(box TyAlias {
924                        defaultness,
925                        ident,
926                        generics,
927                        bounds,
928                        ty,
929                        $(${ignore($lt)} #[expect(unused)])?
930                        where_clauses,
931                    }) => {
932                        try_visit!(visit_defaultness(vis, defaultness));
933                        try_visit!(vis.visit_ident(ident));
934                        try_visit!(vis.visit_generics(generics));
935                        try_visit!(visit_bounds(vis, bounds, BoundKind::Bound));
936                        visit_opt!(vis, visit_ty, ty);
937                        $(${ignore($mut)}
938                            walk_ty_alias_where_clauses(vis, where_clauses);
939                        )?
940                        V::Result::output()
941                    }
942                    ForeignItemKind::MacCall(mac) => {
943                        vis.visit_mac_call(mac)
944                    }
945                }
946            }
947        }
948
949        fn walk_coroutine_kind<$($lt,)? V: $Visitor$(<$lt>)?>(
950            vis: &mut V,
951            coroutine_kind: &$($lt)? $($mut)? CoroutineKind,
952        ) -> V::Result {
953            let (CoroutineKind::Async { span, closure_id, return_impl_trait_id }
954                | CoroutineKind::Gen { span, closure_id, return_impl_trait_id }
955                | CoroutineKind::AsyncGen { span, closure_id, return_impl_trait_id })
956                = coroutine_kind;
957            try_visit!(visit_id(vis, closure_id));
958            try_visit!(visit_id(vis, return_impl_trait_id));
959            visit_span(vis, span)
960        }
961
962        pub fn walk_pat<$($lt,)? V: $Visitor$(<$lt>)?>(
963            vis: &mut V,
964            pattern: &$($lt)? $($mut)? Pat
965        ) -> V::Result {
966            let Pat { id, kind, span, tokens: _ } = pattern;
967            try_visit!(visit_id(vis, id));
968            match kind {
969                PatKind::Err(_guar) => {}
970                PatKind::Missing | PatKind::Wild | PatKind::Rest | PatKind::Never => {}
971                PatKind::Ident(_bmode, ident, optional_subpattern) => {
972                    try_visit!(vis.visit_ident(ident));
973                    visit_opt!(vis, visit_pat, optional_subpattern);
974                }
975                PatKind::Expr(expression) => try_visit!(vis.visit_expr(expression)),
976                PatKind::TupleStruct(opt_qself, path, elems) => {
977                    try_visit!(vis.visit_qself(opt_qself));
978                    try_visit!(vis.visit_path(path));
979                    walk_list!(vis, visit_pat, elems);
980                }
981                PatKind::Path(opt_qself, path) => {
982                    try_visit!(vis.visit_qself(opt_qself));
983                    try_visit!(vis.visit_path(path))
984                }
985                PatKind::Struct(opt_qself, path, fields, _rest) => {
986                    try_visit!(vis.visit_qself(opt_qself));
987                    try_visit!(vis.visit_path(path));
988                    try_visit!(visit_pat_fields(vis, fields));
989                }
990                PatKind::Box(subpattern) | PatKind::Deref(subpattern) | PatKind::Paren(subpattern) => {
991                    try_visit!(vis.visit_pat(subpattern));
992                }
993                PatKind::Ref(subpattern, _ /*mutbl*/) => {
994                    try_visit!(vis.visit_pat(subpattern));
995                }
996                PatKind::Range(lower_bound, upper_bound, _end) => {
997                    visit_opt!(vis, visit_expr, lower_bound);
998                    visit_opt!(vis, visit_expr, upper_bound);
999                    try_visit!(visit_span(vis, span));
1000                }
1001                PatKind::Guard(subpattern, guard_condition) => {
1002                    try_visit!(vis.visit_pat(subpattern));
1003                    try_visit!(vis.visit_expr(guard_condition));
1004                }
1005                PatKind::Tuple(elems) | PatKind::Slice(elems) | PatKind::Or(elems) => {
1006                    walk_list!(vis, visit_pat, elems);
1007                }
1008                PatKind::MacCall(mac) => try_visit!(vis.visit_mac_call(mac)),
1009            }
1010            visit_span(vis, span)
1011        }
1012
1013        pub fn walk_anon_const<$($lt,)? V: $Visitor$(<$lt>)?>(
1014            vis: &mut V,
1015            constant: &$($lt)? $($mut)? AnonConst,
1016        ) -> V::Result {
1017            let AnonConst { id, value } = constant;
1018            try_visit!(visit_id(vis, id));
1019            vis.visit_expr(value)
1020        }
1021
1022        pub fn walk_path_segment<$($lt,)? V: $Visitor$(<$lt>)?>(
1023            vis: &mut V,
1024            segment: &$($lt)? $($mut)? PathSegment,
1025        ) -> V::Result {
1026            let PathSegment { ident, id, args } = segment;
1027            try_visit!(visit_id(vis, id));
1028            try_visit!(vis.visit_ident(ident));
1029            visit_opt!(vis, visit_generic_args, args);
1030            V::Result::output()
1031        }
1032
1033        pub fn walk_block<$($lt,)? V: $Visitor$(<$lt>)?>(
1034            vis: &mut V,
1035            block: &$($lt)? $($mut)? Block
1036        ) -> V::Result {
1037            let Block { stmts, id, rules: _, span, tokens: _ } = block;
1038            try_visit!(visit_id(vis, id));
1039            try_visit!(visit_stmts(vis, stmts));
1040            visit_span(vis, span)
1041        }
1042
1043
1044        pub fn walk_ty<$($lt,)? V: $Visitor$(<$lt>)?>(
1045            vis: &mut V, ty: &$($lt)? $($mut)? Ty
1046        ) -> V::Result {
1047            let Ty { id, kind, span, tokens: _ } = ty;
1048            try_visit!(visit_id(vis, id));
1049            match kind {
1050                TyKind::Err(_guar) => {}
1051                TyKind::Infer | TyKind::ImplicitSelf | TyKind::Dummy | TyKind::Never | TyKind::CVarArgs => {}
1052                TyKind::Slice(ty) | TyKind::Paren(ty) => try_visit!(vis.visit_ty(ty)),
1053                TyKind::Ptr(MutTy { ty, mutbl: _ }) => try_visit!(vis.visit_ty(ty)),
1054                TyKind::Ref(opt_lifetime, MutTy { ty, mutbl: _ })
1055                | TyKind::PinnedRef(opt_lifetime, MutTy { ty, mutbl: _ }) => {
1056                    // FIXME(fee1-dead) asymmetry
1057                    visit_opt!(vis, visit_lifetime, opt_lifetime$(${ignore($lt)}, LifetimeCtxt::Ref)?);
1058                    try_visit!(vis.visit_ty(ty));
1059                }
1060                TyKind::Tup(tuple_element_types) => {
1061                    walk_list!(vis, visit_ty, tuple_element_types);
1062                }
1063                TyKind::FnPtr(function_declaration) => {
1064                    let FnPtrTy { safety, ext: _, generic_params, decl, decl_span } =
1065                        &$($mut)? **function_declaration;
1066                    try_visit!(visit_safety(vis, safety));
1067                    try_visit!(visit_generic_params(vis, generic_params));
1068                    try_visit!(vis.visit_fn_decl(decl));
1069                    try_visit!(visit_span(vis, decl_span));
1070                }
1071                TyKind::UnsafeBinder(binder) => {
1072                    try_visit!(visit_generic_params(vis, &$($mut)? binder.generic_params));
1073                    try_visit!(vis.visit_ty(&$($mut)? binder.inner_ty));
1074                }
1075                TyKind::Path(maybe_qself, path) => {
1076                    try_visit!(vis.visit_qself(maybe_qself));
1077                    try_visit!(vis.visit_path(path));
1078                }
1079                TyKind::Pat(ty, pat) => {
1080                    try_visit!(vis.visit_ty(ty));
1081                    try_visit!(vis.visit_ty_pat(pat));
1082                }
1083                TyKind::Array(ty, length) => {
1084                    try_visit!(vis.visit_ty(ty));
1085                    try_visit!(vis.visit_anon_const(length));
1086                }
1087                TyKind::TraitObject(bounds, _syntax) => {
1088                    walk_list!(vis, visit_param_bound, bounds, BoundKind::TraitObject);
1089                }
1090                TyKind::ImplTrait(id, bounds) => {
1091                    try_visit!(visit_id(vis, id));
1092                    walk_list!(vis, visit_param_bound, bounds, BoundKind::Impl);
1093                }
1094                TyKind::Typeof(expression) => try_visit!(vis.visit_anon_const(expression)),
1095
1096                TyKind::MacCall(mac) => try_visit!(vis.visit_mac_call(mac)),
1097            }
1098            visit_span(vis, span)
1099        }
1100
1101        pub fn walk_crate<$($lt,)? V: $Visitor$(<$lt>)?>(
1102            vis: &mut V,
1103            krate: &$($lt)? $($mut)? Crate,
1104        ) -> V::Result {
1105            let Crate { attrs, items, spans, id, is_placeholder: _ } = krate;
1106            try_visit!(visit_id(vis, id));
1107            walk_list!(vis, visit_attribute, attrs);
1108            try_visit!(visit_items(vis, items));
1109            let ModSpans { inner_span, inject_use_span } = spans;
1110            try_visit!(visit_span(vis, inner_span));
1111            visit_span(vis, inject_use_span)
1112        }
1113
1114        pub fn walk_local<$($lt,)? V: $Visitor$(<$lt>)?>(
1115            vis: &mut V,
1116            local: &$($lt)? $($mut)? Local,
1117        ) -> V::Result {
1118            let Local { id, super_, pat, ty, kind, span, colon_sp, attrs, tokens: _ } = local;
1119            if let Some(sp) = super_ {
1120                try_visit!(visit_span(vis, sp));
1121            }
1122            try_visit!(visit_id(vis, id));
1123            walk_list!(vis, visit_attribute, attrs);
1124            try_visit!(vis.visit_pat(pat));
1125            visit_opt!(vis, visit_ty, ty);
1126            match kind {
1127                LocalKind::Decl => {}
1128                LocalKind::Init(init) => {
1129                    try_visit!(vis.visit_expr(init))
1130                }
1131                LocalKind::InitElse(init, els) => {
1132                    try_visit!(vis.visit_expr(init));
1133                    try_visit!(vis.visit_block(els));
1134                }
1135            }
1136            if let Some(sp) = colon_sp {
1137                try_visit!(visit_span(vis, sp));
1138            }
1139            visit_span(vis, span)
1140        }
1141
1142        pub fn walk_poly_trait_ref<$($lt,)? V: $Visitor$(<$lt>)?>(
1143            vis: &mut V,
1144            p: &$($lt)? $($mut)? PolyTraitRef,
1145        ) -> V::Result {
1146            let PolyTraitRef { bound_generic_params, modifiers, trait_ref, span, parens: _ } = p;
1147            try_visit!(visit_modifiers(vis, modifiers));
1148            try_visit!(visit_generic_params(vis, bound_generic_params));
1149            try_visit!(vis.visit_trait_ref(trait_ref));
1150            visit_span(vis, span)
1151        }
1152
1153        pub fn walk_trait_ref<$($lt,)? V: $Visitor$(<$lt>)?>(
1154            vis: &mut V,
1155            TraitRef { path, ref_id }: &$($lt)? $($mut)? TraitRef,
1156        ) -> V::Result {
1157            try_visit!(vis.visit_path(path));
1158            visit_id(vis, ref_id)
1159        }
1160
1161        pub fn walk_variant<$($lt,)? V: $Visitor$(<$lt>)?>(
1162            vis: &mut V,
1163            variant: &$($lt)? $($mut)? Variant,
1164        ) -> V::Result {
1165            let Variant { attrs, id, span, vis: visibility, ident, data, disr_expr, is_placeholder: _ } = variant;
1166            try_visit!(visit_id(vis, id));
1167            walk_list!(vis, visit_attribute, attrs);
1168            try_visit!(vis.visit_vis(visibility));
1169            try_visit!(vis.visit_ident(ident));
1170            try_visit!(vis.visit_variant_data(data));
1171            visit_opt!(vis, visit_anon_const, disr_expr);
1172            visit_span(vis, span)
1173        }
1174
1175        pub fn walk_expr_field<$($lt,)? V: $Visitor$(<$lt>)?>(
1176            vis: &mut V,
1177            f: &$($lt)? $($mut)? ExprField,
1178        ) -> V::Result {
1179            let ExprField { attrs, id, span, ident, expr, is_shorthand: _, is_placeholder: _ } = f;
1180            try_visit!(visit_id(vis, id));
1181            walk_list!(vis, visit_attribute, attrs);
1182            try_visit!(vis.visit_ident(ident));
1183            try_visit!(vis.visit_expr(expr));
1184            visit_span(vis, span)
1185        }
1186
1187        pub fn walk_pat_field<$($lt,)? V: $Visitor$(<$lt>)?>(
1188            vis: &mut V,
1189            fp: &$($lt)? $($mut)? PatField,
1190        ) -> V::Result {
1191            let PatField { ident, pat, is_shorthand: _, attrs, id, span, is_placeholder: _ } = fp;
1192            try_visit!(visit_id(vis, id));
1193            walk_list!(vis, visit_attribute, attrs);
1194            try_visit!(vis.visit_ident(ident));
1195            try_visit!(vis.visit_pat(pat));
1196            visit_span(vis, span)
1197        }
1198
1199        pub fn walk_ty_pat<$($lt,)? V: $Visitor$(<$lt>)?>(
1200            vis: &mut V,
1201            tp: &$($lt)? $($mut)? TyPat,
1202        ) -> V::Result {
1203            let TyPat { id, kind, span, tokens: _ } = tp;
1204            try_visit!(visit_id(vis, id));
1205            match kind {
1206                TyPatKind::Range(start, end, Spanned { span, node: _include_end }) => {
1207                    visit_opt!(vis, visit_anon_const, start);
1208                    visit_opt!(vis, visit_anon_const, end);
1209                    try_visit!(visit_span(vis, span));
1210                }
1211                TyPatKind::Or(variants) => walk_list!(vis, visit_ty_pat, variants),
1212                TyPatKind::Err(_) => {}
1213            }
1214            visit_span(vis, span)
1215        }
1216
1217        fn walk_qself<$($lt,)? V: $Visitor$(<$lt>)?>(
1218            vis: &mut V,
1219            qself: &$($lt)? $($mut)? Option<P<QSelf>>,
1220        ) -> V::Result {
1221            if let Some(qself) = qself {
1222                let QSelf { ty, path_span, position: _ } = &$($mut)? **qself;
1223                try_visit!(vis.visit_ty(ty));
1224                try_visit!(visit_span(vis, path_span));
1225            }
1226            V::Result::output()
1227        }
1228
1229        pub fn walk_path<$($lt,)? V: $Visitor$(<$lt>)?>(
1230            vis: &mut V,
1231            path: &$($lt)? $($mut)? Path,
1232        ) -> V::Result {
1233            let Path { span, segments, tokens: _ } = path;
1234            walk_list!(vis, visit_path_segment, segments);
1235            visit_span(vis, span)
1236        }
1237
1238        pub fn walk_use_tree<$($lt,)? V: $Visitor$(<$lt>)?>(
1239            vis: &mut V,
1240            use_tree: &$($lt)? $($mut)? UseTree,
1241        ) -> V::Result {
1242            let UseTree { prefix, kind, span } = use_tree;
1243            try_visit!(vis.visit_path(prefix));
1244            match kind {
1245                UseTreeKind::Simple(rename) => {
1246                    // The extra IDs are handled during AST lowering.
1247                    visit_opt!(vis, visit_ident, rename);
1248                }
1249                UseTreeKind::Glob => {}
1250                UseTreeKind::Nested { items, span } => {
1251                    for (nested_tree, nested_id) in items {
1252                        try_visit!(visit_nested_use_tree(vis, nested_tree, nested_id));
1253                    }
1254                    try_visit!(visit_span(vis, span));
1255                }
1256            }
1257            visit_span(vis, span)
1258        }
1259
1260        pub fn walk_generic_args<$($lt,)? V: $Visitor$(<$lt>)?>(
1261            vis: &mut V,
1262            generic_args: &$($lt)? $($mut)? GenericArgs
1263        ) -> V::Result {
1264            match generic_args {
1265                GenericArgs::AngleBracketed(AngleBracketedArgs { span, args }) => {
1266                    for arg in args {
1267                        match arg {
1268                            AngleBracketedArg::Arg(a) => try_visit!(vis.visit_generic_arg(a)),
1269                            AngleBracketedArg::Constraint(c) => {
1270                                try_visit!(vis.visit_assoc_item_constraint(c))
1271                            }
1272                        }
1273                    }
1274                    visit_span(vis, span)
1275                }
1276                GenericArgs::Parenthesized(data) => {
1277                    let ParenthesizedArgs { span, inputs, inputs_span, output } = data;
1278                    walk_list!(vis, visit_ty, inputs);
1279                    try_visit!(vis.visit_fn_ret_ty(output));
1280                    try_visit!(visit_span(vis, span));
1281                    visit_span(vis, inputs_span)
1282                }
1283                GenericArgs::ParenthesizedElided(span) => visit_span(vis, span)
1284            }
1285        }
1286
1287        pub fn walk_generic_arg<$($lt,)? V: $Visitor$(<$lt>)?>(
1288            vis: &mut V,
1289            generic_arg: &$($lt)? $($mut)? GenericArg,
1290        ) -> V::Result {
1291            match generic_arg {
1292                GenericArg::Lifetime(lt) => vis.visit_lifetime(lt, $(${ignore($lt)} LifetimeCtxt::GenericArg)? ),
1293                GenericArg::Type(ty) => vis.visit_ty(ty),
1294                GenericArg::Const(ct) => vis.visit_anon_const(ct),
1295            }
1296        }
1297
1298        pub fn walk_assoc_item_constraint<$($lt,)? V: $Visitor$(<$lt>)?>(
1299            vis: &mut V,
1300            constraint: &$($lt)? $($mut)? AssocItemConstraint,
1301        ) -> V::Result {
1302            let AssocItemConstraint { id, ident, gen_args, kind, span } = constraint;
1303            try_visit!(visit_id(vis, id));
1304            try_visit!(vis.visit_ident(ident));
1305            visit_opt!(vis, visit_generic_args, gen_args);
1306            match kind {
1307                AssocItemConstraintKind::Equality { term } => match term {
1308                    Term::Ty(ty) => try_visit!(vis.visit_ty(ty)),
1309                    Term::Const(c) => try_visit!(vis.visit_anon_const(c)),
1310                },
1311                AssocItemConstraintKind::Bound { bounds } => {
1312                    try_visit!(visit_bounds(vis, bounds, BoundKind::Bound));
1313                }
1314            }
1315            visit_span(vis, span)
1316        }
1317
1318        pub fn walk_param_bound<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, bound: &$($lt)? $($mut)? GenericBound) -> V::Result {
1319            match bound {
1320                GenericBound::Trait(trait_ref) => vis.visit_poly_trait_ref(trait_ref),
1321                GenericBound::Outlives(lifetime) => vis.visit_lifetime(lifetime, $(${ignore($lt)} LifetimeCtxt::Bound)?),
1322                GenericBound::Use(args, span) => {
1323                    walk_list!(vis, visit_precise_capturing_arg, args);
1324                    visit_span(vis, span)
1325                }
1326            }
1327        }
1328
1329        pub fn walk_precise_capturing_arg<$($lt,)? V: $Visitor$(<$lt>)?>(
1330            vis: &mut V,
1331            arg: &$($lt)? $($mut)? PreciseCapturingArg,
1332        ) -> V::Result {
1333            match arg {
1334                PreciseCapturingArg::Lifetime(lt) => vis.visit_lifetime(lt, $(${ignore($lt)} LifetimeCtxt::GenericArg)?),
1335                PreciseCapturingArg::Arg(path, id) => {
1336                    try_visit!(visit_id(vis, id));
1337                    vis.visit_path(path)
1338                }
1339            }
1340        }
1341
1342        pub fn walk_generic_param<$($lt,)? V: $Visitor$(<$lt>)?>(
1343            vis: &mut V,
1344            param: &$($lt)? $($mut)? GenericParam,
1345        ) -> V::Result {
1346            let GenericParam { id, ident, attrs, bounds, is_placeholder: _, kind, colon_span } =
1347                param;
1348            try_visit!(visit_id(vis, id));
1349            walk_list!(vis, visit_attribute, attrs);
1350            try_visit!(vis.visit_ident(ident));
1351            walk_list!(vis, visit_param_bound, bounds, BoundKind::Bound);
1352            match kind {
1353                GenericParamKind::Lifetime => (),
1354                GenericParamKind::Type { default } => visit_opt!(vis, visit_ty, default),
1355                GenericParamKind::Const { ty, default, span } => {
1356                    try_visit!(vis.visit_ty(ty));
1357                    visit_opt!(vis, visit_anon_const, default);
1358                    try_visit!(visit_span(vis, span));
1359                }
1360            }
1361            if let Some(sp) = colon_span {
1362                try_visit!(visit_span(vis, sp))
1363            }
1364            V::Result::output()
1365        }
1366
1367        pub fn walk_generics<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, generics: &$($lt)? $($mut)? Generics) -> V::Result {
1368            let Generics { params, where_clause, span } = generics;
1369            let WhereClause { has_where_token: _, predicates, span: where_clause_span } = where_clause;
1370            try_visit!(visit_generic_params(vis, params));
1371            try_visit!(visit_where_predicates(vis, predicates));
1372            try_visit!(visit_span(vis, span));
1373            visit_span(vis, where_clause_span)
1374        }
1375
1376        pub fn walk_contract<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, c: &$($lt)? $($mut)? FnContract) -> V::Result {
1377            let FnContract { requires, ensures } = c;
1378            visit_opt!(vis, visit_expr, requires);
1379            visit_opt!(vis, visit_expr, ensures);
1380            V::Result::output()
1381        }
1382
1383        pub fn walk_where_predicate<$($lt,)? V: $Visitor$(<$lt>)?>(
1384            vis: &mut V,
1385            predicate: &$($lt)? $($mut)? WherePredicate,
1386        ) -> V::Result {
1387            let WherePredicate { attrs, kind, id, span, is_placeholder: _ } = predicate;
1388            try_visit!(visit_id(vis, id));
1389            walk_list!(vis, visit_attribute, attrs);
1390            try_visit!(visit_span(vis, span));
1391            vis.visit_where_predicate_kind(kind)
1392        }
1393
1394        pub fn walk_closure_binder<$($lt,)? V: $Visitor$(<$lt>)?>(
1395            vis: &mut V,
1396            binder: &$($lt)? $($mut)? ClosureBinder,
1397        ) -> V::Result {
1398            match binder {
1399                ClosureBinder::NotPresent => {}
1400                ClosureBinder::For { generic_params, span } => {
1401                    try_visit!(visit_generic_params(vis, generic_params));
1402                    try_visit!(visit_span(vis, span));
1403                }
1404            }
1405            V::Result::output()
1406        }
1407
1408        pub fn walk_where_predicate_kind<$($lt,)? V: $Visitor$(<$lt>)?>(
1409            vis: &mut V,
1410            kind: &$($lt)? $($mut)? WherePredicateKind,
1411        ) -> V::Result {
1412            match kind {
1413                WherePredicateKind::BoundPredicate(WhereBoundPredicate {
1414                    bounded_ty,
1415                    bounds,
1416                    bound_generic_params,
1417                }) => {
1418                    try_visit!(visit_generic_params(vis, bound_generic_params));
1419                    try_visit!(vis.visit_ty(bounded_ty));
1420                    walk_list!(vis, visit_param_bound, bounds, BoundKind::Bound);
1421                }
1422                WherePredicateKind::RegionPredicate(WhereRegionPredicate { lifetime, bounds }) => {
1423                    try_visit!(vis.visit_lifetime(lifetime, $(${ignore($lt)} LifetimeCtxt::Bound )?));
1424                    walk_list!(vis, visit_param_bound, bounds, BoundKind::Bound);
1425                }
1426                WherePredicateKind::EqPredicate(WhereEqPredicate { lhs_ty, rhs_ty }) => {
1427                    try_visit!(vis.visit_ty(lhs_ty));
1428                    try_visit!(vis.visit_ty(rhs_ty));
1429                }
1430            }
1431            V::Result::output()
1432        }
1433
1434        pub fn walk_fn_decl<$($lt,)? V: $Visitor$(<$lt>)?>(
1435            vis: &mut V,
1436            FnDecl { inputs, output }: &$($lt)? $($mut)? FnDecl,
1437        ) -> V::Result {
1438            try_visit!(visit_params(vis, inputs));
1439            vis.visit_fn_ret_ty(output)
1440        }
1441
1442        pub fn walk_fn_ret_ty<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, ret_ty: &$($lt)? $($mut)? FnRetTy) -> V::Result {
1443            match ret_ty {
1444                FnRetTy::Default(span) => visit_span(vis, span),
1445                FnRetTy::Ty(output_ty) => vis.visit_ty(output_ty),
1446            }
1447        }
1448
1449        pub fn walk_fn<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, kind: FnKind<$($lt)? $(${ignore($mut)} '_)?>) -> V::Result {
1450            match kind {
1451                FnKind::Fn(
1452                    _ctxt,
1453                    _vis,
1454                    Fn {
1455                        defaultness,
1456                        ident,
1457                        sig: FnSig { header, decl, span },
1458                        generics,
1459                        contract,
1460                        body,
1461                        define_opaque,
1462                    },
1463                ) => {
1464                    // Visibility is visited as a part of the item.
1465                    try_visit!(visit_defaultness(vis, defaultness));
1466                    try_visit!(vis.visit_ident(ident));
1467                    try_visit!(vis.visit_fn_header(header));
1468                    try_visit!(vis.visit_generics(generics));
1469                    try_visit!(vis.visit_fn_decl(decl));
1470                    visit_opt!(vis, visit_contract, contract);
1471                    visit_opt!(vis, visit_block, body);
1472                    try_visit!(visit_span(vis, span));
1473                    walk_define_opaques(vis, define_opaque)
1474                }
1475                FnKind::Closure(binder, coroutine_kind, decl, body) => {
1476                    try_visit!(vis.visit_closure_binder(binder));
1477                    visit_opt!(vis, visit_coroutine_kind, coroutine_kind);
1478                    try_visit!(vis.visit_fn_decl(decl));
1479                    vis.visit_expr(body)
1480                }
1481            }
1482        }
1483
1484        pub fn walk_variant_data<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, data: &$($lt)? $($mut)? VariantData) -> V::Result {
1485            match data {
1486                VariantData::Struct { fields, recovered: _ } => {
1487                    visit_field_defs(vis, fields)
1488                }
1489                VariantData::Tuple(fields, id) => {
1490                    try_visit!(visit_id(vis, id));
1491                    visit_field_defs(vis, fields)
1492                }
1493                VariantData::Unit(id) => visit_id(vis, id),
1494            }
1495        }
1496
1497        pub fn walk_field_def<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, field: &$($lt)? $($mut)? FieldDef) -> V::Result {
1498            let FieldDef { attrs, id, span, vis: visibility, ident, ty, is_placeholder: _, safety: _, default } =
1499                field;
1500            try_visit!(visit_id(vis, id));
1501            walk_list!(vis, visit_attribute, attrs);
1502            try_visit!(vis.visit_vis(visibility));
1503            visit_opt!(vis, visit_ident, ident);
1504            try_visit!(vis.visit_ty(ty));
1505            visit_opt!(vis, visit_anon_const, default);
1506            visit_span(vis, span)
1507        }
1508
1509        fn visit_delim_args<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, args: &$($lt)? $($mut)? DelimArgs) -> V::Result {
1510            let DelimArgs { dspan, delim: _, tokens: _ } = args;
1511            let DelimSpan { open, close } = dspan;
1512            try_visit!(visit_span(vis, open));
1513            visit_span(vis, close)
1514        }
1515
1516        pub fn walk_mac<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, mac: &$($lt)? $($mut)? MacCall) -> V::Result {
1517            let MacCall { path, args } = mac;
1518            try_visit!(vis.visit_path(path));
1519            visit_delim_args(vis, args)
1520        }
1521
1522        fn walk_macro_def<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, macro_def: &$($lt)? $($mut)? MacroDef) -> V::Result {
1523            let MacroDef { body, macro_rules: _ } = macro_def;
1524            visit_delim_args(vis, body)
1525        }
1526
1527        pub fn walk_inline_asm<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, asm: &$($lt)? $($mut)? InlineAsm) -> V::Result {
1528            let InlineAsm {
1529                asm_macro: _,
1530                template,
1531                template_strs,
1532                operands,
1533                clobber_abis,
1534                options: _,
1535                line_spans,
1536            } = asm;
1537            for piece in template {
1538                match piece {
1539                    InlineAsmTemplatePiece::String(_str) => {}
1540                    InlineAsmTemplatePiece::Placeholder { operand_idx: _, modifier: _, span } => {
1541                        try_visit!(visit_span(vis, span));
1542                    }
1543                }
1544            }
1545            for (_s1, _s2, span) in template_strs {
1546                try_visit!(visit_span(vis, span));
1547            }
1548            for (op, span) in operands {
1549                match op {
1550                    InlineAsmOperand::In { expr, reg: _ }
1551                    | InlineAsmOperand::Out { expr: Some(expr), reg: _, late: _ }
1552                    | InlineAsmOperand::InOut { expr, reg: _, late: _ } => {
1553                        try_visit!(vis.visit_expr(expr))
1554                    }
1555                    InlineAsmOperand::Out { expr: None, reg: _, late: _ } => {}
1556                    InlineAsmOperand::SplitInOut { in_expr, out_expr, reg: _, late: _ } => {
1557                        try_visit!(vis.visit_expr(in_expr));
1558                        visit_opt!(vis, visit_expr, out_expr);
1559                    }
1560                    InlineAsmOperand::Const { anon_const } => {
1561                        try_visit!(vis.visit_anon_const(anon_const))
1562                    }
1563                    InlineAsmOperand::Sym { sym } => try_visit!(vis.visit_inline_asm_sym(sym)),
1564                    InlineAsmOperand::Label { block } => try_visit!(vis.visit_block(block)),
1565                }
1566                try_visit!(visit_span(vis, span));
1567            }
1568            for (_s1, span) in clobber_abis {
1569                try_visit!(visit_span(vis, span))
1570            }
1571            for span in line_spans {
1572                try_visit!(visit_span(vis, span))
1573            }
1574            V::Result::output()
1575        }
1576
1577        pub fn walk_inline_asm_sym<$($lt,)? V: $Visitor$(<$lt>)?>(
1578            vis: &mut V,
1579            InlineAsmSym { id, qself, path }: &$($lt)? $($mut)? InlineAsmSym,
1580        ) -> V::Result {
1581            try_visit!(visit_id(vis, id));
1582            try_visit!(vis.visit_qself(qself));
1583            vis.visit_path(path)
1584        }
1585
1586        pub fn walk_format_args<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, fmt: &$($lt)? $($mut)? FormatArgs) -> V::Result {
1587            let FormatArgs { span, template, arguments, uncooked_fmt_str: _, is_source_literal: _ } = fmt;
1588
1589            let args = $(${ignore($mut)} arguments.all_args_mut())? $(${ignore($lt)} arguments.all_args())? ;
1590            for FormatArgument { kind, expr } in args {
1591                match kind {
1592                    FormatArgumentKind::Named(ident) | FormatArgumentKind::Captured(ident) => {
1593                        try_visit!(vis.visit_ident(ident))
1594                    }
1595                    FormatArgumentKind::Normal => {}
1596                }
1597                try_visit!(vis.visit_expr(expr));
1598            }
1599            for piece in template {
1600                match piece {
1601                    FormatArgsPiece::Literal(_symbol) => {}
1602                    FormatArgsPiece::Placeholder(placeholder) => try_visit!(walk_format_placeholder(vis, placeholder)),
1603                }
1604            }
1605            visit_span(vis, span)
1606        }
1607
1608        fn walk_format_placeholder<$($lt,)? V: $Visitor$(<$lt>)?>(
1609            vis: &mut V,
1610            placeholder: &$($lt)? $($mut)? FormatPlaceholder,
1611        ) -> V::Result {
1612            let FormatPlaceholder { argument, span, format_options, format_trait: _ } = placeholder;
1613            if let Some(span) = span {
1614                try_visit!(visit_span(vis, span));
1615            }
1616            let FormatArgPosition { span, index: _, kind: _ } = argument;
1617            if let Some(span) = span {
1618                try_visit!(visit_span(vis, span));
1619            }
1620            let FormatOptions {
1621                width,
1622                precision,
1623                alignment: _,
1624                fill: _,
1625                sign: _,
1626                alternate: _,
1627                zero_pad: _,
1628                debug_hex: _,
1629            } = format_options;
1630            match width {
1631                None => {}
1632                Some(FormatCount::Literal(_)) => {}
1633                Some(FormatCount::Argument(FormatArgPosition { span, index: _, kind: _ })) => {
1634                    if let Some(span) = span {
1635                        try_visit!(visit_span(vis, span));
1636                    }
1637                }
1638            }
1639            match precision {
1640                None => {}
1641                Some(FormatCount::Literal(_)) => {}
1642                Some(FormatCount::Argument(FormatArgPosition { span, index: _, kind: _ })) => {
1643                    if let Some(span) = span {
1644                        try_visit!(visit_span(vis, span));
1645                    }
1646                }
1647            }
1648            V::Result::output()
1649        }
1650
1651        pub fn walk_expr<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, expression: &$($lt)? $($mut)? Expr) -> V::Result {
1652            let Expr { id, kind, span, attrs, tokens: _ } = expression;
1653            try_visit!(visit_id(vis, id));
1654            walk_list!(vis, visit_attribute, attrs);
1655            match kind {
1656                ExprKind::Array(exprs) => {
1657                    try_visit!(visit_exprs(vis, exprs));
1658                }
1659                ExprKind::ConstBlock(anon_const) => try_visit!(vis.visit_anon_const(anon_const)),
1660                ExprKind::Repeat(element, count) => {
1661                    try_visit!(vis.visit_expr(element));
1662                    try_visit!(vis.visit_anon_const(count));
1663                }
1664                ExprKind::Struct(se) => {
1665                    let StructExpr { qself, path, fields, rest } = &$($mut)?**se;
1666                    try_visit!(vis.visit_qself(qself));
1667                    try_visit!(vis.visit_path(path));
1668                    try_visit!(visit_expr_fields(vis, fields));
1669                    match rest {
1670                        StructRest::Base(expr) => try_visit!(vis.visit_expr(expr)),
1671                        StructRest::Rest(span) => try_visit!(visit_span(vis, span)),
1672                        StructRest::None => {}
1673                    }
1674                }
1675                ExprKind::Tup(exprs) => {
1676                    try_visit!(visit_exprs(vis, exprs));
1677                }
1678                ExprKind::Call(callee_expression, arguments) => {
1679                    try_visit!(vis.visit_expr(callee_expression));
1680                    try_visit!(visit_exprs(vis, arguments));
1681                }
1682                ExprKind::MethodCall(box MethodCall { seg, receiver, args, span }) => {
1683                    try_visit!(vis.visit_method_receiver_expr(receiver));
1684                    try_visit!(vis.visit_path_segment(seg));
1685                    try_visit!(visit_exprs(vis, args));
1686                    try_visit!(visit_span(vis, span));
1687                }
1688                ExprKind::Binary(Spanned { span, node: _ }, left_expression, right_expression) => {
1689                    try_visit!(vis.visit_expr(left_expression));
1690                    try_visit!(vis.visit_expr(right_expression));
1691                    try_visit!(visit_span(vis, span))
1692                }
1693                ExprKind::AddrOf(_kind, _mutbl, subexpression) => {
1694                    try_visit!(vis.visit_expr(subexpression));
1695                }
1696                ExprKind::Unary(_op, subexpression) => {
1697                    try_visit!(vis.visit_expr(subexpression));
1698                }
1699                ExprKind::Cast(subexpression, typ) | ExprKind::Type(subexpression, typ) => {
1700                    try_visit!(vis.visit_expr(subexpression));
1701                    try_visit!(vis.visit_ty(typ));
1702                }
1703                ExprKind::Let(pat, expr, span, _recovered) => {
1704                    try_visit!(vis.visit_pat(pat));
1705                    try_visit!(vis.visit_expr(expr));
1706                    try_visit!(visit_span(vis, span))
1707                }
1708                ExprKind::If(head_expression, if_block, optional_else) => {
1709                    try_visit!(vis.visit_expr(head_expression));
1710                    try_visit!(vis.visit_block(if_block));
1711                    visit_opt!(vis, visit_expr, optional_else);
1712                }
1713                ExprKind::While(subexpression, block, opt_label) => {
1714                    visit_opt!(vis, visit_label, opt_label);
1715                    try_visit!(vis.visit_expr(subexpression));
1716                    try_visit!(vis.visit_block(block));
1717                }
1718                ExprKind::ForLoop { pat, iter, body, label, kind: _ } => {
1719                    visit_opt!(vis, visit_label, label);
1720                    try_visit!(vis.visit_pat(pat));
1721                    try_visit!(vis.visit_expr(iter));
1722                    try_visit!(vis.visit_block(body));
1723                }
1724                ExprKind::Loop(block, opt_label, span) => {
1725                    visit_opt!(vis, visit_label, opt_label);
1726                    try_visit!(vis.visit_block(block));
1727                    try_visit!(visit_span(vis, span))
1728                }
1729                ExprKind::Match(subexpression, arms, _kind) => {
1730                    try_visit!(vis.visit_expr(subexpression));
1731                    try_visit!(visit_arms(vis, arms));
1732                }
1733                ExprKind::Closure(box Closure {
1734                    binder,
1735                    capture_clause,
1736                    coroutine_kind,
1737                    constness,
1738                    movability: _,
1739                    fn_decl,
1740                    body,
1741                    fn_decl_span,
1742                    fn_arg_span,
1743                }) => {
1744                    try_visit!(visit_constness(vis, constness));
1745                    try_visit!(vis.visit_capture_by(capture_clause));
1746                    try_visit!(vis.visit_fn(
1747                        FnKind::Closure(binder, coroutine_kind, fn_decl, body),
1748                        *span,
1749                        *id
1750                    ));
1751                    try_visit!(visit_span(vis, fn_decl_span));
1752                    try_visit!(visit_span(vis, fn_arg_span));
1753                }
1754                ExprKind::Block(block, opt_label) => {
1755                    visit_opt!(vis, visit_label, opt_label);
1756                    try_visit!(vis.visit_block(block));
1757                }
1758                ExprKind::Gen(capture_clause, body, _kind, decl_span) => {
1759                    try_visit!(vis.visit_capture_by(capture_clause));
1760                    try_visit!(vis.visit_block(body));
1761                    try_visit!(visit_span(vis, decl_span));
1762                }
1763                ExprKind::Await(expr, span) => {
1764                    try_visit!(vis.visit_expr(expr));
1765                    try_visit!(visit_span(vis, span));
1766                }
1767                ExprKind::Use(expr, span) => {
1768                    try_visit!(vis.visit_expr(expr));
1769                    try_visit!(visit_span(vis, span));
1770                }
1771                ExprKind::Assign(lhs, rhs, span) => {
1772                    try_visit!(vis.visit_expr(lhs));
1773                    try_visit!(vis.visit_expr(rhs));
1774                    try_visit!(visit_span(vis, span));
1775                }
1776                ExprKind::AssignOp(Spanned { span, node: _ }, left_expression, right_expression) => {
1777                    try_visit!(vis.visit_expr(left_expression));
1778                    try_visit!(vis.visit_expr(right_expression));
1779                    try_visit!(visit_span(vis, span));
1780                }
1781                ExprKind::Field(subexpression, ident) => {
1782                    try_visit!(vis.visit_expr(subexpression));
1783                    try_visit!(vis.visit_ident(ident));
1784                }
1785                ExprKind::Index(main_expression, index_expression, span) => {
1786                    try_visit!(vis.visit_expr(main_expression));
1787                    try_visit!(vis.visit_expr(index_expression));
1788                    try_visit!(visit_span(vis, span));
1789                }
1790                ExprKind::Range(start, end, _limit) => {
1791                    visit_opt!(vis, visit_expr, start);
1792                    visit_opt!(vis, visit_expr, end);
1793                }
1794                ExprKind::Underscore => {}
1795                ExprKind::Path(maybe_qself, path) => {
1796                    try_visit!(vis.visit_qself(maybe_qself));
1797                    try_visit!(vis.visit_path(path));
1798                }
1799                ExprKind::Break(opt_label, opt_expr) => {
1800                    visit_opt!(vis, visit_label, opt_label);
1801                    visit_opt!(vis, visit_expr, opt_expr);
1802                }
1803                ExprKind::Continue(opt_label) => {
1804                    visit_opt!(vis, visit_label, opt_label);
1805                }
1806                ExprKind::Ret(optional_expression) => {
1807                    visit_opt!(vis, visit_expr, optional_expression);
1808                }
1809                ExprKind::Yeet(optional_expression) => {
1810                    visit_opt!(vis, visit_expr, optional_expression);
1811                }
1812                ExprKind::Become(expr) => try_visit!(vis.visit_expr(expr)),
1813                ExprKind::MacCall(mac) => try_visit!(vis.visit_mac_call(mac)),
1814                ExprKind::Paren(subexpression) => try_visit!(vis.visit_expr(subexpression)),
1815                ExprKind::InlineAsm(asm) => try_visit!(vis.visit_inline_asm(asm)),
1816                ExprKind::FormatArgs(f) => try_visit!(vis.visit_format_args(f)),
1817                ExprKind::OffsetOf(container, fields) => {
1818                    try_visit!(vis.visit_ty(container));
1819                    walk_list!(vis, visit_ident, fields);
1820                }
1821                ExprKind::Yield(kind) => {
1822                    match kind {
1823                        YieldKind::Postfix(expr) => {
1824                            try_visit!(vis.visit_expr(expr));
1825                        }
1826                        YieldKind::Prefix(expr) => {
1827                            visit_opt!(vis, visit_expr, expr);
1828                        }
1829                    }
1830                }
1831                ExprKind::Try(subexpression) => try_visit!(vis.visit_expr(subexpression)),
1832                ExprKind::TryBlock(body) => try_visit!(vis.visit_block(body)),
1833                ExprKind::Lit(_token) => {}
1834                ExprKind::IncludedBytes(_bytes) => {}
1835                ExprKind::UnsafeBinderCast(_kind, expr, ty) => {
1836                    try_visit!(vis.visit_expr(expr));
1837                    visit_opt!(vis, visit_ty, ty);
1838                }
1839                ExprKind::Err(_guar) => {}
1840                ExprKind::Dummy => {}
1841            }
1842
1843            visit_span(vis, span)
1844        }
1845
1846        pub fn walk_param<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, param: &$($lt)? $($mut)? Param) -> V::Result {
1847            let Param { attrs, ty, pat, id, span, is_placeholder: _ } = param;
1848            try_visit!(visit_id(vis, id));
1849            walk_list!(vis, visit_attribute, attrs);
1850            try_visit!(vis.visit_pat(pat));
1851            try_visit!(vis.visit_ty(ty));
1852            visit_span(vis, span)
1853        }
1854
1855        pub fn walk_arm<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, arm: &$($lt)? $($mut)? Arm) -> V::Result {
1856            let Arm { attrs, pat, guard, body, span, id, is_placeholder: _ } = arm;
1857            try_visit!(visit_id(vis, id));
1858            walk_list!(vis, visit_attribute, attrs);
1859            try_visit!(vis.visit_pat(pat));
1860            visit_opt!(vis, visit_expr, guard);
1861            visit_opt!(vis, visit_expr, body);
1862            visit_span(vis, span)
1863        }
1864
1865        pub fn walk_vis<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, visibility: &$($lt)? $($mut)? Visibility) -> V::Result {
1866            let Visibility { kind, span, tokens: _ } = visibility;
1867            match kind {
1868                VisibilityKind::Restricted { path, id, shorthand: _ } => {
1869                    try_visit!(visit_id(vis, id));
1870                    try_visit!(vis.visit_path(path));
1871                }
1872                VisibilityKind::Public | VisibilityKind::Inherited => {}
1873            }
1874            visit_span(vis, span)
1875        }
1876
1877        pub fn walk_attribute<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, attr: &$($lt)? $($mut)? Attribute) -> V::Result {
1878            let Attribute { kind, id: _, style: _, span } = attr;
1879            match kind {
1880                AttrKind::Normal(normal) => {
1881                    let NormalAttr { item, tokens: _ } = &$($mut)?**normal;
1882                    let AttrItem { unsafety: _, path, args, tokens: _ } = item;
1883                    try_visit!(vis.visit_path(path));
1884                    try_visit!(walk_attr_args(vis, args));
1885                }
1886                AttrKind::DocComment(_kind, _sym) => {}
1887            }
1888            visit_span(vis, span)
1889        }
1890
1891        pub fn walk_attr_args<$($lt,)? V: $Visitor$(<$lt>)?>(vis: &mut V, args: &$($lt)? $($mut)? AttrArgs) -> V::Result {
1892            match args {
1893                AttrArgs::Empty => {}
1894                AttrArgs::Delimited(args) => try_visit!(visit_delim_args(vis, args)),
1895                AttrArgs::Eq { eq_span, expr } => {
1896                    try_visit!(vis.visit_expr(expr));
1897                    try_visit!(visit_span(vis, eq_span));
1898                }
1899            }
1900            V::Result::output()
1901        }
1902    };
1903}
1904
1905common_visitor_and_walkers!(Visitor<'a>);
1906
1907macro_rules! generate_list_visit_fns {
1908    ($($name:ident, $Ty:ty, $visit_fn:ident$(, $param:ident: $ParamTy:ty)*;)+) => {
1909        $(
1910            fn $name<'a, V: Visitor<'a>>(
1911                vis: &mut V,
1912                values: &'a ThinVec<$Ty>,
1913                $(
1914                    $param: $ParamTy,
1915                )*
1916            ) -> V::Result {
1917                walk_list!(vis, $visit_fn, values$(,$param)*);
1918                V::Result::output()
1919            }
1920        )+
1921    }
1922}
1923
1924generate_list_visit_fns! {
1925    visit_items, P<Item>, visit_item;
1926    visit_foreign_items, P<ForeignItem>, visit_foreign_item;
1927    visit_generic_params, GenericParam, visit_generic_param;
1928    visit_stmts, Stmt, visit_stmt;
1929    visit_exprs, P<Expr>, visit_expr;
1930    visit_expr_fields, ExprField, visit_expr_field;
1931    visit_pat_fields, PatField, visit_pat_field;
1932    visit_variants, Variant, visit_variant;
1933    visit_assoc_items, P<AssocItem>, visit_assoc_item, ctxt: AssocCtxt;
1934    visit_where_predicates, WherePredicate, visit_where_predicate;
1935    visit_params, Param, visit_param;
1936    visit_field_defs, FieldDef, visit_field_def;
1937    visit_arms, Arm, visit_arm;
1938}
1939
1940#[expect(rustc::pass_by_value)] // needed for symmetry with mut_visit
1941fn visit_nested_use_tree<'a, V: Visitor<'a>>(
1942    vis: &mut V,
1943    nested_tree: &'a UseTree,
1944    &nested_id: &NodeId,
1945) -> V::Result {
1946    vis.visit_nested_use_tree(nested_tree, nested_id)
1947}
1948
1949pub fn walk_stmt<'a, V: Visitor<'a>>(visitor: &mut V, statement: &'a Stmt) -> V::Result {
1950    let Stmt { id, kind, span: _ } = statement;
1951    try_visit!(visit_id(visitor, id));
1952    match kind {
1953        StmtKind::Let(local) => try_visit!(visitor.visit_local(local)),
1954        StmtKind::Item(item) => try_visit!(visitor.visit_item(item)),
1955        StmtKind::Expr(expr) | StmtKind::Semi(expr) => try_visit!(visitor.visit_expr(expr)),
1956        StmtKind::Empty => {}
1957        StmtKind::MacCall(mac) => {
1958            let MacCallStmt { mac, attrs, style: _, tokens: _ } = &**mac;
1959            walk_list!(visitor, visit_attribute, attrs);
1960            try_visit!(visitor.visit_mac_call(mac));
1961        }
1962    }
1963    V::Result::output()
1964}