1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
<HTML>
<HEAD>
<TITLE>The Test Tools</TITLE>
<LINK rel="stylesheet" type="text/css" href="../../../style/btl.css" media="screen">
<LINK rel="stylesheet" type="text/css" href="../../../style/btl-print.css" media="print">
<META http-equiv="Content-Language" content="en-us">
<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<STYLE type="text/css">
H4
{
margin: 0px;
}
</STYLE>
</HEAD>
<BODY>
<DIV class="body">
<H3>BOOST_WARN_THROW( statement, exception )<BR>
BOOST_CHECK_THROW( statement, exception )<BR>
BOOST_REQUIRE_THROW( statement, exception )</H3>
<P class="first-line-indented">These tools are used to perform an exception
detection check. Tools execute the supplied statement and checks that
it throws the supplied exception or it's child. If the statement throw any
other unrelated exception or doesn't throw at all, check fails.</P>
<P class="first-line-indented">If check is successful, the tool produces a
confirmation message, in other case it produces an error message in a form "error
in <test case name>: exception <<I>exception</I>>
expected.</P>
<P class="first-line-indented">The first parameter the statement
to execute while checking for exception. Use block statement if you want
to execute more than one statement. The second parameter is an expected
exception.</P>
<H4>Example: test.cpp</H4>
<PRE class="code"><SPAN class="reserv-word">class</SPAN> my_exception{};
<SPAN class="cpp-type">int</SPAN> test_main( <SPAN class="cpp-type">int</SPAN>, <SPAN class="cpp-type">char</SPAN>* [] ) {
<SPAN class="cpp-type">int</SPAN> i = <SPAN class="literal"> 0</SPAN>;
BOOST_CHECK_THROW( i++, my_exception );
<SPAN class="reserv-word">return</SPAN> <SPAN class="literal">0</SPAN>;
}</PRE>
<H4>Output:</H4>
<P class="test-output">test.cpp(4) : error in test_main: exception my_exception expected</P>
<DIV class="see_also">
<H4>See Also</H4>
<P class="see-also-content"><A href="BOOST_CHECK_NO_THROW.html" target="descr">BOOST_CHECK_NO_THROW</A></P>
</DIV>
</DIV>
</BODY>
</HTML>
<!-- Copyright Gennadiy Rozental 2001-2005.
Distributed under the Boost Software License, Version 1.0.
(See accompanying file LICENSE_1_0.txt or copy at www.boost.org/LICENSE_1_0.txt) -->
|
