trait.ResultExt.html 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161
  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 `ResultExt` trait in crate `failure`.">
  8. <meta name="keywords" content="rust, rustlang, rust-lang, ResultExt">
  9. <title>failure::ResultExt - 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 ResultExt</p><div class="sidebar-elems"><div class="block items"><a class="sidebar-title" href="#required-methods">Required Methods</a><div class="sidebar-links"><a href="#tymethod.compat">compat</a><a href="#tymethod.context">context</a><a href="#tymethod.with_context">with_context</a></div><a class="sidebar-title" href="#foreign-impls">Implementations on Foreign Types</a><div class="sidebar-links"><a href="#impl-ResultExt%3CT%2C%20E%3E">Result&lt;T, E&gt;</a><a href="#impl-ResultExt%3CT%2C%20Error%3E">Result&lt;T, Error&gt;</a></div><a class="sidebar-title" href="#implementors">Implementors</a></div><p class='location'><a href='index.html'>failure</a></p><script>window.sidebarCurrent = {name: 'ResultExt', 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'>failure</a>::<wbr><a class="trait" href=''>ResultExt</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/failure/result_ext.rs.html#6-20' title='goto source code'>[src]</a></span></h1>
  50. <pre class='rust trait'>pub trait ResultExt&lt;T, E&gt; {
  51. fn <a href='#tymethod.compat' class='fnname'>compat</a>(self) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Compat.html" title="struct failure::Compat">Compat</a>&lt;E&gt;&gt;;
  52. <div class='item-spacer'></div> fn <a href='#tymethod.context' class='fnname'>context</a>&lt;D&gt;(self, context: D) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Context.html" title="struct failure::Context">Context</a>&lt;D&gt;&gt;<br>&nbsp;&nbsp;&nbsp; <span class="where">where<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;D: <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> + 'static</span>;
  53. <div class='item-spacer'></div> fn <a href='#tymethod.with_context' class='fnname'>with_context</a>&lt;F, D&gt;(self, f: F) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Context.html" title="struct failure::Context">Context</a>&lt;D&gt;&gt;<br>&nbsp;&nbsp;&nbsp; <span class="where">where<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F: <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/function/trait.FnOnce.html" title="trait core::ops::function::FnOnce">FnOnce</a>(<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&amp;</a>E) -&gt; D,<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;D: <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> + 'static</span>;
  54. }</pre><div class='docblock'><p>Extension methods for <code>Result</code>.</p>
  55. </div>
  56. <h2 id='required-methods' class='small-section-header'>
  57. Required Methods<a href='#required-methods' class='anchor'></a>
  58. </h2>
  59. <div class='methods'>
  60. <h3 id='tymethod.compat' class='method'><span id='compat.v' class='invisible'><code>fn <a href='#tymethod.compat' class='fnname'>compat</a>(self) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Compat.html" title="struct failure::Compat">Compat</a>&lt;E&gt;&gt;</code></span></h3><div class='docblock'><p>Wraps the error in <code>Compat</code> to make it compatible with older error
  61. handling APIs that expect <code>std::error::Error</code>.</p>
  62. </div><h3 id='tymethod.context' class='method'><span id='context.v' class='invisible'><code>fn <a href='#tymethod.context' class='fnname'>context</a>&lt;D&gt;(self, context: D) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Context.html" title="struct failure::Context">Context</a>&lt;D&gt;&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;D: <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> + 'static,&nbsp;</span></code></span></h3><div class='docblock'><p>Wraps the error type in a context type.</p>
  63. </div><h3 id='tymethod.with_context' class='method'><span id='with_context.v' class='invisible'><code>fn <a href='#tymethod.with_context' class='fnname'>with_context</a>&lt;F, D&gt;(self, f: F) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Context.html" title="struct failure::Context">Context</a>&lt;D&gt;&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;F: <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/function/trait.FnOnce.html" title="trait core::ops::function::FnOnce">FnOnce</a>(<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&amp;</a>E) -&gt; D,<br>&nbsp;&nbsp;&nbsp;&nbsp;D: <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> + 'static,&nbsp;</span></code></span></h3><div class='docblock'><p>Wraps the error type in a context type generated by looking at the
  64. error value.</p>
  65. </div></div>
  66. <h2 id='foreign-impls' class='small-section-header'>
  67. Implementations on Foreign Types<a href='#foreign-impls' class='anchor'></a>
  68. </h2>
  69. <h3 id='impl-ResultExt%3CT%2C%20E%3E' class='impl'><span class='in-band'><code>impl&lt;T, E&gt; <a class="trait" href="../failure/trait.ResultExt.html" title="trait failure::ResultExt">ResultExt</a>&lt;T, E&gt; for <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, E&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;E: <a class="trait" href="../failure/trait.Fail.html" title="trait failure::Fail">Fail</a>,&nbsp;</span></code><a href='#impl-ResultExt%3CT%2C%20E%3E' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/failure/result_ext.rs.html#22-44' title='goto source code'>[src]</a></span></h3>
  70. <span class='docblock autohide'><div class='impl-items'><h4 id='method.compat' class="method"><span id='compat.v-1' class='invisible'><code>fn <a href='#method.compat' class='fnname'>compat</a>(self) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Compat.html" title="struct failure::Compat">Compat</a>&lt;E&gt;&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/failure/result_ext.rs.html#25-27' title='goto source code'>[src]</a></span></h4>
  71. <h4 id='method.context' class="method"><span id='context.v-1' class='invisible'><code>fn <a href='#method.context' class='fnname'>context</a>&lt;D&gt;(self, context: D) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Context.html" title="struct failure::Context">Context</a>&lt;D&gt;&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;D: <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> + 'static,&nbsp;</span></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/failure/result_ext.rs.html#29-33' title='goto source code'>[src]</a></span></h4>
  72. <h4 id='method.with_context' class="method"><span id='with_context.v-1' class='invisible'><code>fn <a href='#method.with_context' class='fnname'>with_context</a>&lt;F, D&gt;(self, f: F) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Context.html" title="struct failure::Context">Context</a>&lt;D&gt;&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;F: <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/function/trait.FnOnce.html" title="trait core::ops::function::FnOnce">FnOnce</a>(<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&amp;</a>E) -&gt; D,<br>&nbsp;&nbsp;&nbsp;&nbsp;D: <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> + 'static,&nbsp;</span></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/failure/result_ext.rs.html#35-43' title='goto source code'>[src]</a></span></h4>
  73. </div></span><h3 id='impl-ResultExt%3CT%2C%20Error%3E' class='impl'><span class='in-band'><code>impl&lt;T&gt; <a class="trait" href="../failure/trait.ResultExt.html" title="trait failure::ResultExt">ResultExt</a>&lt;T, <a class="struct" href="../failure/struct.Error.html" title="struct failure::Error">Error</a>&gt; for <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Error.html" title="struct failure::Error">Error</a>&gt;</code><a href='#impl-ResultExt%3CT%2C%20Error%3E' class='anchor'></a></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/failure/result_ext.rs.html#49-69' title='goto source code'>[src]</a></span></h3>
  74. <span class='docblock autohide'><div class='impl-items'><h4 id='method.compat-1' class="method"><span id='compat.v-2' class='invisible'><code>fn <a href='#method.compat' class='fnname'>compat</a>(self) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Compat.html" title="struct failure::Compat">Compat</a>&lt;<a class="struct" href="../failure/struct.Error.html" title="struct failure::Error">Error</a>&gt;&gt;</code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/failure/result_ext.rs.html#50-52' title='goto source code'>[src]</a></span></h4>
  75. <h4 id='method.context-1' class="method"><span id='context.v-2' class='invisible'><code>fn <a href='#method.context' class='fnname'>context</a>&lt;D&gt;(self, context: D) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Context.html" title="struct failure::Context">Context</a>&lt;D&gt;&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;D: <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> + 'static,&nbsp;</span></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/failure/result_ext.rs.html#54-58' title='goto source code'>[src]</a></span></h4>
  76. <h4 id='method.with_context-1' class="method"><span id='with_context.v-2' class='invisible'><code>fn <a href='#method.with_context' class='fnname'>with_context</a>&lt;F, D&gt;(self, f: F) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, <a class="struct" href="../failure/struct.Context.html" title="struct failure::Context">Context</a>&lt;D&gt;&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;F: <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/function/trait.FnOnce.html" title="trait core::ops::function::FnOnce">FnOnce</a>(&amp;<a class="struct" href="../failure/struct.Error.html" title="struct failure::Error">Error</a>) -&gt; D,<br>&nbsp;&nbsp;&nbsp;&nbsp;D: <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> + 'static,&nbsp;</span></code></span><span class='out-of-band'><div class='ghost'></div><a class='srclink' href='../src/failure/result_ext.rs.html#60-68' title='goto source code'>[src]</a></span></h4>
  77. </div></span>
  78. <h2 id='implementors' class='small-section-header'>
  79. Implementors<a href='#implementors' class='anchor'></a>
  80. </h2>
  81. <ul class='item-list' id='implementors-list'>
  82. </ul><script type="text/javascript" async
  83. src="../implementors/failure/trait.ResultExt.js">
  84. </script></section>
  85. <section id='search' class="content hidden"></section>
  86. <section class="footer"></section>
  87. <aside id="help" class="hidden">
  88. <div>
  89. <h1 class="hidden">Help</h1>
  90. <div class="shortcuts">
  91. <h2>Keyboard Shortcuts</h2>
  92. <dl>
  93. <dt><kbd>?</kbd></dt>
  94. <dd>Show this help dialog</dd>
  95. <dt><kbd>S</kbd></dt>
  96. <dd>Focus the search field</dd>
  97. <dt><kbd>↑</kbd></dt>
  98. <dd>Move up in search results</dd>
  99. <dt><kbd>↓</kbd></dt>
  100. <dd>Move down in search results</dd>
  101. <dt><kbd>↹</kbd></dt>
  102. <dd>Switch tab</dd>
  103. <dt><kbd>&#9166;</kbd></dt>
  104. <dd>Go to active search result</dd>
  105. <dt><kbd>+</kbd></dt>
  106. <dd>Expand all sections</dd>
  107. <dt><kbd>-</kbd></dt>
  108. <dd>Collapse all sections</dd>
  109. </dl>
  110. </div>
  111. <div class="infos">
  112. <h2>Search Tricks</h2>
  113. <p>
  114. Prefix searches with a type followed by a colon (e.g.
  115. <code>fn:</code>) to restrict the search to a given type.
  116. </p>
  117. <p>
  118. Accepted types are: <code>fn</code>, <code>mod</code>,
  119. <code>struct</code>, <code>enum</code>,
  120. <code>trait</code>, <code>type</code>, <code>macro</code>,
  121. and <code>const</code>.
  122. </p>
  123. <p>
  124. Search functions by type signature (e.g.
  125. <code>vec -> usize</code> or <code>* -> vec</code>)
  126. </p>
  127. </div>
  128. </div>
  129. </aside>
  130. <script>
  131. window.rootPath = "../";
  132. window.currentCrate = "failure";
  133. </script>
  134. <script src="../main.js"></script>
  135. <script defer src="../search-index.js"></script>
  136. </body>
  137. </html>