harald/chainerror
1
0
Fork 0
mirror of https://github.com/haraldh/chainerror.git synced 2025-01-31 09:04:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

publish: Cargo.toml: 0.4.3

Browse source 
generated from commit deaaf4ce9f
This commit is contained in:
Harald Hoyer 2019-03-04 11:46:17 +01:00
parent 0fb03407c8
commit 4dfb67bc45
18 changed files with 2282 additions and 571 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
end.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html" class="active">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html" class="active">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -151,7 +151,7 @@ the <a href="https://github.com/haraldh/chainerror">Git Repo</a>.</p>
<nav class="nav-wrapper" aria-label="Page navigation"> <nav class="nav-wrapper" aria-label="Page navigation">
<!-- Mobile navigation buttons --> <!-- Mobile navigation buttons -->
<a rel="prev" href="tutorial12.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left"> <a rel="prev" href="tutorial13.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </a>
@ -165,7 +165,7 @@ the <a href="https://github.com/haraldh/chainerror">Git Repo</a>.</p>
<nav class="nav-wide-wrapper" aria-label="Page navigation"> <nav class="nav-wide-wrapper" aria-label="Page navigation">
<a href="tutorial12.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left"> <a href="tutorial13.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
<i class="fa fa-angle-left"></i> <i class="fa fa-angle-left"></i>
</a> </a>

2
index.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">

1306
print.html
View file

File diff suppressed because it is too large Load diff

2
searchindex.js
View file

File diff suppressed because one or more lines are too long

2
searchindex.json
View file

File diff suppressed because one or more lines are too long

2
tutorial1.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html" class="active"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html" class="active"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">

29
tutorial10.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html" class="active"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html" class="active"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -151,7 +151,7 @@ use <code>ChainResult&lt;(), Func1ErrorKind&gt;</code>.</p>
<p>In <code>main</code> we can now directly use the methods of <code>ChainError&lt;T&gt;</code> without downcasting the error first.</p> <p>In <code>main</code> we can now directly use the methods of <code>ChainError&lt;T&gt;</code> without downcasting the error first.</p>
<p>Also a nice <code>match</code> on <code>ChainError&lt;T&gt;.kind()</code> is now possible, which returns <code>&amp;T</code>, meaning <p>Also a nice <code>match</code> on <code>ChainError&lt;T&gt;.kind()</code> is now possible, which returns <code>&amp;T</code>, meaning
<code>&amp;Func1ErrorKind</code> here.</p> <code>&amp;Func1ErrorKind</code> here.</p>
<pre><pre class="playpen"><code class="language-rust">use crate::chainerror::*; <pre><pre class="playpen"><code class="language-rust">use chainerror::*;
use std::error::Error; use std::error::Error;
use std::io; use std::io;
use std::result::Result; use std::result::Result;
@ -209,6 +209,7 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
} }
Ok(()) Ok(())
} }
# #[allow(dead_code)] # #[allow(dead_code)]
# mod chainerror { # mod chainerror {
# //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your # //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your
@ -897,15 +898,9 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!(None, format!($fmt, $($arg)+ )) # cherr!(None, format!($fmt, $($arg)+ ))
# }); # });
# ( $e:ident, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# });
# ( $e:path, $k:expr ) =&gt; ({ # ( $e:path, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!()))) # ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# }); # });
# ( $e:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ ))
# });
# ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ )) # cherr!($e, format!($fmt, $($arg)+ ))
# }); # });
@ -1000,21 +995,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! mstrerr { # macro_rules! mstrerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ ))) # |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# }); # });
@ -1067,21 +1053,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! strerr { # macro_rules! strerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ ))) # cherr!($t (format!($fmt, $($arg)+ )))
# }); # });

29
tutorial11.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html" class="active"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html" class="active"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -156,7 +156,7 @@ src/main.rs:40: func1 error calling func2
<p>To create your own Errors, you might find <a href="https://crates.io">crates</a> which create enum <code>Display+Debug</code> via derive macros.</p> <p>To create your own Errors, you might find <a href="https://crates.io">crates</a> which create enum <code>Display+Debug</code> via derive macros.</p>
<p>Also noteworthy is <a href="https://crates.io/crates/custom_error">custom_error</a> to define your custom errors, <p>Also noteworthy is <a href="https://crates.io/crates/custom_error">custom_error</a> to define your custom errors,
which can then be used with <code>chainerror</code>.</p> which can then be used with <code>chainerror</code>.</p>
<pre><pre class="playpen"><code class="language-rust">use crate::chainerror::*; <pre><pre class="playpen"><code class="language-rust">use chainerror::*;
use std::error::Error; use std::error::Error;
use std::io; use std::io;
use std::result::Result; use std::result::Result;
@ -220,6 +220,7 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
} }
Ok(()) Ok(())
} }
# #[allow(dead_code)] # #[allow(dead_code)]
# mod chainerror { # mod chainerror {
# //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your # //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your
@ -908,15 +909,9 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!(None, format!($fmt, $($arg)+ )) # cherr!(None, format!($fmt, $($arg)+ ))
# }); # });
# ( $e:ident, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# });
# ( $e:path, $k:expr ) =&gt; ({ # ( $e:path, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!()))) # ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# }); # });
# ( $e:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ ))
# });
# ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ )) # cherr!($e, format!($fmt, $($arg)+ ))
# }); # });
@ -1011,21 +1006,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! mstrerr { # macro_rules! mstrerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ ))) # |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# }); # });
@ -1078,21 +1064,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! strerr { # macro_rules! strerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ ))) # cherr!($t (format!($fmt, $($arg)+ )))
# }); # });

33
tutorial12.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html" class="active"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html" class="active"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -143,7 +143,7 @@
<a class="header" href="#deref-for-the-errorkind" id="deref-for-the-errorkind"><h1>Deref for the ErrorKind</h1></a> <a class="header" href="#deref-for-the-errorkind" id="deref-for-the-errorkind"><h1>Deref for the ErrorKind</h1></a>
<p>Because ChainError<T> implements Deref to &amp;T, we can also match on <code>*e</code> instead of <code>e.kind()</code> <p>Because ChainError<T> implements Deref to &amp;T, we can also match on <code>*e</code> instead of <code>e.kind()</code>
or call a function with <code>&amp;e</code></p> or call a function with <code>&amp;e</code></p>
<pre><pre class="playpen"><code class="language-rust">use crate::chainerror::*; <pre><pre class="playpen"><code class="language-rust">use chainerror::*;
use std::error::Error; use std::error::Error;
use std::io; use std::io;
use std::result::Result; use std::result::Result;
@ -218,6 +218,7 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
} }
Ok(()) Ok(())
} }
# #[allow(dead_code)] # #[allow(dead_code)]
# mod chainerror { # mod chainerror {
# //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your # //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your
@ -906,15 +907,9 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!(None, format!($fmt, $($arg)+ )) # cherr!(None, format!($fmt, $($arg)+ ))
# }); # });
# ( $e:ident, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# });
# ( $e:path, $k:expr ) =&gt; ({ # ( $e:path, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!()))) # ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# }); # });
# ( $e:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ ))
# });
# ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ )) # cherr!($e, format!($fmt, $($arg)+ ))
# }); # });
@ -1009,21 +1004,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! mstrerr { # macro_rules! mstrerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ ))) # |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# }); # });
@ -1076,21 +1062,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! strerr { # macro_rules! strerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ ))) # cherr!($t (format!($fmt, $($arg)+ )))
# }); # });
@ -1179,7 +1156,7 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
<a rel="next" href="end.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right"> <a rel="next" href="tutorial13.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
<i class="fa fa-angle-right"></i> <i class="fa fa-angle-right"></i>
</a> </a>
@ -1197,7 +1174,7 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
<a href="end.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right"> <a href="tutorial13.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
<i class="fa fa-angle-right"></i> <i class="fa fa-angle-right"></i>
</a> </a>

1210
tutorial13.html Normal file
View file

File diff suppressed because it is too large Load diff

29
tutorial2.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html" class="active"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html" class="active"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -144,7 +144,7 @@
<p>With relatively small changes and the help of the <code>cherr!</code> macro of the <code>chainerror</code> crate <p>With relatively small changes and the help of the <code>cherr!</code> macro of the <code>chainerror</code> crate
the <code>String</code> errors are now chained together.</p> the <code>String</code> errors are now chained together.</p>
<p>Press the play button in the upper right corner and see the nice debug output.</p> <p>Press the play button in the upper right corner and see the nice debug output.</p>
<pre><pre class="playpen"><code class="language-rust">use crate::chainerror::*; <pre><pre class="playpen"><code class="language-rust">use chainerror::*;
use std::error::Error; use std::error::Error;
use std::io; use std::io;
@ -172,6 +172,7 @@ fn func1() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; { fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
func1() func1()
} }
# #[allow(dead_code)] # #[allow(dead_code)]
# mod chainerror { # mod chainerror {
# //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your # //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your
@ -860,15 +861,9 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!(None, format!($fmt, $($arg)+ )) # cherr!(None, format!($fmt, $($arg)+ ))
# }); # });
# ( $e:ident, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# });
# ( $e:path, $k:expr ) =&gt; ({ # ( $e:path, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!()))) # ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# }); # });
# ( $e:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ ))
# });
# ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ )) # cherr!($e, format!($fmt, $($arg)+ ))
# }); # });
@ -963,21 +958,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! mstrerr { # macro_rules! mstrerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ ))) # |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# }); # });
@ -1030,21 +1016,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! strerr { # macro_rules! strerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ ))) # cherr!($t (format!($fmt, $($arg)+ )))
# }); # });

29
tutorial3.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html" class="active"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html" class="active"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -142,7 +142,7 @@
<main> <main>
<a class="header" href="#mapping-errors" id="mapping-errors"><h1>Mapping Errors</h1></a> <a class="header" href="#mapping-errors" id="mapping-errors"><h1>Mapping Errors</h1></a>
<p>Now let's get more rust idiomatic by using <code>.map_err()</code>.</p> <p>Now let's get more rust idiomatic by using <code>.map_err()</code>.</p>
<pre><pre class="playpen"><code class="language-rust">use crate::chainerror::*; <pre><pre class="playpen"><code class="language-rust">use chainerror::*;
use std::error::Error; use std::error::Error;
use std::io; use std::io;
@ -169,6 +169,7 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
} }
Ok(()) Ok(())
} }
# #[allow(dead_code)] # #[allow(dead_code)]
# mod chainerror { # mod chainerror {
# //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your # //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your
@ -857,15 +858,9 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!(None, format!($fmt, $($arg)+ )) # cherr!(None, format!($fmt, $($arg)+ ))
# }); # });
# ( $e:ident, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# });
# ( $e:path, $k:expr ) =&gt; ({ # ( $e:path, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!()))) # ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# }); # });
# ( $e:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ ))
# });
# ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ )) # cherr!($e, format!($fmt, $($arg)+ ))
# }); # });
@ -960,21 +955,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! mstrerr { # macro_rules! mstrerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ ))) # |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# }); # });
@ -1027,21 +1013,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! strerr { # macro_rules! strerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ ))) # cherr!($t (format!($fmt, $($arg)+ )))
# }); # });

29
tutorial4.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html" class="active"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html" class="active"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -146,7 +146,7 @@ let you jump through hoops, <code>chainerror</code> has a quick macro for that.<
<p><code>mstrerror!()</code> fits right into <code>.map_err()</code> letting you quickly add <p><code>mstrerror!()</code> fits right into <code>.map_err()</code> letting you quickly add
more debug strings.</p> more debug strings.</p>
<p><code>mstrerror!()</code> even understands <code>format!()</code> syntax like <code>println!()</code>.</p> <p><code>mstrerror!()</code> even understands <code>format!()</code> syntax like <code>println!()</code>.</p>
<pre><pre class="playpen"><code class="language-rust">use crate::chainerror::*; <pre><pre class="playpen"><code class="language-rust">use chainerror::*;
use std::error::Error; use std::error::Error;
use std::io; use std::io;
use std::result::Result; use std::result::Result;
@ -173,6 +173,7 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
} }
Ok(()) Ok(())
} }
# #[allow(dead_code)] # #[allow(dead_code)]
# mod chainerror { # mod chainerror {
# //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your # //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your
@ -861,15 +862,9 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!(None, format!($fmt, $($arg)+ )) # cherr!(None, format!($fmt, $($arg)+ ))
# }); # });
# ( $e:ident, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# });
# ( $e:path, $k:expr ) =&gt; ({ # ( $e:path, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!()))) # ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# }); # });
# ( $e:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ ))
# });
# ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ )) # cherr!($e, format!($fmt, $($arg)+ ))
# }); # });
@ -964,21 +959,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! mstrerr { # macro_rules! mstrerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ ))) # |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# }); # });
@ -1031,21 +1017,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! strerr { # macro_rules! strerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ ))) # cherr!($t (format!($fmt, $($arg)+ )))
# }); # });

29
tutorial5.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html" class="active"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html" class="active"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -143,7 +143,7 @@
<a class="header" href="#the-source-of-errors" id="the-source-of-errors"><h1>The source() of Errors</h1></a> <a class="header" href="#the-source-of-errors" id="the-source-of-errors"><h1>The source() of Errors</h1></a>
<p>Sometimes you want to inspect the <code>source()</code> of an <code>Error</code>. <p>Sometimes you want to inspect the <code>source()</code> of an <code>Error</code>.
<code>chainerror</code> implements <code>std::error::Error::source()</code>, so you can get the cause of an error.</p> <code>chainerror</code> implements <code>std::error::Error::source()</code>, so you can get the cause of an error.</p>
<pre><pre class="playpen"><code class="language-rust">use crate::chainerror::*; <pre><pre class="playpen"><code class="language-rust">use chainerror::*;
use std::error::Error; use std::error::Error;
use std::io; use std::io;
use std::result::Result; use std::result::Result;
@ -175,6 +175,7 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
} }
Ok(()) Ok(())
} }
# #[allow(dead_code)] # #[allow(dead_code)]
# mod chainerror { # mod chainerror {
# //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your # //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your
@ -863,15 +864,9 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!(None, format!($fmt, $($arg)+ )) # cherr!(None, format!($fmt, $($arg)+ ))
# }); # });
# ( $e:ident, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# });
# ( $e:path, $k:expr ) =&gt; ({ # ( $e:path, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!()))) # ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# }); # });
# ( $e:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ ))
# });
# ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ )) # cherr!($e, format!($fmt, $($arg)+ ))
# }); # });
@ -966,21 +961,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! mstrerr { # macro_rules! mstrerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ ))) # |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# }); # });
@ -1033,21 +1019,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! strerr { # macro_rules! strerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ ))) # cherr!($t (format!($fmt, $($arg)+ )))
# }); # });

29
tutorial6.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html" class="active"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html" class="active"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -147,7 +147,7 @@
pub fn downcast_mut&lt;T: Error + 'static&gt;(&amp;mut self) -&gt; Option&lt;&amp;mut T&gt; pub fn downcast_mut&lt;T: Error + 'static&gt;(&amp;mut self) -&gt; Option&lt;&amp;mut T&gt;
</code></pre> </code></pre>
<p>This is how it looks like, when using those:</p> <p>This is how it looks like, when using those:</p>
<pre><pre class="playpen"><code class="language-rust">use crate::chainerror::*; <pre><pre class="playpen"><code class="language-rust">use chainerror::*;
use std::error::Error; use std::error::Error;
use std::io; use std::io;
use std::result::Result; use std::result::Result;
@ -187,6 +187,7 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
} }
Ok(()) Ok(())
} }
# #[allow(dead_code)] # #[allow(dead_code)]
# mod chainerror { # mod chainerror {
# //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your # //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your
@ -875,15 +876,9 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!(None, format!($fmt, $($arg)+ )) # cherr!(None, format!($fmt, $($arg)+ ))
# }); # });
# ( $e:ident, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# });
# ( $e:path, $k:expr ) =&gt; ({ # ( $e:path, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!()))) # ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# }); # });
# ( $e:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ ))
# });
# ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ )) # cherr!($e, format!($fmt, $($arg)+ ))
# }); # });
@ -978,21 +973,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! mstrerr { # macro_rules! mstrerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ ))) # |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# }); # });
@ -1045,21 +1031,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! strerr { # macro_rules! strerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ ))) # cherr!($t (format!($fmt, $($arg)+ )))
# }); # });

29
tutorial7.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html" class="active"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html" class="active"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -158,7 +158,7 @@ to call <code>.find_cause::&lt;io::Error&gt;()</code>.</p>
<p>or to use <code>.root_cause()</code>, which of course can be of any type implementing <code>std::error::Error</code>.</p> <p>or to use <code>.root_cause()</code>, which of course can be of any type implementing <code>std::error::Error</code>.</p>
<pre><code class="language-rust ignore"> if let Some(e) = s.root_cause() { <pre><code class="language-rust ignore"> if let Some(e) = s.root_cause() {
</code></pre> </code></pre>
<pre><pre class="playpen"><code class="language-rust">use crate::chainerror::*; <pre><pre class="playpen"><code class="language-rust">use chainerror::*;
use std::error::Error; use std::error::Error;
use std::io; use std::io;
use std::result::Result; use std::result::Result;
@ -199,6 +199,7 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
} }
Ok(()) Ok(())
} }
# #[allow(dead_code)] # #[allow(dead_code)]
# mod chainerror { # mod chainerror {
# //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your # //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your
@ -887,15 +888,9 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!(None, format!($fmt, $($arg)+ )) # cherr!(None, format!($fmt, $($arg)+ ))
# }); # });
# ( $e:ident, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# });
# ( $e:path, $k:expr ) =&gt; ({ # ( $e:path, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!()))) # ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# }); # });
# ( $e:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ ))
# });
# ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ )) # cherr!($e, format!($fmt, $($arg)+ ))
# }); # });
@ -990,21 +985,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! mstrerr { # macro_rules! mstrerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ ))) # |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# }); # });
@ -1057,21 +1043,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! strerr { # macro_rules! strerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ ))) # cherr!($t (format!($fmt, $($arg)+ )))
# }); # });

29
tutorial8.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html" class="active"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html" class="active"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -155,7 +155,7 @@ derive_str_cherr!(Func1Error);
<pre><code class="language-rust ignore"> if let Some(f2err) = f1err.find_cause::&lt;ChainError&lt;Func2Error&gt;&gt;() { <pre><code class="language-rust ignore"> if let Some(f2err) = f1err.find_cause::&lt;ChainError&lt;Func2Error&gt;&gt;() {
</code></pre> </code></pre>
<p>hiding the <code>ChainError&lt;T&gt;</code> implementation detail.</p> <p>hiding the <code>ChainError&lt;T&gt;</code> implementation detail.</p>
<pre><pre class="playpen"><code class="language-rust">use crate::chainerror::*; <pre><pre class="playpen"><code class="language-rust">use chainerror::*;
use std::error::Error; use std::error::Error;
use std::io; use std::io;
use std::result::Result; use std::result::Result;
@ -196,6 +196,7 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
} }
Ok(()) Ok(())
} }
# #[allow(dead_code)] # #[allow(dead_code)]
# mod chainerror { # mod chainerror {
# //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your # //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your
@ -884,15 +885,9 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!(None, format!($fmt, $($arg)+ )) # cherr!(None, format!($fmt, $($arg)+ ))
# }); # });
# ( $e:ident, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# });
# ( $e:path, $k:expr ) =&gt; ({ # ( $e:path, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!()))) # ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# }); # });
# ( $e:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ ))
# });
# ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ )) # cherr!($e, format!($fmt, $($arg)+ ))
# }); # });
@ -987,21 +982,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! mstrerr { # macro_rules! mstrerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ ))) # |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# }); # });
@ -1054,21 +1040,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! strerr { # macro_rules! strerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ ))) # cherr!($t (format!($fmt, $($arg)+ )))
# }); # });

29
tutorial9.html
View file

@ -75,7 +75,7 @@
</script> </script>
<nav id="sidebar" class="sidebar" aria-label="Table of contents"> <nav id="sidebar" class="sidebar" aria-label="Table of contents">
<ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html" class="active"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li class="affix"><a href="end.html">The End</a></li></ol> <ol class="chapter"><li class="affix"><a href="index.html">chainerror</a></li><li><a href="tutorial1.html"><strong aria-hidden="true">1.</strong> Simple String Errors</a></li><li><a href="tutorial2.html"><strong aria-hidden="true">2.</strong> Simple Chained String Errors</a></li><li><a href="tutorial3.html"><strong aria-hidden="true">3.</strong> Mapping Errors</a></li><li><a href="tutorial4.html"><strong aria-hidden="true">4.</strong> Saving coding chars</a></li><li><a href="tutorial5.html"><strong aria-hidden="true">5.</strong> The source() of Errors</a></li><li><a href="tutorial6.html"><strong aria-hidden="true">6.</strong> Downcast the Errors</a></li><li><a href="tutorial7.html"><strong aria-hidden="true">7.</strong> The root cause of all Errors</a></li><li><a href="tutorial8.html"><strong aria-hidden="true">8.</strong> Finding an Error cause</a></li><li><a href="tutorial9.html" class="active"><strong aria-hidden="true">9.</strong> Selective Error Handling</a></li><li><a href="tutorial10.html"><strong aria-hidden="true">10.</strong> ErrorKind to the rescue</a></li><li><a href="tutorial11.html"><strong aria-hidden="true">11.</strong> Debug for the ErrorKind</a></li><li><a href="tutorial12.html"><strong aria-hidden="true">12.</strong> Deref for the ErrorKind</a></li><li><a href="tutorial13.html"><strong aria-hidden="true">13.</strong> Writing a library</a></li><li class="affix"><a href="end.html">The End</a></li></ol>
</nav> </nav>
<div id="page-wrapper" class="page-wrapper"> <div id="page-wrapper" class="page-wrapper">
@ -159,7 +159,7 @@
</code></pre> </code></pre>
<p>but this is not valid rust code, so we end up doing it the hard way. <p>but this is not valid rust code, so we end up doing it the hard way.
In the next chapter, we will see, how to solve this more elegantly.</p> In the next chapter, we will see, how to solve this more elegantly.</p>
<pre><pre class="playpen"><code class="language-rust">use crate::chainerror::*; <pre><pre class="playpen"><code class="language-rust">use chainerror::*;
use std::error::Error; use std::error::Error;
use std::io; use std::io;
use std::result::Result; use std::result::Result;
@ -199,6 +199,7 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
} }
Ok(()) Ok(())
} }
# #[allow(dead_code)] # #[allow(dead_code)]
# mod chainerror { # mod chainerror {
# //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your # //! `chainerror` provides an error backtrace without doing a real backtrace, so even after you `strip` your
@ -887,15 +888,9 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( None, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!(None, format!($fmt, $($arg)+ )) # cherr!(None, format!($fmt, $($arg)+ ))
# }); # });
# ( $e:ident, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# });
# ( $e:path, $k:expr ) =&gt; ({ # ( $e:path, $k:expr ) =&gt; ({
# ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!()))) # ChainError::&lt;_&gt;::new($k, Some(Box::from($e)), Some((line!(), file!())))
# }); # });
# ( $e:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ ))
# });
# ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $e:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($e, format!($fmt, $($arg)+ )) # cherr!($e, format!($fmt, $($arg)+ ))
# }); # });
@ -990,21 +985,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! mstrerr { # macro_rules! mstrerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# |e| cherr!(e, $t ($msg.to_string())) # |e| cherr!(e, $t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# |e| cherr!(e, $t (format!($fmt, $($arg)+ ))) # |e| cherr!(e, $t (format!($fmt, $($arg)+ )))
# }); # });
@ -1057,21 +1043,12 @@ fn main() -&gt; Result&lt;(), Box&lt;Error&gt;&gt; {
# /// ~~~ # /// ~~~
# #[macro_export] # #[macro_export]
# macro_rules! strerr { # macro_rules! strerr {
# ( $t:ident, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr ) =&gt; ({ # ( $t:path, $msg:expr ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string()))
# });
# ( $t:path, $msg:expr, ) =&gt; ({ # ( $t:path, $msg:expr, ) =&gt; ({
# cherr!($t ($msg.to_string())) # cherr!($t ($msg.to_string()))
# }); # });
# ( $t:ident, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ )))
# });
# ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({ # ( $t:path, $fmt:expr, $($arg:tt)+ ) =&gt; ({
# cherr!($t (format!($fmt, $($arg)+ ))) # cherr!($t (format!($fmt, $($arg)+ )))
# }); # });