trait.Visitor.html 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  6. <meta name="generator" content="rustdoc">
  7. <meta name="description" content="API documentation for the Rust `Visitor` trait in crate `syn`.">
  8. <meta name="keywords" content="rust, rustlang, rust-lang, Visitor">
  9. <title>syn::visit::Visitor - Rust</title>
  10. <link rel="stylesheet" type="text/css" href="../../normalize.css">
  11. <link rel="stylesheet" type="text/css" href="../../rustdoc.css" id="mainThemeStyle">
  12. <link rel="stylesheet" type="text/css" href="../../dark.css">
  13. <link rel="stylesheet" type="text/css" href="../../main.css" id="themeStyle">
  14. <script src="../../storage.js"></script>
  15. </head>
  16. <body class="rustdoc trait">
  17. <!--[if lte IE 8]>
  18. <div class="warning">
  19. This old browser is unsupported and will most likely display funky
  20. things.
  21. </div>
  22. <![endif]-->
  23. <nav class="sidebar">
  24. <div class="sidebar-menu">&#9776;</div>
  25. <p class='location'>Trait Visitor</p><div class="sidebar-elems"><div class="block items"><a class="sidebar-title" href="#provided-methods">Provided Methods</a><div class="sidebar-links"><a href="#method.visit_ident">visit_ident</a><a href="#method.visit_derive_input">visit_derive_input</a><a href="#method.visit_ty">visit_ty</a><a href="#method.visit_generics">visit_generics</a><a href="#method.visit_ty_param_bound">visit_ty_param_bound</a><a href="#method.visit_poly_trait_ref">visit_poly_trait_ref</a><a href="#method.visit_variant_data">visit_variant_data</a><a href="#method.visit_field">visit_field</a><a href="#method.visit_variant">visit_variant</a><a href="#method.visit_lifetime">visit_lifetime</a><a href="#method.visit_lifetime_def">visit_lifetime_def</a><a href="#method.visit_path">visit_path</a><a href="#method.visit_path_segment">visit_path_segment</a><a href="#method.visit_path_parameters">visit_path_parameters</a><a href="#method.visit_assoc_type_binding">visit_assoc_type_binding</a><a href="#method.visit_attribute">visit_attribute</a><a href="#method.visit_fn_ret_ty">visit_fn_ret_ty</a><a href="#method.visit_const_expr">visit_const_expr</a><a href="#method.visit_lit">visit_lit</a><a href="#method.visit_mac">visit_mac</a></div><a class="sidebar-title" href="#implementors">Implementors</a></div><p class='location'><a href='../index.html'>syn</a>::<wbr><a href='index.html'>visit</a></p><script>window.sidebarCurrent = {name: 'Visitor', ty: 'trait', relpath: ''};</script><script defer src="sidebar-items.js"></script></div>
  26. </nav>
  27. <div class="theme-picker">
  28. <button id="theme-picker" aria-label="Pick another theme!">
  29. <img src="../../brush.svg" width="18" alt="Pick another theme!">
  30. </button>
  31. <div id="theme-choices"></div>
  32. </div>
  33. <script src="../../theme.js"></script>
  34. <nav class="sub">
  35. <form class="search-form js-only">
  36. <div class="search-container">
  37. <input class="search-input" name="search"
  38. autocomplete="off"
  39. placeholder="Click or press ‘S’ to search, ‘?’ for more options…"
  40. type="search">
  41. </div>
  42. </form>
  43. </nav>
  44. <section id='main' class="content">
  45. <h1 class='fqn'><span class='in-band'>Trait <a href='../index.html'>syn</a>::<wbr><a href='index.html'>visit</a>::<wbr><a class="trait" href=''>Visitor</a></span><span class='out-of-band'><span id='render-detail'>
  46. <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">
  47. [<span class='inner'>&#x2212;</span>]
  48. </a>
  49. </span><a class='srclink' href='../../src/syn/visit.rs.html#29-132' title='goto source code'>[src]</a></span></h1>
  50. <pre class='rust trait'>pub trait Visitor: <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a> {
  51. fn <a href='#method.visit_ident' class='fnname'>visit_ident</a>(&amp;mut self, _ident: &amp;<a class="struct" href="../../syn/struct.Ident.html" title="struct syn::Ident">Ident</a>) { ... }
  52. <div class='item-spacer'></div> fn <a href='#method.visit_derive_input' class='fnname'>visit_derive_input</a>(&amp;mut self, derive_input: &amp;<a class="struct" href="../../syn/struct.DeriveInput.html" title="struct syn::DeriveInput">DeriveInput</a>) { ... }
  53. <div class='item-spacer'></div> fn <a href='#method.visit_ty' class='fnname'>visit_ty</a>(&amp;mut self, ty: &amp;<a class="enum" href="../../syn/enum.Ty.html" title="enum syn::Ty">Ty</a>) { ... }
  54. <div class='item-spacer'></div> fn <a href='#method.visit_generics' class='fnname'>visit_generics</a>(&amp;mut self, generics: &amp;<a class="struct" href="../../syn/struct.Generics.html" title="struct syn::Generics">Generics</a>) { ... }
  55. <div class='item-spacer'></div> fn <a href='#method.visit_ty_param_bound' class='fnname'>visit_ty_param_bound</a>(&amp;mut self, bound: &amp;<a class="enum" href="../../syn/enum.TyParamBound.html" title="enum syn::TyParamBound">TyParamBound</a>) { ... }
  56. <div class='item-spacer'></div> fn <a href='#method.visit_poly_trait_ref' class='fnname'>visit_poly_trait_ref</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&amp;mut self, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;trait_ref: &amp;<a class="struct" href="../../syn/struct.PolyTraitRef.html" title="struct syn::PolyTraitRef">PolyTraitRef</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;modifier: &amp;<a class="enum" href="../../syn/enum.TraitBoundModifier.html" title="enum syn::TraitBoundModifier">TraitBoundModifier</a><br>&nbsp;&nbsp;&nbsp;&nbsp;) { ... }
  57. <div class='item-spacer'></div> fn <a href='#method.visit_variant_data' class='fnname'>visit_variant_data</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&amp;mut self, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;data: &amp;<a class="enum" href="../../syn/enum.VariantData.html" title="enum syn::VariantData">VariantData</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;_ident: &amp;<a class="struct" href="../../syn/struct.Ident.html" title="struct syn::Ident">Ident</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;_generics: &amp;<a class="struct" href="../../syn/struct.Generics.html" title="struct syn::Generics">Generics</a><br>&nbsp;&nbsp;&nbsp;&nbsp;) { ... }
  58. <div class='item-spacer'></div> fn <a href='#method.visit_field' class='fnname'>visit_field</a>(&amp;mut self, field: &amp;<a class="struct" href="../../syn/struct.Field.html" title="struct syn::Field">Field</a>) { ... }
  59. <div class='item-spacer'></div> fn <a href='#method.visit_variant' class='fnname'>visit_variant</a>(&amp;mut self, variant: &amp;<a class="struct" href="../../syn/struct.Variant.html" title="struct syn::Variant">Variant</a>, generics: &amp;<a class="struct" href="../../syn/struct.Generics.html" title="struct syn::Generics">Generics</a>) { ... }
  60. <div class='item-spacer'></div> fn <a href='#method.visit_lifetime' class='fnname'>visit_lifetime</a>(&amp;mut self, _lifetime: &amp;<a class="struct" href="../../syn/struct.Lifetime.html" title="struct syn::Lifetime">Lifetime</a>) { ... }
  61. <div class='item-spacer'></div> fn <a href='#method.visit_lifetime_def' class='fnname'>visit_lifetime_def</a>(&amp;mut self, lifetime: &amp;<a class="struct" href="../../syn/struct.LifetimeDef.html" title="struct syn::LifetimeDef">LifetimeDef</a>) { ... }
  62. <div class='item-spacer'></div> fn <a href='#method.visit_path' class='fnname'>visit_path</a>(&amp;mut self, path: &amp;<a class="struct" href="../../syn/struct.Path.html" title="struct syn::Path">Path</a>) { ... }
  63. <div class='item-spacer'></div> fn <a href='#method.visit_path_segment' class='fnname'>visit_path_segment</a>(&amp;mut self, path_segment: &amp;<a class="struct" href="../../syn/struct.PathSegment.html" title="struct syn::PathSegment">PathSegment</a>) { ... }
  64. <div class='item-spacer'></div> fn <a href='#method.visit_path_parameters' class='fnname'>visit_path_parameters</a>(&amp;mut self, path_parameters: &amp;<a class="enum" href="../../syn/enum.PathParameters.html" title="enum syn::PathParameters">PathParameters</a>) { ... }
  65. <div class='item-spacer'></div> fn <a href='#method.visit_assoc_type_binding' class='fnname'>visit_assoc_type_binding</a>(&amp;mut self, type_binding: &amp;<a class="struct" href="../../syn/struct.TypeBinding.html" title="struct syn::TypeBinding">TypeBinding</a>) { ... }
  66. <div class='item-spacer'></div> fn <a href='#method.visit_attribute' class='fnname'>visit_attribute</a>(&amp;mut self, _attr: &amp;<a class="struct" href="../../syn/struct.Attribute.html" title="struct syn::Attribute">Attribute</a>) { ... }
  67. <div class='item-spacer'></div> fn <a href='#method.visit_fn_ret_ty' class='fnname'>visit_fn_ret_ty</a>(&amp;mut self, ret_ty: &amp;<a class="enum" href="../../syn/enum.FunctionRetTy.html" title="enum syn::FunctionRetTy">FunctionRetTy</a>) { ... }
  68. <div class='item-spacer'></div> fn <a href='#method.visit_const_expr' class='fnname'>visit_const_expr</a>(&amp;mut self, expr: &amp;<a class="enum" href="../../syn/enum.ConstExpr.html" title="enum syn::ConstExpr">ConstExpr</a>) { ... }
  69. <div class='item-spacer'></div> fn <a href='#method.visit_lit' class='fnname'>visit_lit</a>(&amp;mut self, _lit: &amp;<a class="enum" href="../../syn/enum.Lit.html" title="enum syn::Lit">Lit</a>) { ... }
  70. <div class='item-spacer'></div> fn <a href='#method.visit_mac' class='fnname'>visit_mac</a>(&amp;mut self, mac: &amp;<a class="struct" href="../../syn/struct.Mac.html" title="struct syn::Mac">Mac</a>) { ... }
  71. }</pre><div class='docblock'><p>Each method of the Visitor trait is a hook to be potentially
  72. overridden. Each method's default implementation recursively visits
  73. the substructure of the input via the corresponding <code>walk</code> method;
  74. e.g. the <code>visit_mod</code> method by default calls <code>visit::walk_mod</code>.</p>
  75. <p>If you want to ensure that your code handles every variant
  76. explicitly, you need to override each method. (And you also need
  77. to monitor future changes to <code>Visitor</code> in case a new method with a
  78. new default implementation gets introduced.)</p>
  79. </div>
  80. <h2 id='provided-methods' class='small-section-header'>
  81. Provided Methods<a href='#provided-methods' class='anchor'></a>
  82. </h2>
  83. <div class='methods'>
  84. <h3 id='method.visit_ident' class='method'><span id='visit_ident.v' class='invisible'><code>fn <a href='#method.visit_ident' class='fnname'>visit_ident</a>(&amp;mut self, _ident: &amp;<a class="struct" href="../../syn/struct.Ident.html" title="struct syn::Ident">Ident</a>)</code></span></h3><h3 id='method.visit_derive_input' class='method'><span id='visit_derive_input.v' class='invisible'><code>fn <a href='#method.visit_derive_input' class='fnname'>visit_derive_input</a>(&amp;mut self, derive_input: &amp;<a class="struct" href="../../syn/struct.DeriveInput.html" title="struct syn::DeriveInput">DeriveInput</a>)</code></span></h3><h3 id='method.visit_ty' class='method'><span id='visit_ty.v' class='invisible'><code>fn <a href='#method.visit_ty' class='fnname'>visit_ty</a>(&amp;mut self, ty: &amp;<a class="enum" href="../../syn/enum.Ty.html" title="enum syn::Ty">Ty</a>)</code></span></h3><h3 id='method.visit_generics' class='method'><span id='visit_generics.v' class='invisible'><code>fn <a href='#method.visit_generics' class='fnname'>visit_generics</a>(&amp;mut self, generics: &amp;<a class="struct" href="../../syn/struct.Generics.html" title="struct syn::Generics">Generics</a>)</code></span></h3><h3 id='method.visit_ty_param_bound' class='method'><span id='visit_ty_param_bound.v' class='invisible'><code>fn <a href='#method.visit_ty_param_bound' class='fnname'>visit_ty_param_bound</a>(&amp;mut self, bound: &amp;<a class="enum" href="../../syn/enum.TyParamBound.html" title="enum syn::TyParamBound">TyParamBound</a>)</code></span></h3><h3 id='method.visit_poly_trait_ref' class='method'><span id='visit_poly_trait_ref.v' class='invisible'><code>fn <a href='#method.visit_poly_trait_ref' class='fnname'>visit_poly_trait_ref</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&amp;mut self, <br>&nbsp;&nbsp;&nbsp;&nbsp;trait_ref: &amp;<a class="struct" href="../../syn/struct.PolyTraitRef.html" title="struct syn::PolyTraitRef">PolyTraitRef</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;modifier: &amp;<a class="enum" href="../../syn/enum.TraitBoundModifier.html" title="enum syn::TraitBoundModifier">TraitBoundModifier</a><br>)</code></span></h3><h3 id='method.visit_variant_data' class='method'><span id='visit_variant_data.v' class='invisible'><code>fn <a href='#method.visit_variant_data' class='fnname'>visit_variant_data</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&amp;mut self, <br>&nbsp;&nbsp;&nbsp;&nbsp;data: &amp;<a class="enum" href="../../syn/enum.VariantData.html" title="enum syn::VariantData">VariantData</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;_ident: &amp;<a class="struct" href="../../syn/struct.Ident.html" title="struct syn::Ident">Ident</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;_generics: &amp;<a class="struct" href="../../syn/struct.Generics.html" title="struct syn::Generics">Generics</a><br>)</code></span></h3><h3 id='method.visit_field' class='method'><span id='visit_field.v' class='invisible'><code>fn <a href='#method.visit_field' class='fnname'>visit_field</a>(&amp;mut self, field: &amp;<a class="struct" href="../../syn/struct.Field.html" title="struct syn::Field">Field</a>)</code></span></h3><h3 id='method.visit_variant' class='method'><span id='visit_variant.v' class='invisible'><code>fn <a href='#method.visit_variant' class='fnname'>visit_variant</a>(&amp;mut self, variant: &amp;<a class="struct" href="../../syn/struct.Variant.html" title="struct syn::Variant">Variant</a>, generics: &amp;<a class="struct" href="../../syn/struct.Generics.html" title="struct syn::Generics">Generics</a>)</code></span></h3><h3 id='method.visit_lifetime' class='method'><span id='visit_lifetime.v' class='invisible'><code>fn <a href='#method.visit_lifetime' class='fnname'>visit_lifetime</a>(&amp;mut self, _lifetime: &amp;<a class="struct" href="../../syn/struct.Lifetime.html" title="struct syn::Lifetime">Lifetime</a>)</code></span></h3><h3 id='method.visit_lifetime_def' class='method'><span id='visit_lifetime_def.v' class='invisible'><code>fn <a href='#method.visit_lifetime_def' class='fnname'>visit_lifetime_def</a>(&amp;mut self, lifetime: &amp;<a class="struct" href="../../syn/struct.LifetimeDef.html" title="struct syn::LifetimeDef">LifetimeDef</a>)</code></span></h3><h3 id='method.visit_path' class='method'><span id='visit_path.v' class='invisible'><code>fn <a href='#method.visit_path' class='fnname'>visit_path</a>(&amp;mut self, path: &amp;<a class="struct" href="../../syn/struct.Path.html" title="struct syn::Path">Path</a>)</code></span></h3><h3 id='method.visit_path_segment' class='method'><span id='visit_path_segment.v' class='invisible'><code>fn <a href='#method.visit_path_segment' class='fnname'>visit_path_segment</a>(&amp;mut self, path_segment: &amp;<a class="struct" href="../../syn/struct.PathSegment.html" title="struct syn::PathSegment">PathSegment</a>)</code></span></h3><h3 id='method.visit_path_parameters' class='method'><span id='visit_path_parameters.v' class='invisible'><code>fn <a href='#method.visit_path_parameters' class='fnname'>visit_path_parameters</a>(&amp;mut self, path_parameters: &amp;<a class="enum" href="../../syn/enum.PathParameters.html" title="enum syn::PathParameters">PathParameters</a>)</code></span></h3><h3 id='method.visit_assoc_type_binding' class='method'><span id='visit_assoc_type_binding.v' class='invisible'><code>fn <a href='#method.visit_assoc_type_binding' class='fnname'>visit_assoc_type_binding</a>(&amp;mut self, type_binding: &amp;<a class="struct" href="../../syn/struct.TypeBinding.html" title="struct syn::TypeBinding">TypeBinding</a>)</code></span></h3><h3 id='method.visit_attribute' class='method'><span id='visit_attribute.v' class='invisible'><code>fn <a href='#method.visit_attribute' class='fnname'>visit_attribute</a>(&amp;mut self, _attr: &amp;<a class="struct" href="../../syn/struct.Attribute.html" title="struct syn::Attribute">Attribute</a>)</code></span></h3><h3 id='method.visit_fn_ret_ty' class='method'><span id='visit_fn_ret_ty.v' class='invisible'><code>fn <a href='#method.visit_fn_ret_ty' class='fnname'>visit_fn_ret_ty</a>(&amp;mut self, ret_ty: &amp;<a class="enum" href="../../syn/enum.FunctionRetTy.html" title="enum syn::FunctionRetTy">FunctionRetTy</a>)</code></span></h3><h3 id='method.visit_const_expr' class='method'><span id='visit_const_expr.v' class='invisible'><code>fn <a href='#method.visit_const_expr' class='fnname'>visit_const_expr</a>(&amp;mut self, expr: &amp;<a class="enum" href="../../syn/enum.ConstExpr.html" title="enum syn::ConstExpr">ConstExpr</a>)</code></span></h3><h3 id='method.visit_lit' class='method'><span id='visit_lit.v' class='invisible'><code>fn <a href='#method.visit_lit' class='fnname'>visit_lit</a>(&amp;mut self, _lit: &amp;<a class="enum" href="../../syn/enum.Lit.html" title="enum syn::Lit">Lit</a>)</code></span></h3><h3 id='method.visit_mac' class='method'><span id='visit_mac.v' class='invisible'><code>fn <a href='#method.visit_mac' class='fnname'>visit_mac</a>(&amp;mut self, mac: &amp;<a class="struct" href="../../syn/struct.Mac.html" title="struct syn::Mac">Mac</a>)</code></span></h3></div>
  85. <h2 id='implementors' class='small-section-header'>
  86. Implementors<a href='#implementors' class='anchor'></a>
  87. </h2>
  88. <ul class='item-list' id='implementors-list'>
  89. </ul><script type="text/javascript" async
  90. src="../../implementors/syn/visit/trait.Visitor.js">
  91. </script></section>
  92. <section id='search' class="content hidden"></section>
  93. <section class="footer"></section>
  94. <aside id="help" class="hidden">
  95. <div>
  96. <h1 class="hidden">Help</h1>
  97. <div class="shortcuts">
  98. <h2>Keyboard Shortcuts</h2>
  99. <dl>
  100. <dt><kbd>?</kbd></dt>
  101. <dd>Show this help dialog</dd>
  102. <dt><kbd>S</kbd></dt>
  103. <dd>Focus the search field</dd>
  104. <dt><kbd>↑</kbd></dt>
  105. <dd>Move up in search results</dd>
  106. <dt><kbd>↓</kbd></dt>
  107. <dd>Move down in search results</dd>
  108. <dt><kbd>↹</kbd></dt>
  109. <dd>Switch tab</dd>
  110. <dt><kbd>&#9166;</kbd></dt>
  111. <dd>Go to active search result</dd>
  112. <dt><kbd>+</kbd></dt>
  113. <dd>Expand all sections</dd>
  114. <dt><kbd>-</kbd></dt>
  115. <dd>Collapse all sections</dd>
  116. </dl>
  117. </div>
  118. <div class="infos">
  119. <h2>Search Tricks</h2>
  120. <p>
  121. Prefix searches with a type followed by a colon (e.g.
  122. <code>fn:</code>) to restrict the search to a given type.
  123. </p>
  124. <p>
  125. Accepted types are: <code>fn</code>, <code>mod</code>,
  126. <code>struct</code>, <code>enum</code>,
  127. <code>trait</code>, <code>type</code>, <code>macro</code>,
  128. and <code>const</code>.
  129. </p>
  130. <p>
  131. Search functions by type signature (e.g.
  132. <code>vec -> usize</code> or <code>* -> vec</code>)
  133. </p>
  134. </div>
  135. </div>
  136. </aside>
  137. <script>
  138. window.rootPath = "../../";
  139. window.currentCrate = "syn";
  140. </script>
  141. <script src="../../main.js"></script>
  142. <script defer src="../../search-index.js"></script>
  143. </body>
  144. </html>