mirror of
https://github.com/boostorg/test.git
synced 2026-01-26 19:12:10 +00:00
47 lines
2.3 KiB
HTML
47 lines
2.3 KiB
HTML
<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_REQUIRE( predicate )</H3>
|
|
<P class="first-line-indented">This tool is used to validate the predicate value and abort the current
|
|
test case processing if it fails. </P>
|
|
<P class="first-line-indented">If predicate evaluates to <I>true</I>, the tool produces a confirmation
|
|
message (note: to manage what messages appear in the test output stream set the proper log level),
|
|
in other case it produces an error message in a form "fatal error in <test case name>:
|
|
test <predicate> fail" and then abort the current test case processing.</P>
|
|
<P class="first-line-indented">The only parameter of this tool is the boolean predicate value that gets
|
|
validated. This could be any expression that could be evaluated and converted to boolean value. The
|
|
expression gets evaluated only once, so it's safe to pass complex expression for validation.</P>
|
|
<H4>Example: test.cpp</H4>
|
|
<PRE class="code"><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">3</SPAN>;
|
|
BOOST_REQUIRE( i > <SPAN class="literal">5</SPAN> );
|
|
BOOST_CHECK( i == <SPAN class="literal">6</SPAN> ); <SPAN class="comment">// will never reach this check</SPAN>
|
|
|
|
<SPAN class="reserv-word">return</SPAN> <SPAN class="literal">0</SPAN>;
|
|
}</PRE>
|
|
<H4>Output:</H4>
|
|
<P class="test-output">test.cpp(3) : fatal error in test_main: test i>5 failed </P>
|
|
<DIV class="see_also">
|
|
<H4>See Also</H4>
|
|
<P class="see-also-content"><A href="BOOST_CHECK.html" target="descr">BOOST_CHECK</A></P>
|
|
</DIV>
|
|
</DIV>
|
|
</BODY>
|
|
</HTML>
|
|
<!-- Copyright Gennadiy Rozental 2001-2004.
|
|
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) -->
|