mirror of
https://github.com/boostorg/test.git
synced 2026-02-14 13:12:10 +00:00
58 lines
2.4 KiB
HTML
58 lines
2.4 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
|
<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 is the statement
|
|
to execute. 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">define</SPAN> BOOST_TEST_MAIN<BR>#<SPAN class="reserv-word">include</SPAN> <<SPAN class="literal">boost/test/unit_test.hpp</SPAN>><BR>
|
|
<SPAN class="reserv-word">class</SPAN> my_exception{};
|
|
|
|
BOOST_AUTO_TEST_CASE( test )
|
|
{
|
|
<SPAN class="cpp-type">int</SPAN> i = <SPAN class="literal"> 0</SPAN>;
|
|
BOOST_CHECK_THROW( i++, my_exception );
|
|
}</PRE>
|
|
<H4>Output:</H4>
|
|
<P class="test-output">Running 1 test case...<BR>
|
|
test.cpp(9): error in "test": exception my_exception is expected<BR>
|
|
<BR>
|
|
***
|
|
1 failure detected in test suite "Master Test Suite"</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-2006.
|
|
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) -->
|