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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
<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_EXCEPTION( statement, exception, predicate )<BR>
BOOST_CHECK_EXCEPTION( statement, exception, predicate )<BR>
BOOST_REQUIRE_EXCEPTION( statement, exception, predicate )</H3>
<P class="first-line-indented">These tools are used to perform an exception
detection and validation check. Tools execute the supplied statement
and check that it throw the supplied exception or it's child and that exception
comply to the supplied predicate. If the statement throw any other unrelated
exception, doesn't throw at all or predicate evaluates to <I>false</I> with
caught exception, check fails. In comparison with BOOST_<level>_THROW these
tools allow to perform more fine grained checks, for example that expected
exception has specific error message etc.</P>
<P class="first-line-indented">If check is successful, tools produce a confirmation
message. In case if no exception thrown it produces an
error message in a form "error in <test case name>: exception
<<I>exception</I>> expected. In case if exception does not comply to
specified predicate the tool produces an error message in a form "error
in <test case name>: incorrect exception
<<I>exception</I>> is caught.</P>
<P class="first-line-indented">The first parameter is 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.
The last third parameter is a predicate function used to validate caught
exception.</P>
<H4>Example: test.cpp</H4>
<PRE class="code"><SPAN class="reserv-word">struct</SPAN> my_exception {
<SPAN class="reserv-word">explicit</SPAN> my_exception( <SPAN class="cpp-type">int</SPAN> ec = <SPAN class="literal">0</SPAN> ) : m_error_code( EC ) {}
<SPAN class="cpp-type">int</SPAN> m_error_code;
};
<SPAN class="cpp-type">bool</SPAN> is_critical( my_exception <SPAN class="reserv-word">const</SPAN>& ex ) { <SPAN class="reserv-word">return </SPAN>ex.m_error_code < <SPAN class="literal">0</SPAN>; }
<SPAN class="reserv-word">
</SPAN><SPAN class="cpp-type">int</SPAN> test_main( <SPAN class="cpp-type">int</SPAN>, <SPAN class="cpp-type">char</SPAN>* [] ) {
BOOST_CHECK_EXCEPTION( throw my_exception( 1 ), my_exception, is_critical );
<SPAN class="reserv-word">return</SPAN> <SPAN class="literal">0</SPAN>;
}</PRE>
<H4>Output:</H4>
<P class="test-output">test.cpp(9) : error in test_main: incorrect exception my_exception is caught</P>
<DIV class="see_also">
<H4>See Also</H4>
<P class="see-also-content"><A href="BOOST_CHECK_THROW.html" target="descr">BOOST_CHECK_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) -->
|
