| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <html xmlns="http://www.w3.org/1999/xhtml"> |
| <head> |
| <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> |
| <meta http-equiv="X-UA-Compatible" content="IE=9"/> |
| <meta name="generator" content="Doxygen 1.8.14"/> |
| <meta name="viewport" content="width=device-width, initial-scale=1"/> |
| <title>Crashpad: test/gtest_death.h File Reference</title> |
| <link href="tabs.css" rel="stylesheet" type="text/css"/> |
| <script type="text/javascript" src="jquery.js"></script> |
| <script type="text/javascript" src="dynsections.js"></script> |
| <link href="search/search.css" rel="stylesheet" type="text/css"/> |
| <script type="text/javascript" src="search/searchdata.js"></script> |
| <script type="text/javascript" src="search/search.js"></script> |
| <link href="doxygen.css" rel="stylesheet" type="text/css" /> |
| <link href="crashpad_doxygen.css" rel="stylesheet" type="text/css"/> |
| </head> |
| <body> |
| <div id="top"><!-- do not remove this div, it is closed by doxygen! --> |
| <div id="titlearea"> |
| <table cellspacing="0" cellpadding="0"> |
| <tbody> |
| <tr style="height: 56px;"> |
| <td id="projectalign" style="padding-left: 0.5em;"> |
| <div id="projectname">Crashpad |
| </div> |
| </td> |
| </tr> |
| </tbody> |
| </table> |
| </div> |
| <!-- end header part --> |
| <!-- Generated by Doxygen 1.8.14 --> |
| <script type="text/javascript"> |
| /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ |
| var searchBox = new SearchBox("searchBox", "search",false,'Search'); |
| /* @license-end */ |
| </script> |
| <script type="text/javascript" src="menudata.js"></script> |
| <script type="text/javascript" src="menu.js"></script> |
| <script type="text/javascript"> |
| /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ |
| $(function() { |
| initMenu('',true,false,'search.php','Search'); |
| $(document).ready(function() { init_search(); }); |
| }); |
| /* @license-end */</script> |
| <div id="main-nav"></div> |
| <!-- window showing the filter options --> |
| <div id="MSearchSelectWindow" |
| onmouseover="return searchBox.OnSearchSelectShow()" |
| onmouseout="return searchBox.OnSearchSelectHide()" |
| onkeydown="return searchBox.OnSearchSelectKey(event)"> |
| </div> |
| |
| <!-- iframe showing the search results (closed by default) --> |
| <div id="MSearchResultsWindow"> |
| <iframe src="javascript:void(0)" frameborder="0" |
| name="MSearchResults" id="MSearchResults"> |
| </iframe> |
| </div> |
| |
| <div id="nav-path" class="navpath"> |
| <ul> |
| <li class="navelem"><a class="el" href="dir_13e138d54eb8818da29c3992edef070a.html">test</a></li> </ul> |
| </div> |
| </div><!-- top --> |
| <div class="header"> |
| <div class="summary"> |
| <a href="#define-members">Macros</a> </div> |
| <div class="headertitle"> |
| <div class="title">gtest_death.h File Reference</div> </div> |
| </div><!--header--> |
| <div class="contents"> |
| <div class="textblock"><code>#include "base/logging.h"</code><br /> |
| <code>#include "build/build_config.h"</code><br /> |
| <code>#include "gtest/gtest.h"</code><br /> |
| </div><table class="memberdecls"> |
| <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a> |
| Macros</h2></td></tr> |
| <tr class="memitem:a415e40b4d538d7421e1b0a43ddd3f83e"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="gtest__death_8h.html#a415e40b4d538d7421e1b0a43ddd3f83e">ASSERT_DEATH_CRASH</a>(statement, regex)</td></tr> |
| <tr class="memdesc:a415e40b4d538d7421e1b0a43ddd3f83e"><td class="mdescLeft"> </td><td class="mdescRight">Wraps the gtest <code>ASSERT_DEATH_IF_SUPPORTED()</code> macro to make assertions about death caused by crashes. <a href="#a415e40b4d538d7421e1b0a43ddd3f83e">More...</a><br /></td></tr> |
| <tr class="separator:a415e40b4d538d7421e1b0a43ddd3f83e"><td class="memSeparator" colspan="2"> </td></tr> |
| <tr class="memitem:a496cb27779b2120a1854e81375e9ae5f"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="gtest__death_8h.html#a496cb27779b2120a1854e81375e9ae5f">EXPECT_DEATH_CRASH</a>(statement, regex)</td></tr> |
| <tr class="memdesc:a496cb27779b2120a1854e81375e9ae5f"><td class="mdescLeft"> </td><td class="mdescRight">Wraps the gtest <code>EXPECT_DEATH_IF_SUPPORTED()</code> macro to make assertions about death caused by crashes. <a href="#a496cb27779b2120a1854e81375e9ae5f">More...</a><br /></td></tr> |
| <tr class="separator:a496cb27779b2120a1854e81375e9ae5f"><td class="memSeparator" colspan="2"> </td></tr> |
| <tr class="memitem:a11ab1a718cd7a7ed56b7e2fbd2c36f74"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="gtest__death_8h.html#a11ab1a718cd7a7ed56b7e2fbd2c36f74">ASSERT_DEATH_CHECK</a>(statement, regex)   <a class="el" href="gtest__death_8h.html#a415e40b4d538d7421e1b0a43ddd3f83e">ASSERT_DEATH_CRASH</a>(statement, regex)</td></tr> |
| <tr class="memdesc:a11ab1a718cd7a7ed56b7e2fbd2c36f74"><td class="mdescLeft"> </td><td class="mdescRight">Wraps the <a class="el" href="gtest__death_8h.html#a415e40b4d538d7421e1b0a43ddd3f83e" title="Wraps the gtest ASSERT_DEATH_IF_SUPPORTED() macro to make assertions about death caused by crashes...">ASSERT_DEATH_CRASH()</a> macro to make assertions about death caused by <code>CHECK()</code> failures. <a href="#a11ab1a718cd7a7ed56b7e2fbd2c36f74">More...</a><br /></td></tr> |
| <tr class="separator:a11ab1a718cd7a7ed56b7e2fbd2c36f74"><td class="memSeparator" colspan="2"> </td></tr> |
| <tr class="memitem:aa4bd7e1dbfc8862448a4b0fb66790e50"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="gtest__death_8h.html#aa4bd7e1dbfc8862448a4b0fb66790e50">EXPECT_DEATH_CHECK</a>(statement, regex)   <a class="el" href="gtest__death_8h.html#a496cb27779b2120a1854e81375e9ae5f">EXPECT_DEATH_CRASH</a>(statement, regex)</td></tr> |
| <tr class="memdesc:aa4bd7e1dbfc8862448a4b0fb66790e50"><td class="mdescLeft"> </td><td class="mdescRight">Wraps the <a class="el" href="gtest__death_8h.html#a496cb27779b2120a1854e81375e9ae5f" title="Wraps the gtest EXPECT_DEATH_IF_SUPPORTED() macro to make assertions about death caused by crashes...">EXPECT_DEATH_CRASH()</a> macro to make assertions about death caused by <code>CHECK()</code> failures. <a href="#aa4bd7e1dbfc8862448a4b0fb66790e50">More...</a><br /></td></tr> |
| <tr class="separator:aa4bd7e1dbfc8862448a4b0fb66790e50"><td class="memSeparator" colspan="2"> </td></tr> |
| </table> |
| <h2 class="groupheader">Macro Definition Documentation</h2> |
| <a id="a11ab1a718cd7a7ed56b7e2fbd2c36f74"></a> |
| <h2 class="memtitle"><span class="permalink"><a href="#a11ab1a718cd7a7ed56b7e2fbd2c36f74">◆ </a></span>ASSERT_DEATH_CHECK</h2> |
| |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">#define ASSERT_DEATH_CHECK</td> |
| <td>(</td> |
| <td class="paramtype"> </td> |
| <td class="paramname">statement, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype"> </td> |
| <td class="paramname">regex </td> |
| </tr> |
| <tr> |
| <td></td> |
| <td>)</td> |
| <td></td><td>   <a class="el" href="gtest__death_8h.html#a415e40b4d538d7421e1b0a43ddd3f83e">ASSERT_DEATH_CRASH</a>(statement, regex)</td> |
| </tr> |
| </table> |
| </div><div class="memdoc"> |
| |
| <p>Wraps the <a class="el" href="gtest__death_8h.html#a415e40b4d538d7421e1b0a43ddd3f83e" title="Wraps the gtest ASSERT_DEATH_IF_SUPPORTED() macro to make assertions about death caused by crashes...">ASSERT_DEATH_CRASH()</a> macro to make assertions about death caused by <code>CHECK()</code> failures. </p> |
| <p>In an in-Chromium build in the official configuration, <code>CHECK()</code> does not print its condition or streamed messages. In that case, this macro uses an empty <em>regex</em> pattern when calling <a class="el" href="gtest__death_8h.html#a415e40b4d538d7421e1b0a43ddd3f83e" title="Wraps the gtest ASSERT_DEATH_IF_SUPPORTED() macro to make assertions about death caused by crashes...">ASSERT_DEATH_CRASH()</a> to avoid looking for any particular output on the standard error stream. In other build configurations, the <em>regex</em> pattern is left intact.</p> |
| <p>On macOS, <code>CHECK()</code> failures normally show up as crashes to the system’s crash reporter, but it is undesirable for intentional <a class="el" href="gtest__death_8h.html#a11ab1a718cd7a7ed56b7e2fbd2c36f74" title="Wraps the ASSERT_DEATH_CRASH() macro to make assertions about death caused by CHECK() failures...">ASSERT_DEATH_CHECK()</a> crashes to be handled by any crash reporter, so this is implemented in terms of <a class="el" href="gtest__death_8h.html#a415e40b4d538d7421e1b0a43ddd3f83e" title="Wraps the gtest ASSERT_DEATH_IF_SUPPORTED() macro to make assertions about death caused by crashes...">ASSERT_DEATH_CRASH()</a> instead of <code>ASSERT_DEATH()</code>.</p> |
| <dl class="section see"><dt>See also</dt><dd><a class="el" href="gtest__death_8h.html#aa4bd7e1dbfc8862448a4b0fb66790e50" title="Wraps the EXPECT_DEATH_CRASH() macro to make assertions about death caused by CHECK() failures...">EXPECT_DEATH_CHECK()</a> </dd></dl> |
| |
| </div> |
| </div> |
| <a id="a415e40b4d538d7421e1b0a43ddd3f83e"></a> |
| <h2 class="memtitle"><span class="permalink"><a href="#a415e40b4d538d7421e1b0a43ddd3f83e">◆ </a></span>ASSERT_DEATH_CRASH</h2> |
| |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">#define ASSERT_DEATH_CRASH</td> |
| <td>(</td> |
| <td class="paramtype"> </td> |
| <td class="paramname">statement, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype"> </td> |
| <td class="paramname">regex </td> |
| </tr> |
| <tr> |
| <td></td> |
| <td>)</td> |
| <td></td><td></td> |
| </tr> |
| </table> |
| </div><div class="memdoc"> |
| <b>Value:</b><div class="fragment"><div class="line"><span class="keywordflow">do</span> { \</div><div class="line"> crashpad::test::ExceptionSwallower exception_swallower; \</div><div class="line"> ASSERT_DEATH_IF_SUPPORTED( \</div><div class="line"> <a class="code" href="classcrashpad_1_1test_1_1ExceptionSwallower.html#af7fdf8f0dca2bb2a34397d58283d3676">crashpad::test::ExceptionSwallower::SwallowExceptions</a>(); \</div><div class="line"> { statement; }, regex); \</div><div class="line"> } <span class="keywordflow">while</span> (<span class="keyword">false</span>)</div><div class="ttc" id="classcrashpad_1_1test_1_1ExceptionSwallower_html_af7fdf8f0dca2bb2a34397d58283d3676"><div class="ttname"><a href="classcrashpad_1_1test_1_1ExceptionSwallower.html#af7fdf8f0dca2bb2a34397d58283d3676">crashpad::test::ExceptionSwallower::SwallowExceptions</a></div><div class="ttdeci">static void SwallowExceptions()</div><div class="ttdoc">In a test child process, arranges to swallow EXC_CRASH and EXC_CORPSE_NOTIFY exceptions. </div><div class="ttdef"><b>Definition:</b> exception_swallower.cc:152</div></div> |
| </div><!-- fragment --> |
| <p>Wraps the gtest <code>ASSERT_DEATH_IF_SUPPORTED()</code> macro to make assertions about death caused by crashes. </p> |
| <p>On macOS, this macro prevents the system’s crash reporter from handling crashes that occur in <em>statement</em>. Crashes are normally visible to the system’s crash reporter, but it is undesirable for intentional <a class="el" href="gtest__death_8h.html#a415e40b4d538d7421e1b0a43ddd3f83e" title="Wraps the gtest ASSERT_DEATH_IF_SUPPORTED() macro to make assertions about death caused by crashes...">ASSERT_DEATH_CRASH()</a> crashes to be handled by any crash reporter.</p> |
| <p><code>ASSERT_DEATH_IF_SUPPORTED()</code> is used instead of <code>ASSERT_DEATH()</code> to support platforms where death tests are not implemented by gtest (e.g. Fuchsia). On platforms where death tests are not implemented, a warning will be logged and the remainder of the test body skipped.</p> |
| <dl class="section see"><dt>See also</dt><dd><a class="el" href="gtest__death_8h.html#a11ab1a718cd7a7ed56b7e2fbd2c36f74" title="Wraps the ASSERT_DEATH_CRASH() macro to make assertions about death caused by CHECK() failures...">ASSERT_DEATH_CHECK()</a> </dd> |
| <dd> |
| <a class="el" href="gtest__death_8h.html#a496cb27779b2120a1854e81375e9ae5f" title="Wraps the gtest EXPECT_DEATH_IF_SUPPORTED() macro to make assertions about death caused by crashes...">EXPECT_DEATH_CRASH()</a> </dd></dl> |
| |
| </div> |
| </div> |
| <a id="aa4bd7e1dbfc8862448a4b0fb66790e50"></a> |
| <h2 class="memtitle"><span class="permalink"><a href="#aa4bd7e1dbfc8862448a4b0fb66790e50">◆ </a></span>EXPECT_DEATH_CHECK</h2> |
| |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">#define EXPECT_DEATH_CHECK</td> |
| <td>(</td> |
| <td class="paramtype"> </td> |
| <td class="paramname">statement, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype"> </td> |
| <td class="paramname">regex </td> |
| </tr> |
| <tr> |
| <td></td> |
| <td>)</td> |
| <td></td><td>   <a class="el" href="gtest__death_8h.html#a496cb27779b2120a1854e81375e9ae5f">EXPECT_DEATH_CRASH</a>(statement, regex)</td> |
| </tr> |
| </table> |
| </div><div class="memdoc"> |
| |
| <p>Wraps the <a class="el" href="gtest__death_8h.html#a496cb27779b2120a1854e81375e9ae5f" title="Wraps the gtest EXPECT_DEATH_IF_SUPPORTED() macro to make assertions about death caused by crashes...">EXPECT_DEATH_CRASH()</a> macro to make assertions about death caused by <code>CHECK()</code> failures. </p> |
| <p>In an in-Chromium build in the official configuration, <code>CHECK()</code> does not print its condition or streamed messages. In that case, this macro uses an empty <em>regex</em> pattern when calling <a class="el" href="gtest__death_8h.html#a496cb27779b2120a1854e81375e9ae5f" title="Wraps the gtest EXPECT_DEATH_IF_SUPPORTED() macro to make assertions about death caused by crashes...">EXPECT_DEATH_CRASH()</a> to avoid looking for any particular output on the standard error stream. In other build configurations, the <em>regex</em> pattern is left intact.</p> |
| <p>On macOS, <code>CHECK()</code> failures normally show up as crashes to the system’s crash reporter, but it is undesirable for intentional <a class="el" href="gtest__death_8h.html#aa4bd7e1dbfc8862448a4b0fb66790e50" title="Wraps the EXPECT_DEATH_CRASH() macro to make assertions about death caused by CHECK() failures...">EXPECT_DEATH_CHECK()</a> crashes to be handled by any crash reporter, so this is implemented in terms of <a class="el" href="gtest__death_8h.html#a496cb27779b2120a1854e81375e9ae5f" title="Wraps the gtest EXPECT_DEATH_IF_SUPPORTED() macro to make assertions about death caused by crashes...">EXPECT_DEATH_CRASH()</a> instead of <code>EXPECT_DEATH()</code>.</p> |
| <dl class="section see"><dt>See also</dt><dd><a class="el" href="gtest__death_8h.html#a11ab1a718cd7a7ed56b7e2fbd2c36f74" title="Wraps the ASSERT_DEATH_CRASH() macro to make assertions about death caused by CHECK() failures...">ASSERT_DEATH_CHECK()</a> </dd></dl> |
| |
| </div> |
| </div> |
| <a id="a496cb27779b2120a1854e81375e9ae5f"></a> |
| <h2 class="memtitle"><span class="permalink"><a href="#a496cb27779b2120a1854e81375e9ae5f">◆ </a></span>EXPECT_DEATH_CRASH</h2> |
| |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">#define EXPECT_DEATH_CRASH</td> |
| <td>(</td> |
| <td class="paramtype"> </td> |
| <td class="paramname">statement, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype"> </td> |
| <td class="paramname">regex </td> |
| </tr> |
| <tr> |
| <td></td> |
| <td>)</td> |
| <td></td><td></td> |
| </tr> |
| </table> |
| </div><div class="memdoc"> |
| <b>Value:</b><div class="fragment"><div class="line"><span class="keywordflow">do</span> { \</div><div class="line"> crashpad::test::ExceptionSwallower exception_swallower; \</div><div class="line"> EXPECT_DEATH(<a class="code" href="classcrashpad_1_1test_1_1ExceptionSwallower.html#af7fdf8f0dca2bb2a34397d58283d3676">crashpad::test::ExceptionSwallower::SwallowExceptions</a>(); \</div><div class="line"> { statement; }, \</div><div class="line"> regex); \</div><div class="line"> } <span class="keywordflow">while</span> (<span class="keyword">false</span>)</div><div class="ttc" id="classcrashpad_1_1test_1_1ExceptionSwallower_html_af7fdf8f0dca2bb2a34397d58283d3676"><div class="ttname"><a href="classcrashpad_1_1test_1_1ExceptionSwallower.html#af7fdf8f0dca2bb2a34397d58283d3676">crashpad::test::ExceptionSwallower::SwallowExceptions</a></div><div class="ttdeci">static void SwallowExceptions()</div><div class="ttdoc">In a test child process, arranges to swallow EXC_CRASH and EXC_CORPSE_NOTIFY exceptions. </div><div class="ttdef"><b>Definition:</b> exception_swallower.cc:152</div></div> |
| </div><!-- fragment --> |
| <p>Wraps the gtest <code>EXPECT_DEATH_IF_SUPPORTED()</code> macro to make assertions about death caused by crashes. </p> |
| <p>On macOS, this macro prevents the system’s crash reporter from handling crashes that occur in <em>statement</em>. Crashes are normally visible to the system’s crash reporter, but it is undesirable for intentional <a class="el" href="gtest__death_8h.html#a496cb27779b2120a1854e81375e9ae5f" title="Wraps the gtest EXPECT_DEATH_IF_SUPPORTED() macro to make assertions about death caused by crashes...">EXPECT_DEATH_CRASH()</a> crashes to be handled by any crash reporter.</p> |
| <p><code>EXPECT_DEATH_IF_SUPPORTED()</code> is used instead of <code>EXPECT_DEATH()</code> to support platforms where death tests are not implemented by gtest (e.g. Fuchsia). On platforms where death tests are not implemented, a warning will be logged and the remainder of the test body skipped.</p> |
| <dl class="section see"><dt>See also</dt><dd><a class="el" href="gtest__death_8h.html#aa4bd7e1dbfc8862448a4b0fb66790e50" title="Wraps the EXPECT_DEATH_CRASH() macro to make assertions about death caused by CHECK() failures...">EXPECT_DEATH_CHECK()</a> </dd> |
| <dd> |
| <a class="el" href="gtest__death_8h.html#a415e40b4d538d7421e1b0a43ddd3f83e" title="Wraps the gtest ASSERT_DEATH_IF_SUPPORTED() macro to make assertions about death caused by crashes...">ASSERT_DEATH_CRASH()</a> </dd></dl> |
| |
| </div> |
| </div> |
| </div><!-- contents --> |
| <!-- start footer part --> |
| <hr class="footer"/><address class="footer"><small> |
| Generated by  <a href="http://www.doxygen.org/index.html"> |
| <img class="footer" src="doxygen.png" alt="doxygen"/> |
| </a> 1.8.14 |
| </small></address> |
| </body> |
| </html> |