3 <meta http-equiv=
"Content-Type" content=
"text/html; charset=US-ASCII">
5 <link rel=
"stylesheet" href=
"../../../../../../../doc/src/boostbook.css" type=
"text/css">
6 <meta name=
"generator" content=
"DocBook XSL Stylesheets V1.75.2">
7 <link rel=
"home" href=
"../../../index.html" title=
"Chapter 1. Phoenix 3.2.0">
8 <link rel=
"up" href=
"../statement.html" title=
"Statement">
9 <link rel=
"prev" href=
"try__catch__statement.html" title=
"try_ catch_ Statement">
10 <link rel=
"next" href=
"../object.html" title=
"Object">
12 <body bgcolor=
"white" text=
"black" link=
"#0000FF" vlink=
"#840084" alink=
"#0000FF">
13 <table cellpadding=
"2" width=
"100%"><tr>
14 <td valign=
"top"><img alt=
"Boost C++ Libraries" width=
"277" height=
"86" src=
"../../../../../../../boost.png"></td>
15 <td align=
"center"><a href=
"../../../../../../../index.html">Home
</a></td>
16 <td align=
"center"><a href=
"../../../../../../../libs/libraries.htm">Libraries
</a></td>
17 <td align=
"center"><a href=
"http://www.boost.org/users/people.html">People
</a></td>
18 <td align=
"center"><a href=
"http://www.boost.org/users/faq.html">FAQ
</a></td>
19 <td align=
"center"><a href=
"../../../../../../../more/index.htm">More
</a></td>
22 <div class=
"spirit-nav">
23 <a accesskey=
"p" href=
"try__catch__statement.html"><img src=
"../../../../../../../doc/src/images/prev.png" alt=
"Prev"></a><a accesskey=
"u" href=
"../statement.html"><img src=
"../../../../../../../doc/src/images/up.png" alt=
"Up"></a><a accesskey=
"h" href=
"../../../index.html"><img src=
"../../../../../../../doc/src/images/home.png" alt=
"Home"></a><a accesskey=
"n" href=
"../object.html"><img src=
"../../../../../../../doc/src/images/next.png" alt=
"Next"></a>
26 <div class=
"titlepage"><div><div><h4 class=
"title">
27 <a name=
"phoenix.modules.statement.throw_"></a><a class=
"link" href=
"throw_.html" title=
"throw_">throw_
</a>
28 </h4></div></div></div>
29 <pre class=
"programlisting"><span class=
"preprocessor">#include
</span> <span class=
"special"><</span><span class=
"identifier">boost
</span><span class=
"special">/
</span><span class=
"identifier">phoenix
</span><span class=
"special">/
</span><span class=
"identifier">statement
</span><span class=
"special">/
</span><span class=
"keyword">throw
</span><span class=
"special">.
</span><span class=
"identifier">hpp
</span><span class=
"special">></span>
32 As a natural companion to the try/catch support, the statement module provides
33 lazy throwing and re-throwing of exceptions.
36 The syntax to throw an exception is:
38 <pre class=
"programlisting"><span class=
"identifier">throw_
</span><span class=
"special">(
</span><span class=
"identifier">exception_expression
</span><span class=
"special">)
</span>
41 The syntax to re-throw an exception is:
43 <pre class=
"programlisting"><span class=
"identifier">throw_
</span><span class=
"special">()
</span>
46 Example: This code extends the try/catch example, re-throwing exceptions
47 derived from runtime_error or exception, and translating other exception
48 types to runtime_errors.
50 <pre class=
"programlisting"><span class=
"identifier">try_
</span>
51 <span class=
"special">[
</span>
52 <span class=
"identifier">f
</span><span class=
"special">(
</span><span class=
"identifier">arg1
</span><span class=
"special">)
</span>
53 <span class=
"special">]
</span>
54 <span class=
"special">.
</span><span class=
"identifier">catch_
</span><span class=
"special"><</span><span class=
"identifier">runtime_error
</span><span class=
"special">>()
</span>
55 <span class=
"special">[
</span>
56 <span class=
"identifier">cout
</span> <span class=
"special"><<</span> <span class=
"identifier">val
</span><span class=
"special">(
</span><span class=
"string">"caught runtime error or derived\n"</span><span class=
"special">),
</span>
57 <span class=
"identifier">throw_
</span><span class=
"special">()
</span>
58 <span class=
"special">]
</span>
59 <span class=
"special">.
</span><span class=
"identifier">catch_
</span><span class=
"special"><</span><span class=
"identifier">exception
</span><span class=
"special">>()
</span>
60 <span class=
"special">[
</span>
61 <span class=
"identifier">cout
</span> <span class=
"special"><<</span> <span class=
"identifier">val
</span><span class=
"special">(
</span><span class=
"string">"caught exception or derived\n"</span><span class=
"special">),
</span>
62 <span class=
"identifier">throw_
</span><span class=
"special">()
</span>
63 <span class=
"special">]
</span>
64 <span class=
"special">.
</span><span class=
"identifier">catch_all
</span>
65 <span class=
"special">[
</span>
66 <span class=
"identifier">cout
</span> <span class=
"special"><<</span> <span class=
"identifier">val
</span><span class=
"special">(
</span><span class=
"string">"caught some other type of exception\n"</span><span class=
"special">),
</span>
67 <span class=
"identifier">throw_
</span><span class=
"special">(
</span><span class=
"identifier">runtime_error
</span><span class=
"special">(
</span><span class=
"string">"translated exception"</span><span class=
"special">))
</span>
68 <span class=
"special">]
</span>
71 <table xmlns:
rev=
"http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width=
"100%"><tr>
72 <td align=
"left"></td>
73 <td align=
"right"><div class=
"copyright-footer">Copyright
© 2002-
2005,
2010,
2014,
2015 Joel de Guzman, Dan Marsden, Thomas
74 Heller, John Fletcher
<p>
75 Distributed under the Boost Software License, Version
1.0. (See accompanying
76 file LICENSE_1_0.txt or copy at
<a href=
"http://www.boost.org/LICENSE_1_0.txt" target=
"_top">http://www.boost.org/LICENSE_1_0.txt
</a>)
81 <div class=
"spirit-nav">
82 <a accesskey=
"p" href=
"try__catch__statement.html"><img src=
"../../../../../../../doc/src/images/prev.png" alt=
"Prev"></a><a accesskey=
"u" href=
"../statement.html"><img src=
"../../../../../../../doc/src/images/up.png" alt=
"Up"></a><a accesskey=
"h" href=
"../../../index.html"><img src=
"../../../../../../../doc/src/images/home.png" alt=
"Home"></a><a accesskey=
"n" href=
"../object.html"><img src=
"../../../../../../../doc/src/images/next.png" alt=
"Next"></a>