You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2432 lines
293 KiB
2432 lines
293 KiB
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
|
|
<html lang="en">
|
|
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
<title>LCOV - test.info - /usr/include/gtest/gtest.h</title>
|
|
<link rel="stylesheet" type="text/css" href="../../../gcov.css">
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<table width="100%" border=0 cellspacing=0 cellpadding=0>
|
|
<tr><td class="title">LCOV - code coverage report</td></tr>
|
|
<tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
|
|
|
|
<tr>
|
|
<td width="100%">
|
|
<table cellpadding=1 border=0 width="100%">
|
|
<tr>
|
|
<td width="10%" class="headerItem">Current view:</td>
|
|
<td width="35%" class="headerValue"><a href="../../../index.html">top level</a> - <a href="index.html">usr/include/gtest</a> - gtest.h<span style="font-size: 80%;"> (source / <a href="gtest.h.func-sort-c.html">functions</a>)</span></td>
|
|
<td width="5%"></td>
|
|
<td width="15%"></td>
|
|
<td width="10%" class="headerCovTableHead">Hit</td>
|
|
<td width="10%" class="headerCovTableHead">Total</td>
|
|
<td width="15%" class="headerCovTableHead">Coverage</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="headerItem">Test:</td>
|
|
<td class="headerValue">test.info</td>
|
|
<td></td>
|
|
<td class="headerItem">Lines:</td>
|
|
<td class="headerCovTableEntry">10</td>
|
|
<td class="headerCovTableEntry">17</td>
|
|
<td class="headerCovTableEntryLo">58.8 %</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="headerItem">Date:</td>
|
|
<td class="headerValue">2022-06-07 00:30:42</td>
|
|
<td></td>
|
|
<td class="headerItem">Functions:</td>
|
|
<td class="headerCovTableEntry">8</td>
|
|
<td class="headerCovTableEntry">13</td>
|
|
<td class="headerCovTableEntryLo">61.5 %</td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td></td>
|
|
<td></td>
|
|
<td class="headerItem">Branches:</td>
|
|
<td class="headerCovTableEntry">1</td>
|
|
<td class="headerCovTableEntry">8</td>
|
|
<td class="headerCovTableEntryLo">12.5 %</td>
|
|
</tr>
|
|
<tr><td><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
|
|
</table>
|
|
|
|
<table cellpadding=0 cellspacing=0 border=0>
|
|
<tr>
|
|
<td><br></td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<pre class="sourceHeading"> Branch data Line data Source code</pre>
|
|
<pre class="source">
|
|
<a name="1"><span class="lineNum"> 1 </span> : : // Copyright 2005, Google Inc.</a>
|
|
<a name="2"><span class="lineNum"> 2 </span> : : // All rights reserved.</a>
|
|
<a name="3"><span class="lineNum"> 3 </span> : : //</a>
|
|
<a name="4"><span class="lineNum"> 4 </span> : : // Redistribution and use in source and binary forms, with or without</a>
|
|
<a name="5"><span class="lineNum"> 5 </span> : : // modification, are permitted provided that the following conditions are</a>
|
|
<a name="6"><span class="lineNum"> 6 </span> : : // met:</a>
|
|
<a name="7"><span class="lineNum"> 7 </span> : : //</a>
|
|
<a name="8"><span class="lineNum"> 8 </span> : : // * Redistributions of source code must retain the above copyright</a>
|
|
<a name="9"><span class="lineNum"> 9 </span> : : // notice, this list of conditions and the following disclaimer.</a>
|
|
<a name="10"><span class="lineNum"> 10 </span> : : // * Redistributions in binary form must reproduce the above</a>
|
|
<a name="11"><span class="lineNum"> 11 </span> : : // copyright notice, this list of conditions and the following disclaimer</a>
|
|
<a name="12"><span class="lineNum"> 12 </span> : : // in the documentation and/or other materials provided with the</a>
|
|
<a name="13"><span class="lineNum"> 13 </span> : : // distribution.</a>
|
|
<a name="14"><span class="lineNum"> 14 </span> : : // * Neither the name of Google Inc. nor the names of its</a>
|
|
<a name="15"><span class="lineNum"> 15 </span> : : // contributors may be used to endorse or promote products derived from</a>
|
|
<a name="16"><span class="lineNum"> 16 </span> : : // this software without specific prior written permission.</a>
|
|
<a name="17"><span class="lineNum"> 17 </span> : : //</a>
|
|
<a name="18"><span class="lineNum"> 18 </span> : : // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS</a>
|
|
<a name="19"><span class="lineNum"> 19 </span> : : // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT</a>
|
|
<a name="20"><span class="lineNum"> 20 </span> : : // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR</a>
|
|
<a name="21"><span class="lineNum"> 21 </span> : : // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT</a>
|
|
<a name="22"><span class="lineNum"> 22 </span> : : // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,</a>
|
|
<a name="23"><span class="lineNum"> 23 </span> : : // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT</a>
|
|
<a name="24"><span class="lineNum"> 24 </span> : : // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,</a>
|
|
<a name="25"><span class="lineNum"> 25 </span> : : // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY</a>
|
|
<a name="26"><span class="lineNum"> 26 </span> : : // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT</a>
|
|
<a name="27"><span class="lineNum"> 27 </span> : : // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE</a>
|
|
<a name="28"><span class="lineNum"> 28 </span> : : // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</a>
|
|
<a name="29"><span class="lineNum"> 29 </span> : : </a>
|
|
<a name="30"><span class="lineNum"> 30 </span> : : //</a>
|
|
<a name="31"><span class="lineNum"> 31 </span> : : // The Google C++ Testing and Mocking Framework (Google Test)</a>
|
|
<a name="32"><span class="lineNum"> 32 </span> : : //</a>
|
|
<a name="33"><span class="lineNum"> 33 </span> : : // This header file defines the public API for Google Test. It should be</a>
|
|
<a name="34"><span class="lineNum"> 34 </span> : : // included by any test program that uses Google Test.</a>
|
|
<a name="35"><span class="lineNum"> 35 </span> : : //</a>
|
|
<a name="36"><span class="lineNum"> 36 </span> : : // IMPORTANT NOTE: Due to limitation of the C++ language, we have to</a>
|
|
<a name="37"><span class="lineNum"> 37 </span> : : // leave some internal implementation details in this header file.</a>
|
|
<a name="38"><span class="lineNum"> 38 </span> : : // They are clearly marked by comments like this:</a>
|
|
<a name="39"><span class="lineNum"> 39 </span> : : //</a>
|
|
<a name="40"><span class="lineNum"> 40 </span> : : // // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="41"><span class="lineNum"> 41 </span> : : //</a>
|
|
<a name="42"><span class="lineNum"> 42 </span> : : // Such code is NOT meant to be used by a user directly, and is subject</a>
|
|
<a name="43"><span class="lineNum"> 43 </span> : : // to CHANGE WITHOUT NOTICE. Therefore DO NOT DEPEND ON IT in a user</a>
|
|
<a name="44"><span class="lineNum"> 44 </span> : : // program!</a>
|
|
<a name="45"><span class="lineNum"> 45 </span> : : //</a>
|
|
<a name="46"><span class="lineNum"> 46 </span> : : // Acknowledgment: Google Test borrowed the idea of automatic test</a>
|
|
<a name="47"><span class="lineNum"> 47 </span> : : // registration from Barthelemy Dagenais' (barthelemy@prologique.com)</a>
|
|
<a name="48"><span class="lineNum"> 48 </span> : : // easyUnit framework.</a>
|
|
<a name="49"><span class="lineNum"> 49 </span> : : </a>
|
|
<a name="50"><span class="lineNum"> 50 </span> : : // GOOGLETEST_CM0001 DO NOT DELETE</a>
|
|
<a name="51"><span class="lineNum"> 51 </span> : : </a>
|
|
<a name="52"><span class="lineNum"> 52 </span> : : #ifndef GTEST_INCLUDE_GTEST_GTEST_H_</a>
|
|
<a name="53"><span class="lineNum"> 53 </span> : : #define GTEST_INCLUDE_GTEST_GTEST_H_</a>
|
|
<a name="54"><span class="lineNum"> 54 </span> : : </a>
|
|
<a name="55"><span class="lineNum"> 55 </span> : : #include <limits></a>
|
|
<a name="56"><span class="lineNum"> 56 </span> : : #include <ostream></a>
|
|
<a name="57"><span class="lineNum"> 57 </span> : : #include <vector></a>
|
|
<a name="58"><span class="lineNum"> 58 </span> : : </a>
|
|
<a name="59"><span class="lineNum"> 59 </span> : : #include "gtest/internal/gtest-internal.h"</a>
|
|
<a name="60"><span class="lineNum"> 60 </span> : : #include "gtest/internal/gtest-string.h"</a>
|
|
<a name="61"><span class="lineNum"> 61 </span> : : #include "gtest/gtest-death-test.h"</a>
|
|
<a name="62"><span class="lineNum"> 62 </span> : : #include "gtest/gtest-message.h"</a>
|
|
<a name="63"><span class="lineNum"> 63 </span> : : #include "gtest/gtest-param-test.h"</a>
|
|
<a name="64"><span class="lineNum"> 64 </span> : : #include "gtest/gtest-printers.h"</a>
|
|
<a name="65"><span class="lineNum"> 65 </span> : : #include "gtest/gtest_prod.h"</a>
|
|
<a name="66"><span class="lineNum"> 66 </span> : : #include "gtest/gtest-test-part.h"</a>
|
|
<a name="67"><span class="lineNum"> 67 </span> : : #include "gtest/gtest-typed-test.h"</a>
|
|
<a name="68"><span class="lineNum"> 68 </span> : : </a>
|
|
<a name="69"><span class="lineNum"> 69 </span> : : GTEST_DISABLE_MSC_WARNINGS_PUSH_(4251 \</a>
|
|
<a name="70"><span class="lineNum"> 70 </span> : : /* class A needs to have dll-interface to be used by clients of class B */)</a>
|
|
<a name="71"><span class="lineNum"> 71 </span> : : </a>
|
|
<a name="72"><span class="lineNum"> 72 </span> : : // Depending on the platform, different string classes are available.</a>
|
|
<a name="73"><span class="lineNum"> 73 </span> : : // On Linux, in addition to ::std::string, Google also makes use of</a>
|
|
<a name="74"><span class="lineNum"> 74 </span> : : // class ::string, which has the same interface as ::std::string, but</a>
|
|
<a name="75"><span class="lineNum"> 75 </span> : : // has a different implementation.</a>
|
|
<a name="76"><span class="lineNum"> 76 </span> : : //</a>
|
|
<a name="77"><span class="lineNum"> 77 </span> : : // You can define GTEST_HAS_GLOBAL_STRING to 1 to indicate that</a>
|
|
<a name="78"><span class="lineNum"> 78 </span> : : // ::string is available AND is a distinct type to ::std::string, or</a>
|
|
<a name="79"><span class="lineNum"> 79 </span> : : // define it to 0 to indicate otherwise.</a>
|
|
<a name="80"><span class="lineNum"> 80 </span> : : //</a>
|
|
<a name="81"><span class="lineNum"> 81 </span> : : // If ::std::string and ::string are the same class on your platform</a>
|
|
<a name="82"><span class="lineNum"> 82 </span> : : // due to aliasing, you should define GTEST_HAS_GLOBAL_STRING to 0.</a>
|
|
<a name="83"><span class="lineNum"> 83 </span> : : //</a>
|
|
<a name="84"><span class="lineNum"> 84 </span> : : // If you do not define GTEST_HAS_GLOBAL_STRING, it is defined</a>
|
|
<a name="85"><span class="lineNum"> 85 </span> : : // heuristically.</a>
|
|
<a name="86"><span class="lineNum"> 86 </span> : : </a>
|
|
<a name="87"><span class="lineNum"> 87 </span> : : namespace testing {</a>
|
|
<a name="88"><span class="lineNum"> 88 </span> : : </a>
|
|
<a name="89"><span class="lineNum"> 89 </span> : : // Silence C4100 (unreferenced formal parameter) and 4805</a>
|
|
<a name="90"><span class="lineNum"> 90 </span> : : // unsafe mix of type 'const int' and type 'const bool'</a>
|
|
<a name="91"><span class="lineNum"> 91 </span> : : #ifdef _MSC_VER</a>
|
|
<a name="92"><span class="lineNum"> 92 </span> : : # pragma warning(push)</a>
|
|
<a name="93"><span class="lineNum"> 93 </span> : : # pragma warning(disable:4805)</a>
|
|
<a name="94"><span class="lineNum"> 94 </span> : : # pragma warning(disable:4100)</a>
|
|
<a name="95"><span class="lineNum"> 95 </span> : : #endif</a>
|
|
<a name="96"><span class="lineNum"> 96 </span> : : </a>
|
|
<a name="97"><span class="lineNum"> 97 </span> : : </a>
|
|
<a name="98"><span class="lineNum"> 98 </span> : : // Declares the flags.</a>
|
|
<a name="99"><span class="lineNum"> 99 </span> : : </a>
|
|
<a name="100"><span class="lineNum"> 100 </span> : : // This flag temporary enables the disabled tests.</a>
|
|
<a name="101"><span class="lineNum"> 101 </span> : : GTEST_DECLARE_bool_(also_run_disabled_tests);</a>
|
|
<a name="102"><span class="lineNum"> 102 </span> : : </a>
|
|
<a name="103"><span class="lineNum"> 103 </span> : : // This flag brings the debugger on an assertion failure.</a>
|
|
<a name="104"><span class="lineNum"> 104 </span> : : GTEST_DECLARE_bool_(break_on_failure);</a>
|
|
<a name="105"><span class="lineNum"> 105 </span> : : </a>
|
|
<a name="106"><span class="lineNum"> 106 </span> : : // This flag controls whether Google Test catches all test-thrown exceptions</a>
|
|
<a name="107"><span class="lineNum"> 107 </span> : : // and logs them as failures.</a>
|
|
<a name="108"><span class="lineNum"> 108 </span> : : GTEST_DECLARE_bool_(catch_exceptions);</a>
|
|
<a name="109"><span class="lineNum"> 109 </span> : : </a>
|
|
<a name="110"><span class="lineNum"> 110 </span> : : // This flag enables using colors in terminal output. Available values are</a>
|
|
<a name="111"><span class="lineNum"> 111 </span> : : // "yes" to enable colors, "no" (disable colors), or "auto" (the default)</a>
|
|
<a name="112"><span class="lineNum"> 112 </span> : : // to let Google Test decide.</a>
|
|
<a name="113"><span class="lineNum"> 113 </span> : : GTEST_DECLARE_string_(color);</a>
|
|
<a name="114"><span class="lineNum"> 114 </span> : : </a>
|
|
<a name="115"><span class="lineNum"> 115 </span> : : // This flag sets up the filter to select by name using a glob pattern</a>
|
|
<a name="116"><span class="lineNum"> 116 </span> : : // the tests to run. If the filter is not given all tests are executed.</a>
|
|
<a name="117"><span class="lineNum"> 117 </span> : : GTEST_DECLARE_string_(filter);</a>
|
|
<a name="118"><span class="lineNum"> 118 </span> : : </a>
|
|
<a name="119"><span class="lineNum"> 119 </span> : : // This flag controls whether Google Test installs a signal handler that dumps</a>
|
|
<a name="120"><span class="lineNum"> 120 </span> : : // debugging information when fatal signals are raised.</a>
|
|
<a name="121"><span class="lineNum"> 121 </span> : : GTEST_DECLARE_bool_(install_failure_signal_handler);</a>
|
|
<a name="122"><span class="lineNum"> 122 </span> : : </a>
|
|
<a name="123"><span class="lineNum"> 123 </span> : : // This flag causes the Google Test to list tests. None of the tests listed</a>
|
|
<a name="124"><span class="lineNum"> 124 </span> : : // are actually run if the flag is provided.</a>
|
|
<a name="125"><span class="lineNum"> 125 </span> : : GTEST_DECLARE_bool_(list_tests);</a>
|
|
<a name="126"><span class="lineNum"> 126 </span> : : </a>
|
|
<a name="127"><span class="lineNum"> 127 </span> : : // This flag controls whether Google Test emits a detailed XML report to a file</a>
|
|
<a name="128"><span class="lineNum"> 128 </span> : : // in addition to its normal textual output.</a>
|
|
<a name="129"><span class="lineNum"> 129 </span> : : GTEST_DECLARE_string_(output);</a>
|
|
<a name="130"><span class="lineNum"> 130 </span> : : </a>
|
|
<a name="131"><span class="lineNum"> 131 </span> : : // This flags control whether Google Test prints the elapsed time for each</a>
|
|
<a name="132"><span class="lineNum"> 132 </span> : : // test.</a>
|
|
<a name="133"><span class="lineNum"> 133 </span> : : GTEST_DECLARE_bool_(print_time);</a>
|
|
<a name="134"><span class="lineNum"> 134 </span> : : </a>
|
|
<a name="135"><span class="lineNum"> 135 </span> : : // This flags control whether Google Test prints UTF8 characters as text.</a>
|
|
<a name="136"><span class="lineNum"> 136 </span> : : GTEST_DECLARE_bool_(print_utf8);</a>
|
|
<a name="137"><span class="lineNum"> 137 </span> : : </a>
|
|
<a name="138"><span class="lineNum"> 138 </span> : : // This flag specifies the random number seed.</a>
|
|
<a name="139"><span class="lineNum"> 139 </span> : : GTEST_DECLARE_int32_(random_seed);</a>
|
|
<a name="140"><span class="lineNum"> 140 </span> : : </a>
|
|
<a name="141"><span class="lineNum"> 141 </span> : : // This flag sets how many times the tests are repeated. The default value</a>
|
|
<a name="142"><span class="lineNum"> 142 </span> : : // is 1. If the value is -1 the tests are repeating forever.</a>
|
|
<a name="143"><span class="lineNum"> 143 </span> : : GTEST_DECLARE_int32_(repeat);</a>
|
|
<a name="144"><span class="lineNum"> 144 </span> : : </a>
|
|
<a name="145"><span class="lineNum"> 145 </span> : : // This flag controls whether Google Test includes Google Test internal</a>
|
|
<a name="146"><span class="lineNum"> 146 </span> : : // stack frames in failure stack traces.</a>
|
|
<a name="147"><span class="lineNum"> 147 </span> : : GTEST_DECLARE_bool_(show_internal_stack_frames);</a>
|
|
<a name="148"><span class="lineNum"> 148 </span> : : </a>
|
|
<a name="149"><span class="lineNum"> 149 </span> : : // When this flag is specified, tests' order is randomized on every iteration.</a>
|
|
<a name="150"><span class="lineNum"> 150 </span> : : GTEST_DECLARE_bool_(shuffle);</a>
|
|
<a name="151"><span class="lineNum"> 151 </span> : : </a>
|
|
<a name="152"><span class="lineNum"> 152 </span> : : // This flag specifies the maximum number of stack frames to be</a>
|
|
<a name="153"><span class="lineNum"> 153 </span> : : // printed in a failure message.</a>
|
|
<a name="154"><span class="lineNum"> 154 </span> : : GTEST_DECLARE_int32_(stack_trace_depth);</a>
|
|
<a name="155"><span class="lineNum"> 155 </span> : : </a>
|
|
<a name="156"><span class="lineNum"> 156 </span> : : // When this flag is specified, a failed assertion will throw an</a>
|
|
<a name="157"><span class="lineNum"> 157 </span> : : // exception if exceptions are enabled, or exit the program with a</a>
|
|
<a name="158"><span class="lineNum"> 158 </span> : : // non-zero code otherwise. For use with an external test framework.</a>
|
|
<a name="159"><span class="lineNum"> 159 </span> : : GTEST_DECLARE_bool_(throw_on_failure);</a>
|
|
<a name="160"><span class="lineNum"> 160 </span> : : </a>
|
|
<a name="161"><span class="lineNum"> 161 </span> : : // When this flag is set with a "host:port" string, on supported</a>
|
|
<a name="162"><span class="lineNum"> 162 </span> : : // platforms test results are streamed to the specified port on</a>
|
|
<a name="163"><span class="lineNum"> 163 </span> : : // the specified host machine.</a>
|
|
<a name="164"><span class="lineNum"> 164 </span> : : GTEST_DECLARE_string_(stream_result_to);</a>
|
|
<a name="165"><span class="lineNum"> 165 </span> : : </a>
|
|
<a name="166"><span class="lineNum"> 166 </span> : : #if GTEST_USE_OWN_FLAGFILE_FLAG_</a>
|
|
<a name="167"><span class="lineNum"> 167 </span> : : GTEST_DECLARE_string_(flagfile);</a>
|
|
<a name="168"><span class="lineNum"> 168 </span> : : #endif // GTEST_USE_OWN_FLAGFILE_FLAG_</a>
|
|
<a name="169"><span class="lineNum"> 169 </span> : : </a>
|
|
<a name="170"><span class="lineNum"> 170 </span> : : // The upper limit for valid stack trace depths.</a>
|
|
<a name="171"><span class="lineNum"> 171 </span> : : const int kMaxStackTraceDepth = 100;</a>
|
|
<a name="172"><span class="lineNum"> 172 </span> : : </a>
|
|
<a name="173"><span class="lineNum"> 173 </span> : : namespace internal {</a>
|
|
<a name="174"><span class="lineNum"> 174 </span> : : </a>
|
|
<a name="175"><span class="lineNum"> 175 </span> : : class AssertHelper;</a>
|
|
<a name="176"><span class="lineNum"> 176 </span> : : class DefaultGlobalTestPartResultReporter;</a>
|
|
<a name="177"><span class="lineNum"> 177 </span> : : class ExecDeathTest;</a>
|
|
<a name="178"><span class="lineNum"> 178 </span> : : class NoExecDeathTest;</a>
|
|
<a name="179"><span class="lineNum"> 179 </span> : : class FinalSuccessChecker;</a>
|
|
<a name="180"><span class="lineNum"> 180 </span> : : class GTestFlagSaver;</a>
|
|
<a name="181"><span class="lineNum"> 181 </span> : : class StreamingListenerTest;</a>
|
|
<a name="182"><span class="lineNum"> 182 </span> : : class TestResultAccessor;</a>
|
|
<a name="183"><span class="lineNum"> 183 </span> : : class TestEventListenersAccessor;</a>
|
|
<a name="184"><span class="lineNum"> 184 </span> : : class TestEventRepeater;</a>
|
|
<a name="185"><span class="lineNum"> 185 </span> : : class UnitTestRecordPropertyTestHelper;</a>
|
|
<a name="186"><span class="lineNum"> 186 </span> : : class WindowsDeathTest;</a>
|
|
<a name="187"><span class="lineNum"> 187 </span> : : class FuchsiaDeathTest;</a>
|
|
<a name="188"><span class="lineNum"> 188 </span> : : class UnitTestImpl* GetUnitTestImpl();</a>
|
|
<a name="189"><span class="lineNum"> 189 </span> : : void ReportFailureInUnknownLocation(TestPartResult::Type result_type,</a>
|
|
<a name="190"><span class="lineNum"> 190 </span> : : const std::string& message);</a>
|
|
<a name="191"><span class="lineNum"> 191 </span> : : </a>
|
|
<a name="192"><span class="lineNum"> 192 </span> : : } // namespace internal</a>
|
|
<a name="193"><span class="lineNum"> 193 </span> : : </a>
|
|
<a name="194"><span class="lineNum"> 194 </span> : : // The friend relationship of some of these classes is cyclic.</a>
|
|
<a name="195"><span class="lineNum"> 195 </span> : : // If we don't forward declare them the compiler might confuse the classes</a>
|
|
<a name="196"><span class="lineNum"> 196 </span> : : // in friendship clauses with same named classes on the scope.</a>
|
|
<a name="197"><span class="lineNum"> 197 </span> : : class Test;</a>
|
|
<a name="198"><span class="lineNum"> 198 </span> : : class TestCase;</a>
|
|
<a name="199"><span class="lineNum"> 199 </span> : : class TestInfo;</a>
|
|
<a name="200"><span class="lineNum"> 200 </span> : : class UnitTest;</a>
|
|
<a name="201"><span class="lineNum"> 201 </span> : : </a>
|
|
<a name="202"><span class="lineNum"> 202 </span> : : // A class for indicating whether an assertion was successful. When</a>
|
|
<a name="203"><span class="lineNum"> 203 </span> : : // the assertion wasn't successful, the AssertionResult object</a>
|
|
<a name="204"><span class="lineNum"> 204 </span> : : // remembers a non-empty message that describes how it failed.</a>
|
|
<a name="205"><span class="lineNum"> 205 </span> : : //</a>
|
|
<a name="206"><span class="lineNum"> 206 </span> : : // To create an instance of this class, use one of the factory functions</a>
|
|
<a name="207"><span class="lineNum"> 207 </span> : : // (AssertionSuccess() and AssertionFailure()).</a>
|
|
<a name="208"><span class="lineNum"> 208 </span> : : //</a>
|
|
<a name="209"><span class="lineNum"> 209 </span> : : // This class is useful for two purposes:</a>
|
|
<a name="210"><span class="lineNum"> 210 </span> : : // 1. Defining predicate functions to be used with Boolean test assertions</a>
|
|
<a name="211"><span class="lineNum"> 211 </span> : : // EXPECT_TRUE/EXPECT_FALSE and their ASSERT_ counterparts</a>
|
|
<a name="212"><span class="lineNum"> 212 </span> : : // 2. Defining predicate-format functions to be</a>
|
|
<a name="213"><span class="lineNum"> 213 </span> : : // used with predicate assertions (ASSERT_PRED_FORMAT*, etc).</a>
|
|
<a name="214"><span class="lineNum"> 214 </span> : : //</a>
|
|
<a name="215"><span class="lineNum"> 215 </span> : : // For example, if you define IsEven predicate:</a>
|
|
<a name="216"><span class="lineNum"> 216 </span> : : //</a>
|
|
<a name="217"><span class="lineNum"> 217 </span> : : // testing::AssertionResult IsEven(int n) {</a>
|
|
<a name="218"><span class="lineNum"> 218 </span> : : // if ((n % 2) == 0)</a>
|
|
<a name="219"><span class="lineNum"> 219 </span> : : // return testing::AssertionSuccess();</a>
|
|
<a name="220"><span class="lineNum"> 220 </span> : : // else</a>
|
|
<a name="221"><span class="lineNum"> 221 </span> : : // return testing::AssertionFailure() << n << " is odd";</a>
|
|
<a name="222"><span class="lineNum"> 222 </span> : : // }</a>
|
|
<a name="223"><span class="lineNum"> 223 </span> : : //</a>
|
|
<a name="224"><span class="lineNum"> 224 </span> : : // Then the failed expectation EXPECT_TRUE(IsEven(Fib(5)))</a>
|
|
<a name="225"><span class="lineNum"> 225 </span> : : // will print the message</a>
|
|
<a name="226"><span class="lineNum"> 226 </span> : : //</a>
|
|
<a name="227"><span class="lineNum"> 227 </span> : : // Value of: IsEven(Fib(5))</a>
|
|
<a name="228"><span class="lineNum"> 228 </span> : : // Actual: false (5 is odd)</a>
|
|
<a name="229"><span class="lineNum"> 229 </span> : : // Expected: true</a>
|
|
<a name="230"><span class="lineNum"> 230 </span> : : //</a>
|
|
<a name="231"><span class="lineNum"> 231 </span> : : // instead of a more opaque</a>
|
|
<a name="232"><span class="lineNum"> 232 </span> : : //</a>
|
|
<a name="233"><span class="lineNum"> 233 </span> : : // Value of: IsEven(Fib(5))</a>
|
|
<a name="234"><span class="lineNum"> 234 </span> : : // Actual: false</a>
|
|
<a name="235"><span class="lineNum"> 235 </span> : : // Expected: true</a>
|
|
<a name="236"><span class="lineNum"> 236 </span> : : //</a>
|
|
<a name="237"><span class="lineNum"> 237 </span> : : // in case IsEven is a simple Boolean predicate.</a>
|
|
<a name="238"><span class="lineNum"> 238 </span> : : //</a>
|
|
<a name="239"><span class="lineNum"> 239 </span> : : // If you expect your predicate to be reused and want to support informative</a>
|
|
<a name="240"><span class="lineNum"> 240 </span> : : // messages in EXPECT_FALSE and ASSERT_FALSE (negative assertions show up</a>
|
|
<a name="241"><span class="lineNum"> 241 </span> : : // about half as often as positive ones in our tests), supply messages for</a>
|
|
<a name="242"><span class="lineNum"> 242 </span> : : // both success and failure cases:</a>
|
|
<a name="243"><span class="lineNum"> 243 </span> : : //</a>
|
|
<a name="244"><span class="lineNum"> 244 </span> : : // testing::AssertionResult IsEven(int n) {</a>
|
|
<a name="245"><span class="lineNum"> 245 </span> : : // if ((n % 2) == 0)</a>
|
|
<a name="246"><span class="lineNum"> 246 </span> : : // return testing::AssertionSuccess() << n << " is even";</a>
|
|
<a name="247"><span class="lineNum"> 247 </span> : : // else</a>
|
|
<a name="248"><span class="lineNum"> 248 </span> : : // return testing::AssertionFailure() << n << " is odd";</a>
|
|
<a name="249"><span class="lineNum"> 249 </span> : : // }</a>
|
|
<a name="250"><span class="lineNum"> 250 </span> : : //</a>
|
|
<a name="251"><span class="lineNum"> 251 </span> : : // Then a statement EXPECT_FALSE(IsEven(Fib(6))) will print</a>
|
|
<a name="252"><span class="lineNum"> 252 </span> : : //</a>
|
|
<a name="253"><span class="lineNum"> 253 </span> : : // Value of: IsEven(Fib(6))</a>
|
|
<a name="254"><span class="lineNum"> 254 </span> : : // Actual: true (8 is even)</a>
|
|
<a name="255"><span class="lineNum"> 255 </span> : : // Expected: false</a>
|
|
<a name="256"><span class="lineNum"> 256 </span> : : //</a>
|
|
<a name="257"><span class="lineNum"> 257 </span> : : // NB: Predicates that support negative Boolean assertions have reduced</a>
|
|
<a name="258"><span class="lineNum"> 258 </span> : : // performance in positive ones so be careful not to use them in tests</a>
|
|
<a name="259"><span class="lineNum"> 259 </span> : : // that have lots (tens of thousands) of positive Boolean assertions.</a>
|
|
<a name="260"><span class="lineNum"> 260 </span> : : //</a>
|
|
<a name="261"><span class="lineNum"> 261 </span> : : // To use this class with EXPECT_PRED_FORMAT assertions such as:</a>
|
|
<a name="262"><span class="lineNum"> 262 </span> : : //</a>
|
|
<a name="263"><span class="lineNum"> 263 </span> : : // // Verifies that Foo() returns an even number.</a>
|
|
<a name="264"><span class="lineNum"> 264 </span> : : // EXPECT_PRED_FORMAT1(IsEven, Foo());</a>
|
|
<a name="265"><span class="lineNum"> 265 </span> : : //</a>
|
|
<a name="266"><span class="lineNum"> 266 </span> : : // you need to define:</a>
|
|
<a name="267"><span class="lineNum"> 267 </span> : : //</a>
|
|
<a name="268"><span class="lineNum"> 268 </span> : : // testing::AssertionResult IsEven(const char* expr, int n) {</a>
|
|
<a name="269"><span class="lineNum"> 269 </span> : : // if ((n % 2) == 0)</a>
|
|
<a name="270"><span class="lineNum"> 270 </span> : : // return testing::AssertionSuccess();</a>
|
|
<a name="271"><span class="lineNum"> 271 </span> : : // else</a>
|
|
<a name="272"><span class="lineNum"> 272 </span> : : // return testing::AssertionFailure()</a>
|
|
<a name="273"><span class="lineNum"> 273 </span> : : // << "Expected: " << expr << " is even\n Actual: it's " << n;</a>
|
|
<a name="274"><span class="lineNum"> 274 </span> : : // }</a>
|
|
<a name="275"><span class="lineNum"> 275 </span> : : //</a>
|
|
<a name="276"><span class="lineNum"> 276 </span> : : // If Foo() returns 5, you will see the following message:</a>
|
|
<a name="277"><span class="lineNum"> 277 </span> : : //</a>
|
|
<a name="278"><span class="lineNum"> 278 </span> : : // Expected: Foo() is even</a>
|
|
<a name="279"><span class="lineNum"> 279 </span> : : // Actual: it's 5</a>
|
|
<a name="280"><span class="lineNum"> 280 </span> : : //</a>
|
|
<a name="281"><span class="lineNum"> 281 </span> : : class GTEST_API_ AssertionResult {</a>
|
|
<a name="282"><span class="lineNum"> 282 </span> : : public:</a>
|
|
<a name="283"><span class="lineNum"> 283 </span> : : // Copy constructor.</a>
|
|
<a name="284"><span class="lineNum"> 284 </span> : : // Used in EXPECT_TRUE/FALSE(assertion_result).</a>
|
|
<a name="285"><span class="lineNum"> 285 </span> : : AssertionResult(const AssertionResult& other);</a>
|
|
<a name="286"><span class="lineNum"> 286 </span> : : </a>
|
|
<a name="287"><span class="lineNum"> 287 </span> : : #if defined(_MSC_VER) && _MSC_VER < 1910</a>
|
|
<a name="288"><span class="lineNum"> 288 </span> : : GTEST_DISABLE_MSC_WARNINGS_PUSH_(4800 /* forcing value to bool */)</a>
|
|
<a name="289"><span class="lineNum"> 289 </span> : : #endif</a>
|
|
<a name="290"><span class="lineNum"> 290 </span> : : </a>
|
|
<a name="291"><span class="lineNum"> 291 </span> : : // Used in the EXPECT_TRUE/FALSE(bool_expression).</a>
|
|
<a name="292"><span class="lineNum"> 292 </span> : : //</a>
|
|
<a name="293"><span class="lineNum"> 293 </span> : : // T must be contextually convertible to bool.</a>
|
|
<a name="294"><span class="lineNum"> 294 </span> : : //</a>
|
|
<a name="295"><span class="lineNum"> 295 </span> : : // The second parameter prevents this overload from being considered if</a>
|
|
<a name="296"><span class="lineNum"> 296 </span> : : // the argument is implicitly convertible to AssertionResult. In that case</a>
|
|
<a name="297"><span class="lineNum"> 297 </span> : : // we want AssertionResult's copy constructor to be used.</a>
|
|
<a name="298"><span class="lineNum"> 298 </span> : : template <typename T></a>
|
|
<a name="299"><span class="lineNum"> 299 </span> : : explicit AssertionResult(</a>
|
|
<a name="300"><span class="lineNum"> 300 </span> : : const T& success,</a>
|
|
<a name="301"><span class="lineNum"> 301 </span> : : typename internal::EnableIf<</a>
|
|
<a name="302"><span class="lineNum"> 302 </span> : : !internal::ImplicitlyConvertible<T, AssertionResult>::value>::type*</a>
|
|
<a name="303"><span class="lineNum"> 303 </span> : : /*enabler*/ = NULL)</a>
|
|
<a name="304"><span class="lineNum"> 304 </span> : : : success_(success) {}</a>
|
|
<a name="305"><span class="lineNum"> 305 </span> : : </a>
|
|
<a name="306"><span class="lineNum"> 306 </span> : : #if defined(_MSC_VER) && _MSC_VER < 1910</a>
|
|
<a name="307"><span class="lineNum"> 307 </span> : : GTEST_DISABLE_MSC_WARNINGS_POP_()</a>
|
|
<a name="308"><span class="lineNum"> 308 </span> : : #endif</a>
|
|
<a name="309"><span class="lineNum"> 309 </span> : : </a>
|
|
<a name="310"><span class="lineNum"> 310 </span> : : // Assignment operator.</a>
|
|
<a name="311"><span class="lineNum"> 311 </span> : : AssertionResult& operator=(AssertionResult other) {</a>
|
|
<a name="312"><span class="lineNum"> 312 </span> : : swap(other);</a>
|
|
<a name="313"><span class="lineNum"> 313 </span> : : return *this;</a>
|
|
<a name="314"><span class="lineNum"> 314 </span> : : }</a>
|
|
<a name="315"><span class="lineNum"> 315 </span> : : </a>
|
|
<a name="316"><span class="lineNum"> 316 </span> : : // Returns true iff the assertion succeeded.</a>
|
|
<a name="317"><span class="lineNum"> 317 </span> :<span class="lineCov"> 5 : operator bool() const { return success_; } // NOLINT</span></a>
|
|
<a name="318"><span class="lineNum"> 318 </span> : : </a>
|
|
<a name="319"><span class="lineNum"> 319 </span> : : // Returns the assertion's negation. Used with EXPECT/ASSERT_FALSE.</a>
|
|
<a name="320"><span class="lineNum"> 320 </span> : : AssertionResult operator!() const;</a>
|
|
<a name="321"><span class="lineNum"> 321 </span> : : </a>
|
|
<a name="322"><span class="lineNum"> 322 </span> : : // Returns the text streamed into this AssertionResult. Test assertions</a>
|
|
<a name="323"><span class="lineNum"> 323 </span> : : // use it when they fail (i.e., the predicate's outcome doesn't match the</a>
|
|
<a name="324"><span class="lineNum"> 324 </span> : : // assertion's expectation). When nothing has been streamed into the</a>
|
|
<a name="325"><span class="lineNum"> 325 </span> : : // object, returns an empty string.</a>
|
|
<a name="326"><span class="lineNum"> 326 </span> :<span class="lineNoCov"> 0 : const char* message() const {</span></a>
|
|
<a name="327"><span class="lineNum"> 327 </span> [<span class="branchNoExec" title="Branch 0 was not executed"> # </span><span class="branchNoExec" title="Branch 1 was not executed"> # </span>]:<span class="lineNoCov"> 0 : return message_.get() != NULL ? message_->c_str() : "";</span></a>
|
|
<a name="328"><span class="lineNum"> 328 </span> : : }</a>
|
|
<a name="329"><span class="lineNum"> 329 </span> : : // FIXME: Remove this after making sure no clients use it.</a>
|
|
<a name="330"><span class="lineNum"> 330 </span> : : // Deprecated; please use message() instead.</a>
|
|
<a name="331"><span class="lineNum"> 331 </span> :<span class="lineNoCov"> 0 : const char* failure_message() const { return message(); }</span></a>
|
|
<a name="332"><span class="lineNum"> 332 </span> : : </a>
|
|
<a name="333"><span class="lineNum"> 333 </span> : : // Streams a custom failure message into this object.</a>
|
|
<a name="334"><span class="lineNum"> 334 </span> : : template <typename T> AssertionResult& operator<<(const T& value) {</a>
|
|
<a name="335"><span class="lineNum"> 335 </span> : : AppendMessage(Message() << value);</a>
|
|
<a name="336"><span class="lineNum"> 336 </span> : : return *this;</a>
|
|
<a name="337"><span class="lineNum"> 337 </span> : : }</a>
|
|
<a name="338"><span class="lineNum"> 338 </span> : : </a>
|
|
<a name="339"><span class="lineNum"> 339 </span> : : // Allows streaming basic output manipulators such as endl or flush into</a>
|
|
<a name="340"><span class="lineNum"> 340 </span> : : // this object.</a>
|
|
<a name="341"><span class="lineNum"> 341 </span> : : AssertionResult& operator<<(</a>
|
|
<a name="342"><span class="lineNum"> 342 </span> : : ::std::ostream& (*basic_manipulator)(::std::ostream& stream)) {</a>
|
|
<a name="343"><span class="lineNum"> 343 </span> : : AppendMessage(Message() << basic_manipulator);</a>
|
|
<a name="344"><span class="lineNum"> 344 </span> : : return *this;</a>
|
|
<a name="345"><span class="lineNum"> 345 </span> : : }</a>
|
|
<a name="346"><span class="lineNum"> 346 </span> : : </a>
|
|
<a name="347"><span class="lineNum"> 347 </span> : : private:</a>
|
|
<a name="348"><span class="lineNum"> 348 </span> : : // Appends the contents of message to message_.</a>
|
|
<a name="349"><span class="lineNum"> 349 </span> : : void AppendMessage(const Message& a_message) {</a>
|
|
<a name="350"><span class="lineNum"> 350 </span> : : if (message_.get() == NULL)</a>
|
|
<a name="351"><span class="lineNum"> 351 </span> : : message_.reset(new ::std::string);</a>
|
|
<a name="352"><span class="lineNum"> 352 </span> : : message_->append(a_message.GetString().c_str());</a>
|
|
<a name="353"><span class="lineNum"> 353 </span> : : }</a>
|
|
<a name="354"><span class="lineNum"> 354 </span> : : </a>
|
|
<a name="355"><span class="lineNum"> 355 </span> : : // Swap the contents of this AssertionResult with other.</a>
|
|
<a name="356"><span class="lineNum"> 356 </span> : : void swap(AssertionResult& other);</a>
|
|
<a name="357"><span class="lineNum"> 357 </span> : : </a>
|
|
<a name="358"><span class="lineNum"> 358 </span> : : // Stores result of the assertion predicate.</a>
|
|
<a name="359"><span class="lineNum"> 359 </span> : : bool success_;</a>
|
|
<a name="360"><span class="lineNum"> 360 </span> : : // Stores the message describing the condition in case the expectation</a>
|
|
<a name="361"><span class="lineNum"> 361 </span> : : // construct is not satisfied with the predicate's outcome.</a>
|
|
<a name="362"><span class="lineNum"> 362 </span> : : // Referenced via a pointer to avoid taking too much stack frame space</a>
|
|
<a name="363"><span class="lineNum"> 363 </span> : : // with test assertions.</a>
|
|
<a name="364"><span class="lineNum"> 364 </span> : : internal::scoped_ptr< ::std::string> message_;</a>
|
|
<a name="365"><span class="lineNum"> 365 </span> : : };</a>
|
|
<a name="366"><span class="lineNum"> 366 </span> : : </a>
|
|
<a name="367"><span class="lineNum"> 367 </span> : : // Makes a successful assertion result.</a>
|
|
<a name="368"><span class="lineNum"> 368 </span> : : GTEST_API_ AssertionResult AssertionSuccess();</a>
|
|
<a name="369"><span class="lineNum"> 369 </span> : : </a>
|
|
<a name="370"><span class="lineNum"> 370 </span> : : // Makes a failed assertion result.</a>
|
|
<a name="371"><span class="lineNum"> 371 </span> : : GTEST_API_ AssertionResult AssertionFailure();</a>
|
|
<a name="372"><span class="lineNum"> 372 </span> : : </a>
|
|
<a name="373"><span class="lineNum"> 373 </span> : : // Makes a failed assertion result with the given failure message.</a>
|
|
<a name="374"><span class="lineNum"> 374 </span> : : // Deprecated; use AssertionFailure() << msg.</a>
|
|
<a name="375"><span class="lineNum"> 375 </span> : : GTEST_API_ AssertionResult AssertionFailure(const Message& msg);</a>
|
|
<a name="376"><span class="lineNum"> 376 </span> : : </a>
|
|
<a name="377"><span class="lineNum"> 377 </span> : : } // namespace testing</a>
|
|
<a name="378"><span class="lineNum"> 378 </span> : : </a>
|
|
<a name="379"><span class="lineNum"> 379 </span> : : // Includes the auto-generated header that implements a family of generic</a>
|
|
<a name="380"><span class="lineNum"> 380 </span> : : // predicate assertion macros. This include comes late because it relies on</a>
|
|
<a name="381"><span class="lineNum"> 381 </span> : : // APIs declared above.</a>
|
|
<a name="382"><span class="lineNum"> 382 </span> : : #include "gtest/gtest_pred_impl.h"</a>
|
|
<a name="383"><span class="lineNum"> 383 </span> : : </a>
|
|
<a name="384"><span class="lineNum"> 384 </span> : : namespace testing {</a>
|
|
<a name="385"><span class="lineNum"> 385 </span> : : </a>
|
|
<a name="386"><span class="lineNum"> 386 </span> : : // The abstract class that all tests inherit from.</a>
|
|
<a name="387"><span class="lineNum"> 387 </span> : : //</a>
|
|
<a name="388"><span class="lineNum"> 388 </span> : : // In Google Test, a unit test program contains one or many TestCases, and</a>
|
|
<a name="389"><span class="lineNum"> 389 </span> : : // each TestCase contains one or many Tests.</a>
|
|
<a name="390"><span class="lineNum"> 390 </span> : : //</a>
|
|
<a name="391"><span class="lineNum"> 391 </span> : : // When you define a test using the TEST macro, you don't need to</a>
|
|
<a name="392"><span class="lineNum"> 392 </span> : : // explicitly derive from Test - the TEST macro automatically does</a>
|
|
<a name="393"><span class="lineNum"> 393 </span> : : // this for you.</a>
|
|
<a name="394"><span class="lineNum"> 394 </span> : : //</a>
|
|
<a name="395"><span class="lineNum"> 395 </span> : : // The only time you derive from Test is when defining a test fixture</a>
|
|
<a name="396"><span class="lineNum"> 396 </span> : : // to be used in a TEST_F. For example:</a>
|
|
<a name="397"><span class="lineNum"> 397 </span> : : //</a>
|
|
<a name="398"><span class="lineNum"> 398 </span> : : // class FooTest : public testing::Test {</a>
|
|
<a name="399"><span class="lineNum"> 399 </span> : : // protected:</a>
|
|
<a name="400"><span class="lineNum"> 400 </span> : : // void SetUp() override { ... }</a>
|
|
<a name="401"><span class="lineNum"> 401 </span> : : // void TearDown() override { ... }</a>
|
|
<a name="402"><span class="lineNum"> 402 </span> : : // ...</a>
|
|
<a name="403"><span class="lineNum"> 403 </span> : : // };</a>
|
|
<a name="404"><span class="lineNum"> 404 </span> : : //</a>
|
|
<a name="405"><span class="lineNum"> 405 </span> : : // TEST_F(FooTest, Bar) { ... }</a>
|
|
<a name="406"><span class="lineNum"> 406 </span> : : // TEST_F(FooTest, Baz) { ... }</a>
|
|
<a name="407"><span class="lineNum"> 407 </span> : : //</a>
|
|
<a name="408"><span class="lineNum"> 408 </span> : : // Test is not copyable.</a>
|
|
<a name="409"><span class="lineNum"> 409 </span> : : class GTEST_API_ Test {</a>
|
|
<a name="410"><span class="lineNum"> 410 </span> : : public:</a>
|
|
<a name="411"><span class="lineNum"> 411 </span> : : friend class TestInfo;</a>
|
|
<a name="412"><span class="lineNum"> 412 </span> : : </a>
|
|
<a name="413"><span class="lineNum"> 413 </span> : : // Defines types for pointers to functions that set up and tear down</a>
|
|
<a name="414"><span class="lineNum"> 414 </span> : : // a test case.</a>
|
|
<a name="415"><span class="lineNum"> 415 </span> : : typedef internal::SetUpTestCaseFunc SetUpTestCaseFunc;</a>
|
|
<a name="416"><span class="lineNum"> 416 </span> : : typedef internal::TearDownTestCaseFunc TearDownTestCaseFunc;</a>
|
|
<a name="417"><span class="lineNum"> 417 </span> : : </a>
|
|
<a name="418"><span class="lineNum"> 418 </span> : : // The d'tor is virtual as we intend to inherit from Test.</a>
|
|
<a name="419"><span class="lineNum"> 419 </span> : : virtual ~Test();</a>
|
|
<a name="420"><span class="lineNum"> 420 </span> : : </a>
|
|
<a name="421"><span class="lineNum"> 421 </span> : : // Sets up the stuff shared by all tests in this test case.</a>
|
|
<a name="422"><span class="lineNum"> 422 </span> : : //</a>
|
|
<a name="423"><span class="lineNum"> 423 </span> : : // Google Test will call Foo::SetUpTestCase() before running the first</a>
|
|
<a name="424"><span class="lineNum"> 424 </span> : : // test in test case Foo. Hence a sub-class can define its own</a>
|
|
<a name="425"><span class="lineNum"> 425 </span> : : // SetUpTestCase() method to shadow the one defined in the super</a>
|
|
<a name="426"><span class="lineNum"> 426 </span> : : // class.</a>
|
|
<a name="427"><span class="lineNum"> 427 </span> :<span class="lineCov"> 54 : static void SetUpTestCase() {}</span></a>
|
|
<a name="428"><span class="lineNum"> 428 </span> : : </a>
|
|
<a name="429"><span class="lineNum"> 429 </span> : : // Tears down the stuff shared by all tests in this test case.</a>
|
|
<a name="430"><span class="lineNum"> 430 </span> : : //</a>
|
|
<a name="431"><span class="lineNum"> 431 </span> : : // Google Test will call Foo::TearDownTestCase() after running the last</a>
|
|
<a name="432"><span class="lineNum"> 432 </span> : : // test in test case Foo. Hence a sub-class can define its own</a>
|
|
<a name="433"><span class="lineNum"> 433 </span> : : // TearDownTestCase() method to shadow the one defined in the super</a>
|
|
<a name="434"><span class="lineNum"> 434 </span> : : // class.</a>
|
|
<a name="435"><span class="lineNum"> 435 </span> :<span class="lineCov"> 54 : static void TearDownTestCase() {}</span></a>
|
|
<a name="436"><span class="lineNum"> 436 </span> : : </a>
|
|
<a name="437"><span class="lineNum"> 437 </span> : : // Returns true iff the current test has a fatal failure.</a>
|
|
<a name="438"><span class="lineNum"> 438 </span> : : static bool HasFatalFailure();</a>
|
|
<a name="439"><span class="lineNum"> 439 </span> : : </a>
|
|
<a name="440"><span class="lineNum"> 440 </span> : : // Returns true iff the current test has a non-fatal failure.</a>
|
|
<a name="441"><span class="lineNum"> 441 </span> : : static bool HasNonfatalFailure();</a>
|
|
<a name="442"><span class="lineNum"> 442 </span> : : </a>
|
|
<a name="443"><span class="lineNum"> 443 </span> : : // Returns true iff the current test has a (either fatal or</a>
|
|
<a name="444"><span class="lineNum"> 444 </span> : : // non-fatal) failure.</a>
|
|
<a name="445"><span class="lineNum"> 445 </span> : : static bool HasFailure() { return HasFatalFailure() || HasNonfatalFailure(); }</a>
|
|
<a name="446"><span class="lineNum"> 446 </span> : : </a>
|
|
<a name="447"><span class="lineNum"> 447 </span> : : // Logs a property for the current test, test case, or for the entire</a>
|
|
<a name="448"><span class="lineNum"> 448 </span> : : // invocation of the test program when used outside of the context of a</a>
|
|
<a name="449"><span class="lineNum"> 449 </span> : : // test case. Only the last value for a given key is remembered. These</a>
|
|
<a name="450"><span class="lineNum"> 450 </span> : : // are public static so they can be called from utility functions that are</a>
|
|
<a name="451"><span class="lineNum"> 451 </span> : : // not members of the test fixture. Calls to RecordProperty made during</a>
|
|
<a name="452"><span class="lineNum"> 452 </span> : : // lifespan of the test (from the moment its constructor starts to the</a>
|
|
<a name="453"><span class="lineNum"> 453 </span> : : // moment its destructor finishes) will be output in XML as attributes of</a>
|
|
<a name="454"><span class="lineNum"> 454 </span> : : // the <testcase> element. Properties recorded from fixture's</a>
|
|
<a name="455"><span class="lineNum"> 455 </span> : : // SetUpTestCase or TearDownTestCase are logged as attributes of the</a>
|
|
<a name="456"><span class="lineNum"> 456 </span> : : // corresponding <testsuite> element. Calls to RecordProperty made in the</a>
|
|
<a name="457"><span class="lineNum"> 457 </span> : : // global context (before or after invocation of RUN_ALL_TESTS and from</a>
|
|
<a name="458"><span class="lineNum"> 458 </span> : : // SetUp/TearDown method of Environment objects registered with Google</a>
|
|
<a name="459"><span class="lineNum"> 459 </span> : : // Test) will be output as attributes of the <testsuites> element.</a>
|
|
<a name="460"><span class="lineNum"> 460 </span> : : static void RecordProperty(const std::string& key, const std::string& value);</a>
|
|
<a name="461"><span class="lineNum"> 461 </span> : : static void RecordProperty(const std::string& key, int value);</a>
|
|
<a name="462"><span class="lineNum"> 462 </span> : : </a>
|
|
<a name="463"><span class="lineNum"> 463 </span> : : protected:</a>
|
|
<a name="464"><span class="lineNum"> 464 </span> : : // Creates a Test object.</a>
|
|
<a name="465"><span class="lineNum"> 465 </span> : : Test();</a>
|
|
<a name="466"><span class="lineNum"> 466 </span> : : </a>
|
|
<a name="467"><span class="lineNum"> 467 </span> : : // Sets up the test fixture.</a>
|
|
<a name="468"><span class="lineNum"> 468 </span> : : virtual void SetUp();</a>
|
|
<a name="469"><span class="lineNum"> 469 </span> : : </a>
|
|
<a name="470"><span class="lineNum"> 470 </span> : : // Tears down the test fixture.</a>
|
|
<a name="471"><span class="lineNum"> 471 </span> : : virtual void TearDown();</a>
|
|
<a name="472"><span class="lineNum"> 472 </span> : : </a>
|
|
<a name="473"><span class="lineNum"> 473 </span> : : private:</a>
|
|
<a name="474"><span class="lineNum"> 474 </span> : : // Returns true iff the current test has the same fixture class as</a>
|
|
<a name="475"><span class="lineNum"> 475 </span> : : // the first test in the current test case.</a>
|
|
<a name="476"><span class="lineNum"> 476 </span> : : static bool HasSameFixtureClass();</a>
|
|
<a name="477"><span class="lineNum"> 477 </span> : : </a>
|
|
<a name="478"><span class="lineNum"> 478 </span> : : // Runs the test after the test fixture has been set up.</a>
|
|
<a name="479"><span class="lineNum"> 479 </span> : : //</a>
|
|
<a name="480"><span class="lineNum"> 480 </span> : : // A sub-class must implement this to define the test logic.</a>
|
|
<a name="481"><span class="lineNum"> 481 </span> : : //</a>
|
|
<a name="482"><span class="lineNum"> 482 </span> : : // DO NOT OVERRIDE THIS FUNCTION DIRECTLY IN A USER PROGRAM.</a>
|
|
<a name="483"><span class="lineNum"> 483 </span> : : // Instead, use the TEST or TEST_F macro.</a>
|
|
<a name="484"><span class="lineNum"> 484 </span> : : virtual void TestBody() = 0;</a>
|
|
<a name="485"><span class="lineNum"> 485 </span> : : </a>
|
|
<a name="486"><span class="lineNum"> 486 </span> : : // Sets up, executes, and tears down the test.</a>
|
|
<a name="487"><span class="lineNum"> 487 </span> : : void Run();</a>
|
|
<a name="488"><span class="lineNum"> 488 </span> : : </a>
|
|
<a name="489"><span class="lineNum"> 489 </span> : : // Deletes self. We deliberately pick an unusual name for this</a>
|
|
<a name="490"><span class="lineNum"> 490 </span> : : // internal method to avoid clashing with names used in user TESTs.</a>
|
|
<a name="491"><span class="lineNum"> 491 </span> : : void DeleteSelf_() { delete this; }</a>
|
|
<a name="492"><span class="lineNum"> 492 </span> : : </a>
|
|
<a name="493"><span class="lineNum"> 493 </span> : : const internal::scoped_ptr< GTEST_FLAG_SAVER_ > gtest_flag_saver_;</a>
|
|
<a name="494"><span class="lineNum"> 494 </span> : : </a>
|
|
<a name="495"><span class="lineNum"> 495 </span> : : // Often a user misspells SetUp() as Setup() and spends a long time</a>
|
|
<a name="496"><span class="lineNum"> 496 </span> : : // wondering why it is never called by Google Test. The declaration of</a>
|
|
<a name="497"><span class="lineNum"> 497 </span> : : // the following method is solely for catching such an error at</a>
|
|
<a name="498"><span class="lineNum"> 498 </span> : : // compile time:</a>
|
|
<a name="499"><span class="lineNum"> 499 </span> : : //</a>
|
|
<a name="500"><span class="lineNum"> 500 </span> : : // - The return type is deliberately chosen to be not void, so it</a>
|
|
<a name="501"><span class="lineNum"> 501 </span> : : // will be a conflict if void Setup() is declared in the user's</a>
|
|
<a name="502"><span class="lineNum"> 502 </span> : : // test fixture.</a>
|
|
<a name="503"><span class="lineNum"> 503 </span> : : //</a>
|
|
<a name="504"><span class="lineNum"> 504 </span> : : // - This method is private, so it will be another compiler error</a>
|
|
<a name="505"><span class="lineNum"> 505 </span> : : // if the method is called from the user's test fixture.</a>
|
|
<a name="506"><span class="lineNum"> 506 </span> : : //</a>
|
|
<a name="507"><span class="lineNum"> 507 </span> : : // DO NOT OVERRIDE THIS FUNCTION.</a>
|
|
<a name="508"><span class="lineNum"> 508 </span> : : //</a>
|
|
<a name="509"><span class="lineNum"> 509 </span> : : // If you see an error about overriding the following function or</a>
|
|
<a name="510"><span class="lineNum"> 510 </span> : : // about it being private, you have mis-spelled SetUp() as Setup().</a>
|
|
<a name="511"><span class="lineNum"> 511 </span> : : struct Setup_should_be_spelled_SetUp {};</a>
|
|
<a name="512"><span class="lineNum"> 512 </span> :<span class="lineNoCov"> 0 : virtual Setup_should_be_spelled_SetUp* Setup() { return NULL; }</span></a>
|
|
<a name="513"><span class="lineNum"> 513 </span> : : </a>
|
|
<a name="514"><span class="lineNum"> 514 </span> : : // We disallow copying Tests.</a>
|
|
<a name="515"><span class="lineNum"> 515 </span> : : GTEST_DISALLOW_COPY_AND_ASSIGN_(Test);</a>
|
|
<a name="516"><span class="lineNum"> 516 </span> : : };</a>
|
|
<a name="517"><span class="lineNum"> 517 </span> : : </a>
|
|
<a name="518"><span class="lineNum"> 518 </span> : : typedef internal::TimeInMillis TimeInMillis;</a>
|
|
<a name="519"><span class="lineNum"> 519 </span> : : </a>
|
|
<a name="520"><span class="lineNum"> 520 </span> : : // A copyable object representing a user specified test property which can be</a>
|
|
<a name="521"><span class="lineNum"> 521 </span> : : // output as a key/value string pair.</a>
|
|
<a name="522"><span class="lineNum"> 522 </span> : : //</a>
|
|
<a name="523"><span class="lineNum"> 523 </span> : : // Don't inherit from TestProperty as its destructor is not virtual.</a>
|
|
<a name="524"><span class="lineNum"> 524 </span> : : class TestProperty {</a>
|
|
<a name="525"><span class="lineNum"> 525 </span> : : public:</a>
|
|
<a name="526"><span class="lineNum"> 526 </span> : : // C'tor. TestProperty does NOT have a default constructor.</a>
|
|
<a name="527"><span class="lineNum"> 527 </span> : : // Always use this constructor (with parameters) to create a</a>
|
|
<a name="528"><span class="lineNum"> 528 </span> : : // TestProperty object.</a>
|
|
<a name="529"><span class="lineNum"> 529 </span> : : TestProperty(const std::string& a_key, const std::string& a_value) :</a>
|
|
<a name="530"><span class="lineNum"> 530 </span> : : key_(a_key), value_(a_value) {</a>
|
|
<a name="531"><span class="lineNum"> 531 </span> : : }</a>
|
|
<a name="532"><span class="lineNum"> 532 </span> : : </a>
|
|
<a name="533"><span class="lineNum"> 533 </span> : : // Gets the user supplied key.</a>
|
|
<a name="534"><span class="lineNum"> 534 </span> : : const char* key() const {</a>
|
|
<a name="535"><span class="lineNum"> 535 </span> : : return key_.c_str();</a>
|
|
<a name="536"><span class="lineNum"> 536 </span> : : }</a>
|
|
<a name="537"><span class="lineNum"> 537 </span> : : </a>
|
|
<a name="538"><span class="lineNum"> 538 </span> : : // Gets the user supplied value.</a>
|
|
<a name="539"><span class="lineNum"> 539 </span> : : const char* value() const {</a>
|
|
<a name="540"><span class="lineNum"> 540 </span> : : return value_.c_str();</a>
|
|
<a name="541"><span class="lineNum"> 541 </span> : : }</a>
|
|
<a name="542"><span class="lineNum"> 542 </span> : : </a>
|
|
<a name="543"><span class="lineNum"> 543 </span> : : // Sets a new value, overriding the one supplied in the constructor.</a>
|
|
<a name="544"><span class="lineNum"> 544 </span> : : void SetValue(const std::string& new_value) {</a>
|
|
<a name="545"><span class="lineNum"> 545 </span> : : value_ = new_value;</a>
|
|
<a name="546"><span class="lineNum"> 546 </span> : : }</a>
|
|
<a name="547"><span class="lineNum"> 547 </span> : : </a>
|
|
<a name="548"><span class="lineNum"> 548 </span> : : private:</a>
|
|
<a name="549"><span class="lineNum"> 549 </span> : : // The key supplied by the user.</a>
|
|
<a name="550"><span class="lineNum"> 550 </span> : : std::string key_;</a>
|
|
<a name="551"><span class="lineNum"> 551 </span> : : // The value supplied by the user.</a>
|
|
<a name="552"><span class="lineNum"> 552 </span> : : std::string value_;</a>
|
|
<a name="553"><span class="lineNum"> 553 </span> : : };</a>
|
|
<a name="554"><span class="lineNum"> 554 </span> : : </a>
|
|
<a name="555"><span class="lineNum"> 555 </span> : : // The result of a single Test. This includes a list of</a>
|
|
<a name="556"><span class="lineNum"> 556 </span> : : // TestPartResults, a list of TestProperties, a count of how many</a>
|
|
<a name="557"><span class="lineNum"> 557 </span> : : // death tests there are in the Test, and how much time it took to run</a>
|
|
<a name="558"><span class="lineNum"> 558 </span> : : // the Test.</a>
|
|
<a name="559"><span class="lineNum"> 559 </span> : : //</a>
|
|
<a name="560"><span class="lineNum"> 560 </span> : : // TestResult is not copyable.</a>
|
|
<a name="561"><span class="lineNum"> 561 </span> : : class GTEST_API_ TestResult {</a>
|
|
<a name="562"><span class="lineNum"> 562 </span> : : public:</a>
|
|
<a name="563"><span class="lineNum"> 563 </span> : : // Creates an empty TestResult.</a>
|
|
<a name="564"><span class="lineNum"> 564 </span> : : TestResult();</a>
|
|
<a name="565"><span class="lineNum"> 565 </span> : : </a>
|
|
<a name="566"><span class="lineNum"> 566 </span> : : // D'tor. Do not inherit from TestResult.</a>
|
|
<a name="567"><span class="lineNum"> 567 </span> : : ~TestResult();</a>
|
|
<a name="568"><span class="lineNum"> 568 </span> : : </a>
|
|
<a name="569"><span class="lineNum"> 569 </span> : : // Gets the number of all test parts. This is the sum of the number</a>
|
|
<a name="570"><span class="lineNum"> 570 </span> : : // of successful test parts and the number of failed test parts.</a>
|
|
<a name="571"><span class="lineNum"> 571 </span> : : int total_part_count() const;</a>
|
|
<a name="572"><span class="lineNum"> 572 </span> : : </a>
|
|
<a name="573"><span class="lineNum"> 573 </span> : : // Returns the number of the test properties.</a>
|
|
<a name="574"><span class="lineNum"> 574 </span> : : int test_property_count() const;</a>
|
|
<a name="575"><span class="lineNum"> 575 </span> : : </a>
|
|
<a name="576"><span class="lineNum"> 576 </span> : : // Returns true iff the test passed (i.e. no test part failed).</a>
|
|
<a name="577"><span class="lineNum"> 577 </span> : : bool Passed() const { return !Failed(); }</a>
|
|
<a name="578"><span class="lineNum"> 578 </span> : : </a>
|
|
<a name="579"><span class="lineNum"> 579 </span> : : // Returns true iff the test failed.</a>
|
|
<a name="580"><span class="lineNum"> 580 </span> : : bool Failed() const;</a>
|
|
<a name="581"><span class="lineNum"> 581 </span> : : </a>
|
|
<a name="582"><span class="lineNum"> 582 </span> : : // Returns true iff the test fatally failed.</a>
|
|
<a name="583"><span class="lineNum"> 583 </span> : : bool HasFatalFailure() const;</a>
|
|
<a name="584"><span class="lineNum"> 584 </span> : : </a>
|
|
<a name="585"><span class="lineNum"> 585 </span> : : // Returns true iff the test has a non-fatal failure.</a>
|
|
<a name="586"><span class="lineNum"> 586 </span> : : bool HasNonfatalFailure() const;</a>
|
|
<a name="587"><span class="lineNum"> 587 </span> : : </a>
|
|
<a name="588"><span class="lineNum"> 588 </span> : : // Returns the elapsed time, in milliseconds.</a>
|
|
<a name="589"><span class="lineNum"> 589 </span> : : TimeInMillis elapsed_time() const { return elapsed_time_; }</a>
|
|
<a name="590"><span class="lineNum"> 590 </span> : : </a>
|
|
<a name="591"><span class="lineNum"> 591 </span> : : // Returns the i-th test part result among all the results. i can range from 0</a>
|
|
<a name="592"><span class="lineNum"> 592 </span> : : // to total_part_count() - 1. If i is not in that range, aborts the program.</a>
|
|
<a name="593"><span class="lineNum"> 593 </span> : : const TestPartResult& GetTestPartResult(int i) const;</a>
|
|
<a name="594"><span class="lineNum"> 594 </span> : : </a>
|
|
<a name="595"><span class="lineNum"> 595 </span> : : // Returns the i-th test property. i can range from 0 to</a>
|
|
<a name="596"><span class="lineNum"> 596 </span> : : // test_property_count() - 1. If i is not in that range, aborts the</a>
|
|
<a name="597"><span class="lineNum"> 597 </span> : : // program.</a>
|
|
<a name="598"><span class="lineNum"> 598 </span> : : const TestProperty& GetTestProperty(int i) const;</a>
|
|
<a name="599"><span class="lineNum"> 599 </span> : : </a>
|
|
<a name="600"><span class="lineNum"> 600 </span> : : private:</a>
|
|
<a name="601"><span class="lineNum"> 601 </span> : : friend class TestInfo;</a>
|
|
<a name="602"><span class="lineNum"> 602 </span> : : friend class TestCase;</a>
|
|
<a name="603"><span class="lineNum"> 603 </span> : : friend class UnitTest;</a>
|
|
<a name="604"><span class="lineNum"> 604 </span> : : friend class internal::DefaultGlobalTestPartResultReporter;</a>
|
|
<a name="605"><span class="lineNum"> 605 </span> : : friend class internal::ExecDeathTest;</a>
|
|
<a name="606"><span class="lineNum"> 606 </span> : : friend class internal::TestResultAccessor;</a>
|
|
<a name="607"><span class="lineNum"> 607 </span> : : friend class internal::UnitTestImpl;</a>
|
|
<a name="608"><span class="lineNum"> 608 </span> : : friend class internal::WindowsDeathTest;</a>
|
|
<a name="609"><span class="lineNum"> 609 </span> : : friend class internal::FuchsiaDeathTest;</a>
|
|
<a name="610"><span class="lineNum"> 610 </span> : : </a>
|
|
<a name="611"><span class="lineNum"> 611 </span> : : // Gets the vector of TestPartResults.</a>
|
|
<a name="612"><span class="lineNum"> 612 </span> : : const std::vector<TestPartResult>& test_part_results() const {</a>
|
|
<a name="613"><span class="lineNum"> 613 </span> : : return test_part_results_;</a>
|
|
<a name="614"><span class="lineNum"> 614 </span> : : }</a>
|
|
<a name="615"><span class="lineNum"> 615 </span> : : </a>
|
|
<a name="616"><span class="lineNum"> 616 </span> : : // Gets the vector of TestProperties.</a>
|
|
<a name="617"><span class="lineNum"> 617 </span> : : const std::vector<TestProperty>& test_properties() const {</a>
|
|
<a name="618"><span class="lineNum"> 618 </span> : : return test_properties_;</a>
|
|
<a name="619"><span class="lineNum"> 619 </span> : : }</a>
|
|
<a name="620"><span class="lineNum"> 620 </span> : : </a>
|
|
<a name="621"><span class="lineNum"> 621 </span> : : // Sets the elapsed time.</a>
|
|
<a name="622"><span class="lineNum"> 622 </span> : : void set_elapsed_time(TimeInMillis elapsed) { elapsed_time_ = elapsed; }</a>
|
|
<a name="623"><span class="lineNum"> 623 </span> : : </a>
|
|
<a name="624"><span class="lineNum"> 624 </span> : : // Adds a test property to the list. The property is validated and may add</a>
|
|
<a name="625"><span class="lineNum"> 625 </span> : : // a non-fatal failure if invalid (e.g., if it conflicts with reserved</a>
|
|
<a name="626"><span class="lineNum"> 626 </span> : : // key names). If a property is already recorded for the same key, the</a>
|
|
<a name="627"><span class="lineNum"> 627 </span> : : // value will be updated, rather than storing multiple values for the same</a>
|
|
<a name="628"><span class="lineNum"> 628 </span> : : // key. xml_element specifies the element for which the property is being</a>
|
|
<a name="629"><span class="lineNum"> 629 </span> : : // recorded and is used for validation.</a>
|
|
<a name="630"><span class="lineNum"> 630 </span> : : void RecordProperty(const std::string& xml_element,</a>
|
|
<a name="631"><span class="lineNum"> 631 </span> : : const TestProperty& test_property);</a>
|
|
<a name="632"><span class="lineNum"> 632 </span> : : </a>
|
|
<a name="633"><span class="lineNum"> 633 </span> : : // Adds a failure if the key is a reserved attribute of Google Test</a>
|
|
<a name="634"><span class="lineNum"> 634 </span> : : // testcase tags. Returns true if the property is valid.</a>
|
|
<a name="635"><span class="lineNum"> 635 </span> : : // FIXME: Validate attribute names are legal and human readable.</a>
|
|
<a name="636"><span class="lineNum"> 636 </span> : : static bool ValidateTestProperty(const std::string& xml_element,</a>
|
|
<a name="637"><span class="lineNum"> 637 </span> : : const TestProperty& test_property);</a>
|
|
<a name="638"><span class="lineNum"> 638 </span> : : </a>
|
|
<a name="639"><span class="lineNum"> 639 </span> : : // Adds a test part result to the list.</a>
|
|
<a name="640"><span class="lineNum"> 640 </span> : : void AddTestPartResult(const TestPartResult& test_part_result);</a>
|
|
<a name="641"><span class="lineNum"> 641 </span> : : </a>
|
|
<a name="642"><span class="lineNum"> 642 </span> : : // Returns the death test count.</a>
|
|
<a name="643"><span class="lineNum"> 643 </span> : : int death_test_count() const { return death_test_count_; }</a>
|
|
<a name="644"><span class="lineNum"> 644 </span> : : </a>
|
|
<a name="645"><span class="lineNum"> 645 </span> : : // Increments the death test count, returning the new count.</a>
|
|
<a name="646"><span class="lineNum"> 646 </span> : : int increment_death_test_count() { return ++death_test_count_; }</a>
|
|
<a name="647"><span class="lineNum"> 647 </span> : : </a>
|
|
<a name="648"><span class="lineNum"> 648 </span> : : // Clears the test part results.</a>
|
|
<a name="649"><span class="lineNum"> 649 </span> : : void ClearTestPartResults();</a>
|
|
<a name="650"><span class="lineNum"> 650 </span> : : </a>
|
|
<a name="651"><span class="lineNum"> 651 </span> : : // Clears the object.</a>
|
|
<a name="652"><span class="lineNum"> 652 </span> : : void Clear();</a>
|
|
<a name="653"><span class="lineNum"> 653 </span> : : </a>
|
|
<a name="654"><span class="lineNum"> 654 </span> : : // Protects mutable state of the property vector and of owned</a>
|
|
<a name="655"><span class="lineNum"> 655 </span> : : // properties, whose values may be updated.</a>
|
|
<a name="656"><span class="lineNum"> 656 </span> : : internal::Mutex test_properites_mutex_;</a>
|
|
<a name="657"><span class="lineNum"> 657 </span> : : </a>
|
|
<a name="658"><span class="lineNum"> 658 </span> : : // The vector of TestPartResults</a>
|
|
<a name="659"><span class="lineNum"> 659 </span> : : std::vector<TestPartResult> test_part_results_;</a>
|
|
<a name="660"><span class="lineNum"> 660 </span> : : // The vector of TestProperties</a>
|
|
<a name="661"><span class="lineNum"> 661 </span> : : std::vector<TestProperty> test_properties_;</a>
|
|
<a name="662"><span class="lineNum"> 662 </span> : : // Running count of death tests.</a>
|
|
<a name="663"><span class="lineNum"> 663 </span> : : int death_test_count_;</a>
|
|
<a name="664"><span class="lineNum"> 664 </span> : : // The elapsed time, in milliseconds.</a>
|
|
<a name="665"><span class="lineNum"> 665 </span> : : TimeInMillis elapsed_time_;</a>
|
|
<a name="666"><span class="lineNum"> 666 </span> : : </a>
|
|
<a name="667"><span class="lineNum"> 667 </span> : : // We disallow copying TestResult.</a>
|
|
<a name="668"><span class="lineNum"> 668 </span> : : GTEST_DISALLOW_COPY_AND_ASSIGN_(TestResult);</a>
|
|
<a name="669"><span class="lineNum"> 669 </span> : : }; // class TestResult</a>
|
|
<a name="670"><span class="lineNum"> 670 </span> : : </a>
|
|
<a name="671"><span class="lineNum"> 671 </span> : : // A TestInfo object stores the following information about a test:</a>
|
|
<a name="672"><span class="lineNum"> 672 </span> : : //</a>
|
|
<a name="673"><span class="lineNum"> 673 </span> : : // Test case name</a>
|
|
<a name="674"><span class="lineNum"> 674 </span> : : // Test name</a>
|
|
<a name="675"><span class="lineNum"> 675 </span> : : // Whether the test should be run</a>
|
|
<a name="676"><span class="lineNum"> 676 </span> : : // A function pointer that creates the test object when invoked</a>
|
|
<a name="677"><span class="lineNum"> 677 </span> : : // Test result</a>
|
|
<a name="678"><span class="lineNum"> 678 </span> : : //</a>
|
|
<a name="679"><span class="lineNum"> 679 </span> : : // The constructor of TestInfo registers itself with the UnitTest</a>
|
|
<a name="680"><span class="lineNum"> 680 </span> : : // singleton such that the RUN_ALL_TESTS() macro knows which tests to</a>
|
|
<a name="681"><span class="lineNum"> 681 </span> : : // run.</a>
|
|
<a name="682"><span class="lineNum"> 682 </span> : : class GTEST_API_ TestInfo {</a>
|
|
<a name="683"><span class="lineNum"> 683 </span> : : public:</a>
|
|
<a name="684"><span class="lineNum"> 684 </span> : : // Destructs a TestInfo object. This function is not virtual, so</a>
|
|
<a name="685"><span class="lineNum"> 685 </span> : : // don't inherit from TestInfo.</a>
|
|
<a name="686"><span class="lineNum"> 686 </span> : : ~TestInfo();</a>
|
|
<a name="687"><span class="lineNum"> 687 </span> : : </a>
|
|
<a name="688"><span class="lineNum"> 688 </span> : : // Returns the test case name.</a>
|
|
<a name="689"><span class="lineNum"> 689 </span> : : const char* test_case_name() const { return test_case_name_.c_str(); }</a>
|
|
<a name="690"><span class="lineNum"> 690 </span> : : </a>
|
|
<a name="691"><span class="lineNum"> 691 </span> : : // Returns the test name.</a>
|
|
<a name="692"><span class="lineNum"> 692 </span> : : const char* name() const { return name_.c_str(); }</a>
|
|
<a name="693"><span class="lineNum"> 693 </span> : : </a>
|
|
<a name="694"><span class="lineNum"> 694 </span> : : // Returns the name of the parameter type, or NULL if this is not a typed</a>
|
|
<a name="695"><span class="lineNum"> 695 </span> : : // or a type-parameterized test.</a>
|
|
<a name="696"><span class="lineNum"> 696 </span> : : const char* type_param() const {</a>
|
|
<a name="697"><span class="lineNum"> 697 </span> : : if (type_param_.get() != NULL)</a>
|
|
<a name="698"><span class="lineNum"> 698 </span> : : return type_param_->c_str();</a>
|
|
<a name="699"><span class="lineNum"> 699 </span> : : return NULL;</a>
|
|
<a name="700"><span class="lineNum"> 700 </span> : : }</a>
|
|
<a name="701"><span class="lineNum"> 701 </span> : : </a>
|
|
<a name="702"><span class="lineNum"> 702 </span> : : // Returns the text representation of the value parameter, or NULL if this</a>
|
|
<a name="703"><span class="lineNum"> 703 </span> : : // is not a value-parameterized test.</a>
|
|
<a name="704"><span class="lineNum"> 704 </span> : : const char* value_param() const {</a>
|
|
<a name="705"><span class="lineNum"> 705 </span> : : if (value_param_.get() != NULL)</a>
|
|
<a name="706"><span class="lineNum"> 706 </span> : : return value_param_->c_str();</a>
|
|
<a name="707"><span class="lineNum"> 707 </span> : : return NULL;</a>
|
|
<a name="708"><span class="lineNum"> 708 </span> : : }</a>
|
|
<a name="709"><span class="lineNum"> 709 </span> : : </a>
|
|
<a name="710"><span class="lineNum"> 710 </span> : : // Returns the file name where this test is defined.</a>
|
|
<a name="711"><span class="lineNum"> 711 </span> : : const char* file() const { return location_.file.c_str(); }</a>
|
|
<a name="712"><span class="lineNum"> 712 </span> : : </a>
|
|
<a name="713"><span class="lineNum"> 713 </span> : : // Returns the line where this test is defined.</a>
|
|
<a name="714"><span class="lineNum"> 714 </span> : : int line() const { return location_.line; }</a>
|
|
<a name="715"><span class="lineNum"> 715 </span> : : </a>
|
|
<a name="716"><span class="lineNum"> 716 </span> : : // Return true if this test should not be run because it's in another shard.</a>
|
|
<a name="717"><span class="lineNum"> 717 </span> : : bool is_in_another_shard() const { return is_in_another_shard_; }</a>
|
|
<a name="718"><span class="lineNum"> 718 </span> : : </a>
|
|
<a name="719"><span class="lineNum"> 719 </span> : : // Returns true if this test should run, that is if the test is not</a>
|
|
<a name="720"><span class="lineNum"> 720 </span> : : // disabled (or it is disabled but the also_run_disabled_tests flag has</a>
|
|
<a name="721"><span class="lineNum"> 721 </span> : : // been specified) and its full name matches the user-specified filter.</a>
|
|
<a name="722"><span class="lineNum"> 722 </span> : : //</a>
|
|
<a name="723"><span class="lineNum"> 723 </span> : : // Google Test allows the user to filter the tests by their full names.</a>
|
|
<a name="724"><span class="lineNum"> 724 </span> : : // The full name of a test Bar in test case Foo is defined as</a>
|
|
<a name="725"><span class="lineNum"> 725 </span> : : // "Foo.Bar". Only the tests that match the filter will run.</a>
|
|
<a name="726"><span class="lineNum"> 726 </span> : : //</a>
|
|
<a name="727"><span class="lineNum"> 727 </span> : : // A filter is a colon-separated list of glob (not regex) patterns,</a>
|
|
<a name="728"><span class="lineNum"> 728 </span> : : // optionally followed by a '-' and a colon-separated list of</a>
|
|
<a name="729"><span class="lineNum"> 729 </span> : : // negative patterns (tests to exclude). A test is run if it</a>
|
|
<a name="730"><span class="lineNum"> 730 </span> : : // matches one of the positive patterns and does not match any of</a>
|
|
<a name="731"><span class="lineNum"> 731 </span> : : // the negative patterns.</a>
|
|
<a name="732"><span class="lineNum"> 732 </span> : : //</a>
|
|
<a name="733"><span class="lineNum"> 733 </span> : : // For example, *A*:Foo.* is a filter that matches any string that</a>
|
|
<a name="734"><span class="lineNum"> 734 </span> : : // contains the character 'A' or starts with "Foo.".</a>
|
|
<a name="735"><span class="lineNum"> 735 </span> : : bool should_run() const { return should_run_; }</a>
|
|
<a name="736"><span class="lineNum"> 736 </span> : : </a>
|
|
<a name="737"><span class="lineNum"> 737 </span> : : // Returns true iff this test will appear in the XML report.</a>
|
|
<a name="738"><span class="lineNum"> 738 </span> : : bool is_reportable() const {</a>
|
|
<a name="739"><span class="lineNum"> 739 </span> : : // The XML report includes tests matching the filter, excluding those</a>
|
|
<a name="740"><span class="lineNum"> 740 </span> : : // run in other shards.</a>
|
|
<a name="741"><span class="lineNum"> 741 </span> : : return matches_filter_ && !is_in_another_shard_;</a>
|
|
<a name="742"><span class="lineNum"> 742 </span> : : }</a>
|
|
<a name="743"><span class="lineNum"> 743 </span> : : </a>
|
|
<a name="744"><span class="lineNum"> 744 </span> : : // Returns the result of the test.</a>
|
|
<a name="745"><span class="lineNum"> 745 </span> : : const TestResult* result() const { return &result_; }</a>
|
|
<a name="746"><span class="lineNum"> 746 </span> : : </a>
|
|
<a name="747"><span class="lineNum"> 747 </span> : : private:</a>
|
|
<a name="748"><span class="lineNum"> 748 </span> : : #if GTEST_HAS_DEATH_TEST</a>
|
|
<a name="749"><span class="lineNum"> 749 </span> : : friend class internal::DefaultDeathTestFactory;</a>
|
|
<a name="750"><span class="lineNum"> 750 </span> : : #endif // GTEST_HAS_DEATH_TEST</a>
|
|
<a name="751"><span class="lineNum"> 751 </span> : : friend class Test;</a>
|
|
<a name="752"><span class="lineNum"> 752 </span> : : friend class TestCase;</a>
|
|
<a name="753"><span class="lineNum"> 753 </span> : : friend class internal::UnitTestImpl;</a>
|
|
<a name="754"><span class="lineNum"> 754 </span> : : friend class internal::StreamingListenerTest;</a>
|
|
<a name="755"><span class="lineNum"> 755 </span> : : friend TestInfo* internal::MakeAndRegisterTestInfo(</a>
|
|
<a name="756"><span class="lineNum"> 756 </span> : : const char* test_case_name,</a>
|
|
<a name="757"><span class="lineNum"> 757 </span> : : const char* name,</a>
|
|
<a name="758"><span class="lineNum"> 758 </span> : : const char* type_param,</a>
|
|
<a name="759"><span class="lineNum"> 759 </span> : : const char* value_param,</a>
|
|
<a name="760"><span class="lineNum"> 760 </span> : : internal::CodeLocation code_location,</a>
|
|
<a name="761"><span class="lineNum"> 761 </span> : : internal::TypeId fixture_class_id,</a>
|
|
<a name="762"><span class="lineNum"> 762 </span> : : Test::SetUpTestCaseFunc set_up_tc,</a>
|
|
<a name="763"><span class="lineNum"> 763 </span> : : Test::TearDownTestCaseFunc tear_down_tc,</a>
|
|
<a name="764"><span class="lineNum"> 764 </span> : : internal::TestFactoryBase* factory);</a>
|
|
<a name="765"><span class="lineNum"> 765 </span> : : </a>
|
|
<a name="766"><span class="lineNum"> 766 </span> : : // Constructs a TestInfo object. The newly constructed instance assumes</a>
|
|
<a name="767"><span class="lineNum"> 767 </span> : : // ownership of the factory object.</a>
|
|
<a name="768"><span class="lineNum"> 768 </span> : : TestInfo(const std::string& test_case_name,</a>
|
|
<a name="769"><span class="lineNum"> 769 </span> : : const std::string& name,</a>
|
|
<a name="770"><span class="lineNum"> 770 </span> : : const char* a_type_param, // NULL if not a type-parameterized test</a>
|
|
<a name="771"><span class="lineNum"> 771 </span> : : const char* a_value_param, // NULL if not a value-parameterized test</a>
|
|
<a name="772"><span class="lineNum"> 772 </span> : : internal::CodeLocation a_code_location,</a>
|
|
<a name="773"><span class="lineNum"> 773 </span> : : internal::TypeId fixture_class_id,</a>
|
|
<a name="774"><span class="lineNum"> 774 </span> : : internal::TestFactoryBase* factory);</a>
|
|
<a name="775"><span class="lineNum"> 775 </span> : : </a>
|
|
<a name="776"><span class="lineNum"> 776 </span> : : // Increments the number of death tests encountered in this test so</a>
|
|
<a name="777"><span class="lineNum"> 777 </span> : : // far.</a>
|
|
<a name="778"><span class="lineNum"> 778 </span> : : int increment_death_test_count() {</a>
|
|
<a name="779"><span class="lineNum"> 779 </span> : : return result_.increment_death_test_count();</a>
|
|
<a name="780"><span class="lineNum"> 780 </span> : : }</a>
|
|
<a name="781"><span class="lineNum"> 781 </span> : : </a>
|
|
<a name="782"><span class="lineNum"> 782 </span> : : // Creates the test object, runs it, records its result, and then</a>
|
|
<a name="783"><span class="lineNum"> 783 </span> : : // deletes it.</a>
|
|
<a name="784"><span class="lineNum"> 784 </span> : : void Run();</a>
|
|
<a name="785"><span class="lineNum"> 785 </span> : : </a>
|
|
<a name="786"><span class="lineNum"> 786 </span> : : static void ClearTestResult(TestInfo* test_info) {</a>
|
|
<a name="787"><span class="lineNum"> 787 </span> : : test_info->result_.Clear();</a>
|
|
<a name="788"><span class="lineNum"> 788 </span> : : }</a>
|
|
<a name="789"><span class="lineNum"> 789 </span> : : </a>
|
|
<a name="790"><span class="lineNum"> 790 </span> : : // These fields are immutable properties of the test.</a>
|
|
<a name="791"><span class="lineNum"> 791 </span> : : const std::string test_case_name_; // Test case name</a>
|
|
<a name="792"><span class="lineNum"> 792 </span> : : const std::string name_; // Test name</a>
|
|
<a name="793"><span class="lineNum"> 793 </span> : : // Name of the parameter type, or NULL if this is not a typed or a</a>
|
|
<a name="794"><span class="lineNum"> 794 </span> : : // type-parameterized test.</a>
|
|
<a name="795"><span class="lineNum"> 795 </span> : : const internal::scoped_ptr<const ::std::string> type_param_;</a>
|
|
<a name="796"><span class="lineNum"> 796 </span> : : // Text representation of the value parameter, or NULL if this is not a</a>
|
|
<a name="797"><span class="lineNum"> 797 </span> : : // value-parameterized test.</a>
|
|
<a name="798"><span class="lineNum"> 798 </span> : : const internal::scoped_ptr<const ::std::string> value_param_;</a>
|
|
<a name="799"><span class="lineNum"> 799 </span> : : internal::CodeLocation location_;</a>
|
|
<a name="800"><span class="lineNum"> 800 </span> : : const internal::TypeId fixture_class_id_; // ID of the test fixture class</a>
|
|
<a name="801"><span class="lineNum"> 801 </span> : : bool should_run_; // True iff this test should run</a>
|
|
<a name="802"><span class="lineNum"> 802 </span> : : bool is_disabled_; // True iff this test is disabled</a>
|
|
<a name="803"><span class="lineNum"> 803 </span> : : bool matches_filter_; // True if this test matches the</a>
|
|
<a name="804"><span class="lineNum"> 804 </span> : : // user-specified filter.</a>
|
|
<a name="805"><span class="lineNum"> 805 </span> : : bool is_in_another_shard_; // Will be run in another shard.</a>
|
|
<a name="806"><span class="lineNum"> 806 </span> : : internal::TestFactoryBase* const factory_; // The factory that creates</a>
|
|
<a name="807"><span class="lineNum"> 807 </span> : : // the test object</a>
|
|
<a name="808"><span class="lineNum"> 808 </span> : : </a>
|
|
<a name="809"><span class="lineNum"> 809 </span> : : // This field is mutable and needs to be reset before running the</a>
|
|
<a name="810"><span class="lineNum"> 810 </span> : : // test for the second time.</a>
|
|
<a name="811"><span class="lineNum"> 811 </span> : : TestResult result_;</a>
|
|
<a name="812"><span class="lineNum"> 812 </span> : : </a>
|
|
<a name="813"><span class="lineNum"> 813 </span> : : GTEST_DISALLOW_COPY_AND_ASSIGN_(TestInfo);</a>
|
|
<a name="814"><span class="lineNum"> 814 </span> : : };</a>
|
|
<a name="815"><span class="lineNum"> 815 </span> : : </a>
|
|
<a name="816"><span class="lineNum"> 816 </span> : : // A test case, which consists of a vector of TestInfos.</a>
|
|
<a name="817"><span class="lineNum"> 817 </span> : : //</a>
|
|
<a name="818"><span class="lineNum"> 818 </span> : : // TestCase is not copyable.</a>
|
|
<a name="819"><span class="lineNum"> 819 </span> : : class GTEST_API_ TestCase {</a>
|
|
<a name="820"><span class="lineNum"> 820 </span> : : public:</a>
|
|
<a name="821"><span class="lineNum"> 821 </span> : : // Creates a TestCase with the given name.</a>
|
|
<a name="822"><span class="lineNum"> 822 </span> : : //</a>
|
|
<a name="823"><span class="lineNum"> 823 </span> : : // TestCase does NOT have a default constructor. Always use this</a>
|
|
<a name="824"><span class="lineNum"> 824 </span> : : // constructor to create a TestCase object.</a>
|
|
<a name="825"><span class="lineNum"> 825 </span> : : //</a>
|
|
<a name="826"><span class="lineNum"> 826 </span> : : // Arguments:</a>
|
|
<a name="827"><span class="lineNum"> 827 </span> : : //</a>
|
|
<a name="828"><span class="lineNum"> 828 </span> : : // name: name of the test case</a>
|
|
<a name="829"><span class="lineNum"> 829 </span> : : // a_type_param: the name of the test's type parameter, or NULL if</a>
|
|
<a name="830"><span class="lineNum"> 830 </span> : : // this is not a type-parameterized test.</a>
|
|
<a name="831"><span class="lineNum"> 831 </span> : : // set_up_tc: pointer to the function that sets up the test case</a>
|
|
<a name="832"><span class="lineNum"> 832 </span> : : // tear_down_tc: pointer to the function that tears down the test case</a>
|
|
<a name="833"><span class="lineNum"> 833 </span> : : TestCase(const char* name, const char* a_type_param,</a>
|
|
<a name="834"><span class="lineNum"> 834 </span> : : Test::SetUpTestCaseFunc set_up_tc,</a>
|
|
<a name="835"><span class="lineNum"> 835 </span> : : Test::TearDownTestCaseFunc tear_down_tc);</a>
|
|
<a name="836"><span class="lineNum"> 836 </span> : : </a>
|
|
<a name="837"><span class="lineNum"> 837 </span> : : // Destructor of TestCase.</a>
|
|
<a name="838"><span class="lineNum"> 838 </span> : : virtual ~TestCase();</a>
|
|
<a name="839"><span class="lineNum"> 839 </span> : : </a>
|
|
<a name="840"><span class="lineNum"> 840 </span> : : // Gets the name of the TestCase.</a>
|
|
<a name="841"><span class="lineNum"> 841 </span> : : const char* name() const { return name_.c_str(); }</a>
|
|
<a name="842"><span class="lineNum"> 842 </span> : : </a>
|
|
<a name="843"><span class="lineNum"> 843 </span> : : // Returns the name of the parameter type, or NULL if this is not a</a>
|
|
<a name="844"><span class="lineNum"> 844 </span> : : // type-parameterized test case.</a>
|
|
<a name="845"><span class="lineNum"> 845 </span> : : const char* type_param() const {</a>
|
|
<a name="846"><span class="lineNum"> 846 </span> : : if (type_param_.get() != NULL)</a>
|
|
<a name="847"><span class="lineNum"> 847 </span> : : return type_param_->c_str();</a>
|
|
<a name="848"><span class="lineNum"> 848 </span> : : return NULL;</a>
|
|
<a name="849"><span class="lineNum"> 849 </span> : : }</a>
|
|
<a name="850"><span class="lineNum"> 850 </span> : : </a>
|
|
<a name="851"><span class="lineNum"> 851 </span> : : // Returns true if any test in this test case should run.</a>
|
|
<a name="852"><span class="lineNum"> 852 </span> : : bool should_run() const { return should_run_; }</a>
|
|
<a name="853"><span class="lineNum"> 853 </span> : : </a>
|
|
<a name="854"><span class="lineNum"> 854 </span> : : // Gets the number of successful tests in this test case.</a>
|
|
<a name="855"><span class="lineNum"> 855 </span> : : int successful_test_count() const;</a>
|
|
<a name="856"><span class="lineNum"> 856 </span> : : </a>
|
|
<a name="857"><span class="lineNum"> 857 </span> : : // Gets the number of failed tests in this test case.</a>
|
|
<a name="858"><span class="lineNum"> 858 </span> : : int failed_test_count() const;</a>
|
|
<a name="859"><span class="lineNum"> 859 </span> : : </a>
|
|
<a name="860"><span class="lineNum"> 860 </span> : : // Gets the number of disabled tests that will be reported in the XML report.</a>
|
|
<a name="861"><span class="lineNum"> 861 </span> : : int reportable_disabled_test_count() const;</a>
|
|
<a name="862"><span class="lineNum"> 862 </span> : : </a>
|
|
<a name="863"><span class="lineNum"> 863 </span> : : // Gets the number of disabled tests in this test case.</a>
|
|
<a name="864"><span class="lineNum"> 864 </span> : : int disabled_test_count() const;</a>
|
|
<a name="865"><span class="lineNum"> 865 </span> : : </a>
|
|
<a name="866"><span class="lineNum"> 866 </span> : : // Gets the number of tests to be printed in the XML report.</a>
|
|
<a name="867"><span class="lineNum"> 867 </span> : : int reportable_test_count() const;</a>
|
|
<a name="868"><span class="lineNum"> 868 </span> : : </a>
|
|
<a name="869"><span class="lineNum"> 869 </span> : : // Get the number of tests in this test case that should run.</a>
|
|
<a name="870"><span class="lineNum"> 870 </span> : : int test_to_run_count() const;</a>
|
|
<a name="871"><span class="lineNum"> 871 </span> : : </a>
|
|
<a name="872"><span class="lineNum"> 872 </span> : : // Gets the number of all tests in this test case.</a>
|
|
<a name="873"><span class="lineNum"> 873 </span> : : int total_test_count() const;</a>
|
|
<a name="874"><span class="lineNum"> 874 </span> : : </a>
|
|
<a name="875"><span class="lineNum"> 875 </span> : : // Returns true iff the test case passed.</a>
|
|
<a name="876"><span class="lineNum"> 876 </span> : : bool Passed() const { return !Failed(); }</a>
|
|
<a name="877"><span class="lineNum"> 877 </span> : : </a>
|
|
<a name="878"><span class="lineNum"> 878 </span> : : // Returns true iff the test case failed.</a>
|
|
<a name="879"><span class="lineNum"> 879 </span> : : bool Failed() const { return failed_test_count() > 0; }</a>
|
|
<a name="880"><span class="lineNum"> 880 </span> : : </a>
|
|
<a name="881"><span class="lineNum"> 881 </span> : : // Returns the elapsed time, in milliseconds.</a>
|
|
<a name="882"><span class="lineNum"> 882 </span> : : TimeInMillis elapsed_time() const { return elapsed_time_; }</a>
|
|
<a name="883"><span class="lineNum"> 883 </span> : : </a>
|
|
<a name="884"><span class="lineNum"> 884 </span> : : // Returns the i-th test among all the tests. i can range from 0 to</a>
|
|
<a name="885"><span class="lineNum"> 885 </span> : : // total_test_count() - 1. If i is not in that range, returns NULL.</a>
|
|
<a name="886"><span class="lineNum"> 886 </span> : : const TestInfo* GetTestInfo(int i) const;</a>
|
|
<a name="887"><span class="lineNum"> 887 </span> : : </a>
|
|
<a name="888"><span class="lineNum"> 888 </span> : : // Returns the TestResult that holds test properties recorded during</a>
|
|
<a name="889"><span class="lineNum"> 889 </span> : : // execution of SetUpTestCase and TearDownTestCase.</a>
|
|
<a name="890"><span class="lineNum"> 890 </span> : : const TestResult& ad_hoc_test_result() const { return ad_hoc_test_result_; }</a>
|
|
<a name="891"><span class="lineNum"> 891 </span> : : </a>
|
|
<a name="892"><span class="lineNum"> 892 </span> : : private:</a>
|
|
<a name="893"><span class="lineNum"> 893 </span> : : friend class Test;</a>
|
|
<a name="894"><span class="lineNum"> 894 </span> : : friend class internal::UnitTestImpl;</a>
|
|
<a name="895"><span class="lineNum"> 895 </span> : : </a>
|
|
<a name="896"><span class="lineNum"> 896 </span> : : // Gets the (mutable) vector of TestInfos in this TestCase.</a>
|
|
<a name="897"><span class="lineNum"> 897 </span> : : std::vector<TestInfo*>& test_info_list() { return test_info_list_; }</a>
|
|
<a name="898"><span class="lineNum"> 898 </span> : : </a>
|
|
<a name="899"><span class="lineNum"> 899 </span> : : // Gets the (immutable) vector of TestInfos in this TestCase.</a>
|
|
<a name="900"><span class="lineNum"> 900 </span> : : const std::vector<TestInfo*>& test_info_list() const {</a>
|
|
<a name="901"><span class="lineNum"> 901 </span> : : return test_info_list_;</a>
|
|
<a name="902"><span class="lineNum"> 902 </span> : : }</a>
|
|
<a name="903"><span class="lineNum"> 903 </span> : : </a>
|
|
<a name="904"><span class="lineNum"> 904 </span> : : // Returns the i-th test among all the tests. i can range from 0 to</a>
|
|
<a name="905"><span class="lineNum"> 905 </span> : : // total_test_count() - 1. If i is not in that range, returns NULL.</a>
|
|
<a name="906"><span class="lineNum"> 906 </span> : : TestInfo* GetMutableTestInfo(int i);</a>
|
|
<a name="907"><span class="lineNum"> 907 </span> : : </a>
|
|
<a name="908"><span class="lineNum"> 908 </span> : : // Sets the should_run member.</a>
|
|
<a name="909"><span class="lineNum"> 909 </span> : : void set_should_run(bool should) { should_run_ = should; }</a>
|
|
<a name="910"><span class="lineNum"> 910 </span> : : </a>
|
|
<a name="911"><span class="lineNum"> 911 </span> : : // Adds a TestInfo to this test case. Will delete the TestInfo upon</a>
|
|
<a name="912"><span class="lineNum"> 912 </span> : : // destruction of the TestCase object.</a>
|
|
<a name="913"><span class="lineNum"> 913 </span> : : void AddTestInfo(TestInfo * test_info);</a>
|
|
<a name="914"><span class="lineNum"> 914 </span> : : </a>
|
|
<a name="915"><span class="lineNum"> 915 </span> : : // Clears the results of all tests in this test case.</a>
|
|
<a name="916"><span class="lineNum"> 916 </span> : : void ClearResult();</a>
|
|
<a name="917"><span class="lineNum"> 917 </span> : : </a>
|
|
<a name="918"><span class="lineNum"> 918 </span> : : // Clears the results of all tests in the given test case.</a>
|
|
<a name="919"><span class="lineNum"> 919 </span> : : static void ClearTestCaseResult(TestCase* test_case) {</a>
|
|
<a name="920"><span class="lineNum"> 920 </span> : : test_case->ClearResult();</a>
|
|
<a name="921"><span class="lineNum"> 921 </span> : : }</a>
|
|
<a name="922"><span class="lineNum"> 922 </span> : : </a>
|
|
<a name="923"><span class="lineNum"> 923 </span> : : // Runs every test in this TestCase.</a>
|
|
<a name="924"><span class="lineNum"> 924 </span> : : void Run();</a>
|
|
<a name="925"><span class="lineNum"> 925 </span> : : </a>
|
|
<a name="926"><span class="lineNum"> 926 </span> : : // Runs SetUpTestCase() for this TestCase. This wrapper is needed</a>
|
|
<a name="927"><span class="lineNum"> 927 </span> : : // for catching exceptions thrown from SetUpTestCase().</a>
|
|
<a name="928"><span class="lineNum"> 928 </span> : : void RunSetUpTestCase() { (*set_up_tc_)(); }</a>
|
|
<a name="929"><span class="lineNum"> 929 </span> : : </a>
|
|
<a name="930"><span class="lineNum"> 930 </span> : : // Runs TearDownTestCase() for this TestCase. This wrapper is</a>
|
|
<a name="931"><span class="lineNum"> 931 </span> : : // needed for catching exceptions thrown from TearDownTestCase().</a>
|
|
<a name="932"><span class="lineNum"> 932 </span> : : void RunTearDownTestCase() { (*tear_down_tc_)(); }</a>
|
|
<a name="933"><span class="lineNum"> 933 </span> : : </a>
|
|
<a name="934"><span class="lineNum"> 934 </span> : : // Returns true iff test passed.</a>
|
|
<a name="935"><span class="lineNum"> 935 </span> : : static bool TestPassed(const TestInfo* test_info) {</a>
|
|
<a name="936"><span class="lineNum"> 936 </span> : : return test_info->should_run() && test_info->result()->Passed();</a>
|
|
<a name="937"><span class="lineNum"> 937 </span> : : }</a>
|
|
<a name="938"><span class="lineNum"> 938 </span> : : </a>
|
|
<a name="939"><span class="lineNum"> 939 </span> : : // Returns true iff test failed.</a>
|
|
<a name="940"><span class="lineNum"> 940 </span> : : static bool TestFailed(const TestInfo* test_info) {</a>
|
|
<a name="941"><span class="lineNum"> 941 </span> : : return test_info->should_run() && test_info->result()->Failed();</a>
|
|
<a name="942"><span class="lineNum"> 942 </span> : : }</a>
|
|
<a name="943"><span class="lineNum"> 943 </span> : : </a>
|
|
<a name="944"><span class="lineNum"> 944 </span> : : // Returns true iff the test is disabled and will be reported in the XML</a>
|
|
<a name="945"><span class="lineNum"> 945 </span> : : // report.</a>
|
|
<a name="946"><span class="lineNum"> 946 </span> : : static bool TestReportableDisabled(const TestInfo* test_info) {</a>
|
|
<a name="947"><span class="lineNum"> 947 </span> : : return test_info->is_reportable() && test_info->is_disabled_;</a>
|
|
<a name="948"><span class="lineNum"> 948 </span> : : }</a>
|
|
<a name="949"><span class="lineNum"> 949 </span> : : </a>
|
|
<a name="950"><span class="lineNum"> 950 </span> : : // Returns true iff test is disabled.</a>
|
|
<a name="951"><span class="lineNum"> 951 </span> : : static bool TestDisabled(const TestInfo* test_info) {</a>
|
|
<a name="952"><span class="lineNum"> 952 </span> : : return test_info->is_disabled_;</a>
|
|
<a name="953"><span class="lineNum"> 953 </span> : : }</a>
|
|
<a name="954"><span class="lineNum"> 954 </span> : : </a>
|
|
<a name="955"><span class="lineNum"> 955 </span> : : // Returns true iff this test will appear in the XML report.</a>
|
|
<a name="956"><span class="lineNum"> 956 </span> : : static bool TestReportable(const TestInfo* test_info) {</a>
|
|
<a name="957"><span class="lineNum"> 957 </span> : : return test_info->is_reportable();</a>
|
|
<a name="958"><span class="lineNum"> 958 </span> : : }</a>
|
|
<a name="959"><span class="lineNum"> 959 </span> : : </a>
|
|
<a name="960"><span class="lineNum"> 960 </span> : : // Returns true if the given test should run.</a>
|
|
<a name="961"><span class="lineNum"> 961 </span> : : static bool ShouldRunTest(const TestInfo* test_info) {</a>
|
|
<a name="962"><span class="lineNum"> 962 </span> : : return test_info->should_run();</a>
|
|
<a name="963"><span class="lineNum"> 963 </span> : : }</a>
|
|
<a name="964"><span class="lineNum"> 964 </span> : : </a>
|
|
<a name="965"><span class="lineNum"> 965 </span> : : // Shuffles the tests in this test case.</a>
|
|
<a name="966"><span class="lineNum"> 966 </span> : : void ShuffleTests(internal::Random* random);</a>
|
|
<a name="967"><span class="lineNum"> 967 </span> : : </a>
|
|
<a name="968"><span class="lineNum"> 968 </span> : : // Restores the test order to before the first shuffle.</a>
|
|
<a name="969"><span class="lineNum"> 969 </span> : : void UnshuffleTests();</a>
|
|
<a name="970"><span class="lineNum"> 970 </span> : : </a>
|
|
<a name="971"><span class="lineNum"> 971 </span> : : // Name of the test case.</a>
|
|
<a name="972"><span class="lineNum"> 972 </span> : : std::string name_;</a>
|
|
<a name="973"><span class="lineNum"> 973 </span> : : // Name of the parameter type, or NULL if this is not a typed or a</a>
|
|
<a name="974"><span class="lineNum"> 974 </span> : : // type-parameterized test.</a>
|
|
<a name="975"><span class="lineNum"> 975 </span> : : const internal::scoped_ptr<const ::std::string> type_param_;</a>
|
|
<a name="976"><span class="lineNum"> 976 </span> : : // The vector of TestInfos in their original order. It owns the</a>
|
|
<a name="977"><span class="lineNum"> 977 </span> : : // elements in the vector.</a>
|
|
<a name="978"><span class="lineNum"> 978 </span> : : std::vector<TestInfo*> test_info_list_;</a>
|
|
<a name="979"><span class="lineNum"> 979 </span> : : // Provides a level of indirection for the test list to allow easy</a>
|
|
<a name="980"><span class="lineNum"> 980 </span> : : // shuffling and restoring the test order. The i-th element in this</a>
|
|
<a name="981"><span class="lineNum"> 981 </span> : : // vector is the index of the i-th test in the shuffled test list.</a>
|
|
<a name="982"><span class="lineNum"> 982 </span> : : std::vector<int> test_indices_;</a>
|
|
<a name="983"><span class="lineNum"> 983 </span> : : // Pointer to the function that sets up the test case.</a>
|
|
<a name="984"><span class="lineNum"> 984 </span> : : Test::SetUpTestCaseFunc set_up_tc_;</a>
|
|
<a name="985"><span class="lineNum"> 985 </span> : : // Pointer to the function that tears down the test case.</a>
|
|
<a name="986"><span class="lineNum"> 986 </span> : : Test::TearDownTestCaseFunc tear_down_tc_;</a>
|
|
<a name="987"><span class="lineNum"> 987 </span> : : // True iff any test in this test case should run.</a>
|
|
<a name="988"><span class="lineNum"> 988 </span> : : bool should_run_;</a>
|
|
<a name="989"><span class="lineNum"> 989 </span> : : // Elapsed time, in milliseconds.</a>
|
|
<a name="990"><span class="lineNum"> 990 </span> : : TimeInMillis elapsed_time_;</a>
|
|
<a name="991"><span class="lineNum"> 991 </span> : : // Holds test properties recorded during execution of SetUpTestCase and</a>
|
|
<a name="992"><span class="lineNum"> 992 </span> : : // TearDownTestCase.</a>
|
|
<a name="993"><span class="lineNum"> 993 </span> : : TestResult ad_hoc_test_result_;</a>
|
|
<a name="994"><span class="lineNum"> 994 </span> : : </a>
|
|
<a name="995"><span class="lineNum"> 995 </span> : : // We disallow copying TestCases.</a>
|
|
<a name="996"><span class="lineNum"> 996 </span> : : GTEST_DISALLOW_COPY_AND_ASSIGN_(TestCase);</a>
|
|
<a name="997"><span class="lineNum"> 997 </span> : : };</a>
|
|
<a name="998"><span class="lineNum"> 998 </span> : : </a>
|
|
<a name="999"><span class="lineNum"> 999 </span> : : // An Environment object is capable of setting up and tearing down an</a>
|
|
<a name="1000"><span class="lineNum"> 1000 </span> : : // environment. You should subclass this to define your own</a>
|
|
<a name="1001"><span class="lineNum"> 1001 </span> : : // environment(s).</a>
|
|
<a name="1002"><span class="lineNum"> 1002 </span> : : //</a>
|
|
<a name="1003"><span class="lineNum"> 1003 </span> : : // An Environment object does the set-up and tear-down in virtual</a>
|
|
<a name="1004"><span class="lineNum"> 1004 </span> : : // methods SetUp() and TearDown() instead of the constructor and the</a>
|
|
<a name="1005"><span class="lineNum"> 1005 </span> : : // destructor, as:</a>
|
|
<a name="1006"><span class="lineNum"> 1006 </span> : : //</a>
|
|
<a name="1007"><span class="lineNum"> 1007 </span> : : // 1. You cannot safely throw from a destructor. This is a problem</a>
|
|
<a name="1008"><span class="lineNum"> 1008 </span> : : // as in some cases Google Test is used where exceptions are enabled, and</a>
|
|
<a name="1009"><span class="lineNum"> 1009 </span> : : // we may want to implement ASSERT_* using exceptions where they are</a>
|
|
<a name="1010"><span class="lineNum"> 1010 </span> : : // available.</a>
|
|
<a name="1011"><span class="lineNum"> 1011 </span> : : // 2. You cannot use ASSERT_* directly in a constructor or</a>
|
|
<a name="1012"><span class="lineNum"> 1012 </span> : : // destructor.</a>
|
|
<a name="1013"><span class="lineNum"> 1013 </span> : : class Environment {</a>
|
|
<a name="1014"><span class="lineNum"> 1014 </span> : : public:</a>
|
|
<a name="1015"><span class="lineNum"> 1015 </span> : : // The d'tor is virtual as we need to subclass Environment.</a>
|
|
<a name="1016"><span class="lineNum"> 1016 </span> : : virtual ~Environment() {}</a>
|
|
<a name="1017"><span class="lineNum"> 1017 </span> : : </a>
|
|
<a name="1018"><span class="lineNum"> 1018 </span> : : // Override this to define how to set up the environment.</a>
|
|
<a name="1019"><span class="lineNum"> 1019 </span> : : virtual void SetUp() {}</a>
|
|
<a name="1020"><span class="lineNum"> 1020 </span> : : </a>
|
|
<a name="1021"><span class="lineNum"> 1021 </span> : : // Override this to define how to tear down the environment.</a>
|
|
<a name="1022"><span class="lineNum"> 1022 </span> : : virtual void TearDown() {}</a>
|
|
<a name="1023"><span class="lineNum"> 1023 </span> : : private:</a>
|
|
<a name="1024"><span class="lineNum"> 1024 </span> : : // If you see an error about overriding the following function or</a>
|
|
<a name="1025"><span class="lineNum"> 1025 </span> : : // about it being private, you have mis-spelled SetUp() as Setup().</a>
|
|
<a name="1026"><span class="lineNum"> 1026 </span> : : struct Setup_should_be_spelled_SetUp {};</a>
|
|
<a name="1027"><span class="lineNum"> 1027 </span> : : virtual Setup_should_be_spelled_SetUp* Setup() { return NULL; }</a>
|
|
<a name="1028"><span class="lineNum"> 1028 </span> : : };</a>
|
|
<a name="1029"><span class="lineNum"> 1029 </span> : : </a>
|
|
<a name="1030"><span class="lineNum"> 1030 </span> : : #if GTEST_HAS_EXCEPTIONS</a>
|
|
<a name="1031"><span class="lineNum"> 1031 </span> : : </a>
|
|
<a name="1032"><span class="lineNum"> 1032 </span> : : // Exception which can be thrown from TestEventListener::OnTestPartResult.</a>
|
|
<a name="1033"><span class="lineNum"> 1033 </span> : : class GTEST_API_ AssertionException</a>
|
|
<a name="1034"><span class="lineNum"> 1034 </span> : : : public internal::GoogleTestFailureException {</a>
|
|
<a name="1035"><span class="lineNum"> 1035 </span> : : public:</a>
|
|
<a name="1036"><span class="lineNum"> 1036 </span> : : explicit AssertionException(const TestPartResult& result)</a>
|
|
<a name="1037"><span class="lineNum"> 1037 </span> : : : GoogleTestFailureException(result) {}</a>
|
|
<a name="1038"><span class="lineNum"> 1038 </span> : : };</a>
|
|
<a name="1039"><span class="lineNum"> 1039 </span> : : </a>
|
|
<a name="1040"><span class="lineNum"> 1040 </span> : : #endif // GTEST_HAS_EXCEPTIONS</a>
|
|
<a name="1041"><span class="lineNum"> 1041 </span> : : </a>
|
|
<a name="1042"><span class="lineNum"> 1042 </span> : : // The interface for tracing execution of tests. The methods are organized in</a>
|
|
<a name="1043"><span class="lineNum"> 1043 </span> : : // the order the corresponding events are fired.</a>
|
|
<a name="1044"><span class="lineNum"> 1044 </span> : : class TestEventListener {</a>
|
|
<a name="1045"><span class="lineNum"> 1045 </span> : : public:</a>
|
|
<a name="1046"><span class="lineNum"> 1046 </span> : : virtual ~TestEventListener() {}</a>
|
|
<a name="1047"><span class="lineNum"> 1047 </span> : : </a>
|
|
<a name="1048"><span class="lineNum"> 1048 </span> : : // Fired before any test activity starts.</a>
|
|
<a name="1049"><span class="lineNum"> 1049 </span> : : virtual void OnTestProgramStart(const UnitTest& unit_test) = 0;</a>
|
|
<a name="1050"><span class="lineNum"> 1050 </span> : : </a>
|
|
<a name="1051"><span class="lineNum"> 1051 </span> : : // Fired before each iteration of tests starts. There may be more than</a>
|
|
<a name="1052"><span class="lineNum"> 1052 </span> : : // one iteration if GTEST_FLAG(repeat) is set. iteration is the iteration</a>
|
|
<a name="1053"><span class="lineNum"> 1053 </span> : : // index, starting from 0.</a>
|
|
<a name="1054"><span class="lineNum"> 1054 </span> : : virtual void OnTestIterationStart(const UnitTest& unit_test,</a>
|
|
<a name="1055"><span class="lineNum"> 1055 </span> : : int iteration) = 0;</a>
|
|
<a name="1056"><span class="lineNum"> 1056 </span> : : </a>
|
|
<a name="1057"><span class="lineNum"> 1057 </span> : : // Fired before environment set-up for each iteration of tests starts.</a>
|
|
<a name="1058"><span class="lineNum"> 1058 </span> : : virtual void OnEnvironmentsSetUpStart(const UnitTest& unit_test) = 0;</a>
|
|
<a name="1059"><span class="lineNum"> 1059 </span> : : </a>
|
|
<a name="1060"><span class="lineNum"> 1060 </span> : : // Fired after environment set-up for each iteration of tests ends.</a>
|
|
<a name="1061"><span class="lineNum"> 1061 </span> : : virtual void OnEnvironmentsSetUpEnd(const UnitTest& unit_test) = 0;</a>
|
|
<a name="1062"><span class="lineNum"> 1062 </span> : : </a>
|
|
<a name="1063"><span class="lineNum"> 1063 </span> : : // Fired before the test case starts.</a>
|
|
<a name="1064"><span class="lineNum"> 1064 </span> : : virtual void OnTestCaseStart(const TestCase& test_case) = 0;</a>
|
|
<a name="1065"><span class="lineNum"> 1065 </span> : : </a>
|
|
<a name="1066"><span class="lineNum"> 1066 </span> : : // Fired before the test starts.</a>
|
|
<a name="1067"><span class="lineNum"> 1067 </span> : : virtual void OnTestStart(const TestInfo& test_info) = 0;</a>
|
|
<a name="1068"><span class="lineNum"> 1068 </span> : : </a>
|
|
<a name="1069"><span class="lineNum"> 1069 </span> : : // Fired after a failed assertion or a SUCCEED() invocation.</a>
|
|
<a name="1070"><span class="lineNum"> 1070 </span> : : // If you want to throw an exception from this function to skip to the next</a>
|
|
<a name="1071"><span class="lineNum"> 1071 </span> : : // TEST, it must be AssertionException defined above, or inherited from it.</a>
|
|
<a name="1072"><span class="lineNum"> 1072 </span> : : virtual void OnTestPartResult(const TestPartResult& test_part_result) = 0;</a>
|
|
<a name="1073"><span class="lineNum"> 1073 </span> : : </a>
|
|
<a name="1074"><span class="lineNum"> 1074 </span> : : // Fired after the test ends.</a>
|
|
<a name="1075"><span class="lineNum"> 1075 </span> : : virtual void OnTestEnd(const TestInfo& test_info) = 0;</a>
|
|
<a name="1076"><span class="lineNum"> 1076 </span> : : </a>
|
|
<a name="1077"><span class="lineNum"> 1077 </span> : : // Fired after the test case ends.</a>
|
|
<a name="1078"><span class="lineNum"> 1078 </span> : : virtual void OnTestCaseEnd(const TestCase& test_case) = 0;</a>
|
|
<a name="1079"><span class="lineNum"> 1079 </span> : : </a>
|
|
<a name="1080"><span class="lineNum"> 1080 </span> : : // Fired before environment tear-down for each iteration of tests starts.</a>
|
|
<a name="1081"><span class="lineNum"> 1081 </span> : : virtual void OnEnvironmentsTearDownStart(const UnitTest& unit_test) = 0;</a>
|
|
<a name="1082"><span class="lineNum"> 1082 </span> : : </a>
|
|
<a name="1083"><span class="lineNum"> 1083 </span> : : // Fired after environment tear-down for each iteration of tests ends.</a>
|
|
<a name="1084"><span class="lineNum"> 1084 </span> : : virtual void OnEnvironmentsTearDownEnd(const UnitTest& unit_test) = 0;</a>
|
|
<a name="1085"><span class="lineNum"> 1085 </span> : : </a>
|
|
<a name="1086"><span class="lineNum"> 1086 </span> : : // Fired after each iteration of tests finishes.</a>
|
|
<a name="1087"><span class="lineNum"> 1087 </span> : : virtual void OnTestIterationEnd(const UnitTest& unit_test,</a>
|
|
<a name="1088"><span class="lineNum"> 1088 </span> : : int iteration) = 0;</a>
|
|
<a name="1089"><span class="lineNum"> 1089 </span> : : </a>
|
|
<a name="1090"><span class="lineNum"> 1090 </span> : : // Fired after all test activities have ended.</a>
|
|
<a name="1091"><span class="lineNum"> 1091 </span> : : virtual void OnTestProgramEnd(const UnitTest& unit_test) = 0;</a>
|
|
<a name="1092"><span class="lineNum"> 1092 </span> : : };</a>
|
|
<a name="1093"><span class="lineNum"> 1093 </span> : : </a>
|
|
<a name="1094"><span class="lineNum"> 1094 </span> : : // The convenience class for users who need to override just one or two</a>
|
|
<a name="1095"><span class="lineNum"> 1095 </span> : : // methods and are not concerned that a possible change to a signature of</a>
|
|
<a name="1096"><span class="lineNum"> 1096 </span> : : // the methods they override will not be caught during the build. For</a>
|
|
<a name="1097"><span class="lineNum"> 1097 </span> : : // comments about each method please see the definition of TestEventListener</a>
|
|
<a name="1098"><span class="lineNum"> 1098 </span> : : // above.</a>
|
|
<a name="1099"><span class="lineNum"> 1099 </span> : : class EmptyTestEventListener : public TestEventListener {</a>
|
|
<a name="1100"><span class="lineNum"> 1100 </span> : : public:</a>
|
|
<a name="1101"><span class="lineNum"> 1101 </span> : : virtual void OnTestProgramStart(const UnitTest& /*unit_test*/) {}</a>
|
|
<a name="1102"><span class="lineNum"> 1102 </span> : : virtual void OnTestIterationStart(const UnitTest& /*unit_test*/,</a>
|
|
<a name="1103"><span class="lineNum"> 1103 </span> : : int /*iteration*/) {}</a>
|
|
<a name="1104"><span class="lineNum"> 1104 </span> : : virtual void OnEnvironmentsSetUpStart(const UnitTest& /*unit_test*/) {}</a>
|
|
<a name="1105"><span class="lineNum"> 1105 </span> : : virtual void OnEnvironmentsSetUpEnd(const UnitTest& /*unit_test*/) {}</a>
|
|
<a name="1106"><span class="lineNum"> 1106 </span> : : virtual void OnTestCaseStart(const TestCase& /*test_case*/) {}</a>
|
|
<a name="1107"><span class="lineNum"> 1107 </span> : : virtual void OnTestStart(const TestInfo& /*test_info*/) {}</a>
|
|
<a name="1108"><span class="lineNum"> 1108 </span> : : virtual void OnTestPartResult(const TestPartResult& /*test_part_result*/) {}</a>
|
|
<a name="1109"><span class="lineNum"> 1109 </span> : : virtual void OnTestEnd(const TestInfo& /*test_info*/) {}</a>
|
|
<a name="1110"><span class="lineNum"> 1110 </span> : : virtual void OnTestCaseEnd(const TestCase& /*test_case*/) {}</a>
|
|
<a name="1111"><span class="lineNum"> 1111 </span> : : virtual void OnEnvironmentsTearDownStart(const UnitTest& /*unit_test*/) {}</a>
|
|
<a name="1112"><span class="lineNum"> 1112 </span> : : virtual void OnEnvironmentsTearDownEnd(const UnitTest& /*unit_test*/) {}</a>
|
|
<a name="1113"><span class="lineNum"> 1113 </span> : : virtual void OnTestIterationEnd(const UnitTest& /*unit_test*/,</a>
|
|
<a name="1114"><span class="lineNum"> 1114 </span> : : int /*iteration*/) {}</a>
|
|
<a name="1115"><span class="lineNum"> 1115 </span> : : virtual void OnTestProgramEnd(const UnitTest& /*unit_test*/) {}</a>
|
|
<a name="1116"><span class="lineNum"> 1116 </span> : : };</a>
|
|
<a name="1117"><span class="lineNum"> 1117 </span> : : </a>
|
|
<a name="1118"><span class="lineNum"> 1118 </span> : : // TestEventListeners lets users add listeners to track events in Google Test.</a>
|
|
<a name="1119"><span class="lineNum"> 1119 </span> : : class GTEST_API_ TestEventListeners {</a>
|
|
<a name="1120"><span class="lineNum"> 1120 </span> : : public:</a>
|
|
<a name="1121"><span class="lineNum"> 1121 </span> : : TestEventListeners();</a>
|
|
<a name="1122"><span class="lineNum"> 1122 </span> : : ~TestEventListeners();</a>
|
|
<a name="1123"><span class="lineNum"> 1123 </span> : : </a>
|
|
<a name="1124"><span class="lineNum"> 1124 </span> : : // Appends an event listener to the end of the list. Google Test assumes</a>
|
|
<a name="1125"><span class="lineNum"> 1125 </span> : : // the ownership of the listener (i.e. it will delete the listener when</a>
|
|
<a name="1126"><span class="lineNum"> 1126 </span> : : // the test program finishes).</a>
|
|
<a name="1127"><span class="lineNum"> 1127 </span> : : void Append(TestEventListener* listener);</a>
|
|
<a name="1128"><span class="lineNum"> 1128 </span> : : </a>
|
|
<a name="1129"><span class="lineNum"> 1129 </span> : : // Removes the given event listener from the list and returns it. It then</a>
|
|
<a name="1130"><span class="lineNum"> 1130 </span> : : // becomes the caller's responsibility to delete the listener. Returns</a>
|
|
<a name="1131"><span class="lineNum"> 1131 </span> : : // NULL if the listener is not found in the list.</a>
|
|
<a name="1132"><span class="lineNum"> 1132 </span> : : TestEventListener* Release(TestEventListener* listener);</a>
|
|
<a name="1133"><span class="lineNum"> 1133 </span> : : </a>
|
|
<a name="1134"><span class="lineNum"> 1134 </span> : : // Returns the standard listener responsible for the default console</a>
|
|
<a name="1135"><span class="lineNum"> 1135 </span> : : // output. Can be removed from the listeners list to shut down default</a>
|
|
<a name="1136"><span class="lineNum"> 1136 </span> : : // console output. Note that removing this object from the listener list</a>
|
|
<a name="1137"><span class="lineNum"> 1137 </span> : : // with Release transfers its ownership to the caller and makes this</a>
|
|
<a name="1138"><span class="lineNum"> 1138 </span> : : // function return NULL the next time.</a>
|
|
<a name="1139"><span class="lineNum"> 1139 </span> : : TestEventListener* default_result_printer() const {</a>
|
|
<a name="1140"><span class="lineNum"> 1140 </span> : : return default_result_printer_;</a>
|
|
<a name="1141"><span class="lineNum"> 1141 </span> : : }</a>
|
|
<a name="1142"><span class="lineNum"> 1142 </span> : : </a>
|
|
<a name="1143"><span class="lineNum"> 1143 </span> : : // Returns the standard listener responsible for the default XML output</a>
|
|
<a name="1144"><span class="lineNum"> 1144 </span> : : // controlled by the --gtest_output=xml flag. Can be removed from the</a>
|
|
<a name="1145"><span class="lineNum"> 1145 </span> : : // listeners list by users who want to shut down the default XML output</a>
|
|
<a name="1146"><span class="lineNum"> 1146 </span> : : // controlled by this flag and substitute it with custom one. Note that</a>
|
|
<a name="1147"><span class="lineNum"> 1147 </span> : : // removing this object from the listener list with Release transfers its</a>
|
|
<a name="1148"><span class="lineNum"> 1148 </span> : : // ownership to the caller and makes this function return NULL the next</a>
|
|
<a name="1149"><span class="lineNum"> 1149 </span> : : // time.</a>
|
|
<a name="1150"><span class="lineNum"> 1150 </span> : : TestEventListener* default_xml_generator() const {</a>
|
|
<a name="1151"><span class="lineNum"> 1151 </span> : : return default_xml_generator_;</a>
|
|
<a name="1152"><span class="lineNum"> 1152 </span> : : }</a>
|
|
<a name="1153"><span class="lineNum"> 1153 </span> : : </a>
|
|
<a name="1154"><span class="lineNum"> 1154 </span> : : private:</a>
|
|
<a name="1155"><span class="lineNum"> 1155 </span> : : friend class TestCase;</a>
|
|
<a name="1156"><span class="lineNum"> 1156 </span> : : friend class TestInfo;</a>
|
|
<a name="1157"><span class="lineNum"> 1157 </span> : : friend class internal::DefaultGlobalTestPartResultReporter;</a>
|
|
<a name="1158"><span class="lineNum"> 1158 </span> : : friend class internal::NoExecDeathTest;</a>
|
|
<a name="1159"><span class="lineNum"> 1159 </span> : : friend class internal::TestEventListenersAccessor;</a>
|
|
<a name="1160"><span class="lineNum"> 1160 </span> : : friend class internal::UnitTestImpl;</a>
|
|
<a name="1161"><span class="lineNum"> 1161 </span> : : </a>
|
|
<a name="1162"><span class="lineNum"> 1162 </span> : : // Returns repeater that broadcasts the TestEventListener events to all</a>
|
|
<a name="1163"><span class="lineNum"> 1163 </span> : : // subscribers.</a>
|
|
<a name="1164"><span class="lineNum"> 1164 </span> : : TestEventListener* repeater();</a>
|
|
<a name="1165"><span class="lineNum"> 1165 </span> : : </a>
|
|
<a name="1166"><span class="lineNum"> 1166 </span> : : // Sets the default_result_printer attribute to the provided listener.</a>
|
|
<a name="1167"><span class="lineNum"> 1167 </span> : : // The listener is also added to the listener list and previous</a>
|
|
<a name="1168"><span class="lineNum"> 1168 </span> : : // default_result_printer is removed from it and deleted. The listener can</a>
|
|
<a name="1169"><span class="lineNum"> 1169 </span> : : // also be NULL in which case it will not be added to the list. Does</a>
|
|
<a name="1170"><span class="lineNum"> 1170 </span> : : // nothing if the previous and the current listener objects are the same.</a>
|
|
<a name="1171"><span class="lineNum"> 1171 </span> : : void SetDefaultResultPrinter(TestEventListener* listener);</a>
|
|
<a name="1172"><span class="lineNum"> 1172 </span> : : </a>
|
|
<a name="1173"><span class="lineNum"> 1173 </span> : : // Sets the default_xml_generator attribute to the provided listener. The</a>
|
|
<a name="1174"><span class="lineNum"> 1174 </span> : : // listener is also added to the listener list and previous</a>
|
|
<a name="1175"><span class="lineNum"> 1175 </span> : : // default_xml_generator is removed from it and deleted. The listener can</a>
|
|
<a name="1176"><span class="lineNum"> 1176 </span> : : // also be NULL in which case it will not be added to the list. Does</a>
|
|
<a name="1177"><span class="lineNum"> 1177 </span> : : // nothing if the previous and the current listener objects are the same.</a>
|
|
<a name="1178"><span class="lineNum"> 1178 </span> : : void SetDefaultXmlGenerator(TestEventListener* listener);</a>
|
|
<a name="1179"><span class="lineNum"> 1179 </span> : : </a>
|
|
<a name="1180"><span class="lineNum"> 1180 </span> : : // Controls whether events will be forwarded by the repeater to the</a>
|
|
<a name="1181"><span class="lineNum"> 1181 </span> : : // listeners in the list.</a>
|
|
<a name="1182"><span class="lineNum"> 1182 </span> : : bool EventForwardingEnabled() const;</a>
|
|
<a name="1183"><span class="lineNum"> 1183 </span> : : void SuppressEventForwarding();</a>
|
|
<a name="1184"><span class="lineNum"> 1184 </span> : : </a>
|
|
<a name="1185"><span class="lineNum"> 1185 </span> : : // The actual list of listeners.</a>
|
|
<a name="1186"><span class="lineNum"> 1186 </span> : : internal::TestEventRepeater* repeater_;</a>
|
|
<a name="1187"><span class="lineNum"> 1187 </span> : : // Listener responsible for the standard result output.</a>
|
|
<a name="1188"><span class="lineNum"> 1188 </span> : : TestEventListener* default_result_printer_;</a>
|
|
<a name="1189"><span class="lineNum"> 1189 </span> : : // Listener responsible for the creation of the XML output file.</a>
|
|
<a name="1190"><span class="lineNum"> 1190 </span> : : TestEventListener* default_xml_generator_;</a>
|
|
<a name="1191"><span class="lineNum"> 1191 </span> : : </a>
|
|
<a name="1192"><span class="lineNum"> 1192 </span> : : // We disallow copying TestEventListeners.</a>
|
|
<a name="1193"><span class="lineNum"> 1193 </span> : : GTEST_DISALLOW_COPY_AND_ASSIGN_(TestEventListeners);</a>
|
|
<a name="1194"><span class="lineNum"> 1194 </span> : : };</a>
|
|
<a name="1195"><span class="lineNum"> 1195 </span> : : </a>
|
|
<a name="1196"><span class="lineNum"> 1196 </span> : : // A UnitTest consists of a vector of TestCases.</a>
|
|
<a name="1197"><span class="lineNum"> 1197 </span> : : //</a>
|
|
<a name="1198"><span class="lineNum"> 1198 </span> : : // This is a singleton class. The only instance of UnitTest is</a>
|
|
<a name="1199"><span class="lineNum"> 1199 </span> : : // created when UnitTest::GetInstance() is first called. This</a>
|
|
<a name="1200"><span class="lineNum"> 1200 </span> : : // instance is never deleted.</a>
|
|
<a name="1201"><span class="lineNum"> 1201 </span> : : //</a>
|
|
<a name="1202"><span class="lineNum"> 1202 </span> : : // UnitTest is not copyable.</a>
|
|
<a name="1203"><span class="lineNum"> 1203 </span> : : //</a>
|
|
<a name="1204"><span class="lineNum"> 1204 </span> : : // This class is thread-safe as long as the methods are called</a>
|
|
<a name="1205"><span class="lineNum"> 1205 </span> : : // according to their specification.</a>
|
|
<a name="1206"><span class="lineNum"> 1206 </span> : : class GTEST_API_ UnitTest {</a>
|
|
<a name="1207"><span class="lineNum"> 1207 </span> : : public:</a>
|
|
<a name="1208"><span class="lineNum"> 1208 </span> : : // Gets the singleton UnitTest object. The first time this method</a>
|
|
<a name="1209"><span class="lineNum"> 1209 </span> : : // is called, a UnitTest object is constructed and returned.</a>
|
|
<a name="1210"><span class="lineNum"> 1210 </span> : : // Consecutive calls will return the same object.</a>
|
|
<a name="1211"><span class="lineNum"> 1211 </span> : : static UnitTest* GetInstance();</a>
|
|
<a name="1212"><span class="lineNum"> 1212 </span> : : </a>
|
|
<a name="1213"><span class="lineNum"> 1213 </span> : : // Runs all tests in this UnitTest object and prints the result.</a>
|
|
<a name="1214"><span class="lineNum"> 1214 </span> : : // Returns 0 if successful, or 1 otherwise.</a>
|
|
<a name="1215"><span class="lineNum"> 1215 </span> : : //</a>
|
|
<a name="1216"><span class="lineNum"> 1216 </span> : : // This method can only be called from the main thread.</a>
|
|
<a name="1217"><span class="lineNum"> 1217 </span> : : //</a>
|
|
<a name="1218"><span class="lineNum"> 1218 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="1219"><span class="lineNum"> 1219 </span> : : int Run() GTEST_MUST_USE_RESULT_;</a>
|
|
<a name="1220"><span class="lineNum"> 1220 </span> : : </a>
|
|
<a name="1221"><span class="lineNum"> 1221 </span> : : // Returns the working directory when the first TEST() or TEST_F()</a>
|
|
<a name="1222"><span class="lineNum"> 1222 </span> : : // was executed. The UnitTest object owns the string.</a>
|
|
<a name="1223"><span class="lineNum"> 1223 </span> : : const char* original_working_dir() const;</a>
|
|
<a name="1224"><span class="lineNum"> 1224 </span> : : </a>
|
|
<a name="1225"><span class="lineNum"> 1225 </span> : : // Returns the TestCase object for the test that's currently running,</a>
|
|
<a name="1226"><span class="lineNum"> 1226 </span> : : // or NULL if no test is running.</a>
|
|
<a name="1227"><span class="lineNum"> 1227 </span> : : const TestCase* current_test_case() const</a>
|
|
<a name="1228"><span class="lineNum"> 1228 </span> : : GTEST_LOCK_EXCLUDED_(mutex_);</a>
|
|
<a name="1229"><span class="lineNum"> 1229 </span> : : </a>
|
|
<a name="1230"><span class="lineNum"> 1230 </span> : : // Returns the TestInfo object for the test that's currently running,</a>
|
|
<a name="1231"><span class="lineNum"> 1231 </span> : : // or NULL if no test is running.</a>
|
|
<a name="1232"><span class="lineNum"> 1232 </span> : : const TestInfo* current_test_info() const</a>
|
|
<a name="1233"><span class="lineNum"> 1233 </span> : : GTEST_LOCK_EXCLUDED_(mutex_);</a>
|
|
<a name="1234"><span class="lineNum"> 1234 </span> : : </a>
|
|
<a name="1235"><span class="lineNum"> 1235 </span> : : // Returns the random seed used at the start of the current test run.</a>
|
|
<a name="1236"><span class="lineNum"> 1236 </span> : : int random_seed() const;</a>
|
|
<a name="1237"><span class="lineNum"> 1237 </span> : : </a>
|
|
<a name="1238"><span class="lineNum"> 1238 </span> : : // Returns the ParameterizedTestCaseRegistry object used to keep track of</a>
|
|
<a name="1239"><span class="lineNum"> 1239 </span> : : // value-parameterized tests and instantiate and register them.</a>
|
|
<a name="1240"><span class="lineNum"> 1240 </span> : : //</a>
|
|
<a name="1241"><span class="lineNum"> 1241 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="1242"><span class="lineNum"> 1242 </span> : : internal::ParameterizedTestCaseRegistry& parameterized_test_registry()</a>
|
|
<a name="1243"><span class="lineNum"> 1243 </span> : : GTEST_LOCK_EXCLUDED_(mutex_);</a>
|
|
<a name="1244"><span class="lineNum"> 1244 </span> : : </a>
|
|
<a name="1245"><span class="lineNum"> 1245 </span> : : // Gets the number of successful test cases.</a>
|
|
<a name="1246"><span class="lineNum"> 1246 </span> : : int successful_test_case_count() const;</a>
|
|
<a name="1247"><span class="lineNum"> 1247 </span> : : </a>
|
|
<a name="1248"><span class="lineNum"> 1248 </span> : : // Gets the number of failed test cases.</a>
|
|
<a name="1249"><span class="lineNum"> 1249 </span> : : int failed_test_case_count() const;</a>
|
|
<a name="1250"><span class="lineNum"> 1250 </span> : : </a>
|
|
<a name="1251"><span class="lineNum"> 1251 </span> : : // Gets the number of all test cases.</a>
|
|
<a name="1252"><span class="lineNum"> 1252 </span> : : int total_test_case_count() const;</a>
|
|
<a name="1253"><span class="lineNum"> 1253 </span> : : </a>
|
|
<a name="1254"><span class="lineNum"> 1254 </span> : : // Gets the number of all test cases that contain at least one test</a>
|
|
<a name="1255"><span class="lineNum"> 1255 </span> : : // that should run.</a>
|
|
<a name="1256"><span class="lineNum"> 1256 </span> : : int test_case_to_run_count() const;</a>
|
|
<a name="1257"><span class="lineNum"> 1257 </span> : : </a>
|
|
<a name="1258"><span class="lineNum"> 1258 </span> : : // Gets the number of successful tests.</a>
|
|
<a name="1259"><span class="lineNum"> 1259 </span> : : int successful_test_count() const;</a>
|
|
<a name="1260"><span class="lineNum"> 1260 </span> : : </a>
|
|
<a name="1261"><span class="lineNum"> 1261 </span> : : // Gets the number of failed tests.</a>
|
|
<a name="1262"><span class="lineNum"> 1262 </span> : : int failed_test_count() const;</a>
|
|
<a name="1263"><span class="lineNum"> 1263 </span> : : </a>
|
|
<a name="1264"><span class="lineNum"> 1264 </span> : : // Gets the number of disabled tests that will be reported in the XML report.</a>
|
|
<a name="1265"><span class="lineNum"> 1265 </span> : : int reportable_disabled_test_count() const;</a>
|
|
<a name="1266"><span class="lineNum"> 1266 </span> : : </a>
|
|
<a name="1267"><span class="lineNum"> 1267 </span> : : // Gets the number of disabled tests.</a>
|
|
<a name="1268"><span class="lineNum"> 1268 </span> : : int disabled_test_count() const;</a>
|
|
<a name="1269"><span class="lineNum"> 1269 </span> : : </a>
|
|
<a name="1270"><span class="lineNum"> 1270 </span> : : // Gets the number of tests to be printed in the XML report.</a>
|
|
<a name="1271"><span class="lineNum"> 1271 </span> : : int reportable_test_count() const;</a>
|
|
<a name="1272"><span class="lineNum"> 1272 </span> : : </a>
|
|
<a name="1273"><span class="lineNum"> 1273 </span> : : // Gets the number of all tests.</a>
|
|
<a name="1274"><span class="lineNum"> 1274 </span> : : int total_test_count() const;</a>
|
|
<a name="1275"><span class="lineNum"> 1275 </span> : : </a>
|
|
<a name="1276"><span class="lineNum"> 1276 </span> : : // Gets the number of tests that should run.</a>
|
|
<a name="1277"><span class="lineNum"> 1277 </span> : : int test_to_run_count() const;</a>
|
|
<a name="1278"><span class="lineNum"> 1278 </span> : : </a>
|
|
<a name="1279"><span class="lineNum"> 1279 </span> : : // Gets the time of the test program start, in ms from the start of the</a>
|
|
<a name="1280"><span class="lineNum"> 1280 </span> : : // UNIX epoch.</a>
|
|
<a name="1281"><span class="lineNum"> 1281 </span> : : TimeInMillis start_timestamp() const;</a>
|
|
<a name="1282"><span class="lineNum"> 1282 </span> : : </a>
|
|
<a name="1283"><span class="lineNum"> 1283 </span> : : // Gets the elapsed time, in milliseconds.</a>
|
|
<a name="1284"><span class="lineNum"> 1284 </span> : : TimeInMillis elapsed_time() const;</a>
|
|
<a name="1285"><span class="lineNum"> 1285 </span> : : </a>
|
|
<a name="1286"><span class="lineNum"> 1286 </span> : : // Returns true iff the unit test passed (i.e. all test cases passed).</a>
|
|
<a name="1287"><span class="lineNum"> 1287 </span> : : bool Passed() const;</a>
|
|
<a name="1288"><span class="lineNum"> 1288 </span> : : </a>
|
|
<a name="1289"><span class="lineNum"> 1289 </span> : : // Returns true iff the unit test failed (i.e. some test case failed</a>
|
|
<a name="1290"><span class="lineNum"> 1290 </span> : : // or something outside of all tests failed).</a>
|
|
<a name="1291"><span class="lineNum"> 1291 </span> : : bool Failed() const;</a>
|
|
<a name="1292"><span class="lineNum"> 1292 </span> : : </a>
|
|
<a name="1293"><span class="lineNum"> 1293 </span> : : // Gets the i-th test case among all the test cases. i can range from 0 to</a>
|
|
<a name="1294"><span class="lineNum"> 1294 </span> : : // total_test_case_count() - 1. If i is not in that range, returns NULL.</a>
|
|
<a name="1295"><span class="lineNum"> 1295 </span> : : const TestCase* GetTestCase(int i) const;</a>
|
|
<a name="1296"><span class="lineNum"> 1296 </span> : : </a>
|
|
<a name="1297"><span class="lineNum"> 1297 </span> : : // Returns the TestResult containing information on test failures and</a>
|
|
<a name="1298"><span class="lineNum"> 1298 </span> : : // properties logged outside of individual test cases.</a>
|
|
<a name="1299"><span class="lineNum"> 1299 </span> : : const TestResult& ad_hoc_test_result() const;</a>
|
|
<a name="1300"><span class="lineNum"> 1300 </span> : : </a>
|
|
<a name="1301"><span class="lineNum"> 1301 </span> : : // Returns the list of event listeners that can be used to track events</a>
|
|
<a name="1302"><span class="lineNum"> 1302 </span> : : // inside Google Test.</a>
|
|
<a name="1303"><span class="lineNum"> 1303 </span> : : TestEventListeners& listeners();</a>
|
|
<a name="1304"><span class="lineNum"> 1304 </span> : : </a>
|
|
<a name="1305"><span class="lineNum"> 1305 </span> : : private:</a>
|
|
<a name="1306"><span class="lineNum"> 1306 </span> : : // Registers and returns a global test environment. When a test</a>
|
|
<a name="1307"><span class="lineNum"> 1307 </span> : : // program is run, all global test environments will be set-up in</a>
|
|
<a name="1308"><span class="lineNum"> 1308 </span> : : // the order they were registered. After all tests in the program</a>
|
|
<a name="1309"><span class="lineNum"> 1309 </span> : : // have finished, all global test environments will be torn-down in</a>
|
|
<a name="1310"><span class="lineNum"> 1310 </span> : : // the *reverse* order they were registered.</a>
|
|
<a name="1311"><span class="lineNum"> 1311 </span> : : //</a>
|
|
<a name="1312"><span class="lineNum"> 1312 </span> : : // The UnitTest object takes ownership of the given environment.</a>
|
|
<a name="1313"><span class="lineNum"> 1313 </span> : : //</a>
|
|
<a name="1314"><span class="lineNum"> 1314 </span> : : // This method can only be called from the main thread.</a>
|
|
<a name="1315"><span class="lineNum"> 1315 </span> : : Environment* AddEnvironment(Environment* env);</a>
|
|
<a name="1316"><span class="lineNum"> 1316 </span> : : </a>
|
|
<a name="1317"><span class="lineNum"> 1317 </span> : : // Adds a TestPartResult to the current TestResult object. All</a>
|
|
<a name="1318"><span class="lineNum"> 1318 </span> : : // Google Test assertion macros (e.g. ASSERT_TRUE, EXPECT_EQ, etc)</a>
|
|
<a name="1319"><span class="lineNum"> 1319 </span> : : // eventually call this to report their results. The user code</a>
|
|
<a name="1320"><span class="lineNum"> 1320 </span> : : // should use the assertion macros instead of calling this directly.</a>
|
|
<a name="1321"><span class="lineNum"> 1321 </span> : : void AddTestPartResult(TestPartResult::Type result_type,</a>
|
|
<a name="1322"><span class="lineNum"> 1322 </span> : : const char* file_name,</a>
|
|
<a name="1323"><span class="lineNum"> 1323 </span> : : int line_number,</a>
|
|
<a name="1324"><span class="lineNum"> 1324 </span> : : const std::string& message,</a>
|
|
<a name="1325"><span class="lineNum"> 1325 </span> : : const std::string& os_stack_trace)</a>
|
|
<a name="1326"><span class="lineNum"> 1326 </span> : : GTEST_LOCK_EXCLUDED_(mutex_);</a>
|
|
<a name="1327"><span class="lineNum"> 1327 </span> : : </a>
|
|
<a name="1328"><span class="lineNum"> 1328 </span> : : // Adds a TestProperty to the current TestResult object when invoked from</a>
|
|
<a name="1329"><span class="lineNum"> 1329 </span> : : // inside a test, to current TestCase's ad_hoc_test_result_ when invoked</a>
|
|
<a name="1330"><span class="lineNum"> 1330 </span> : : // from SetUpTestCase or TearDownTestCase, or to the global property set</a>
|
|
<a name="1331"><span class="lineNum"> 1331 </span> : : // when invoked elsewhere. If the result already contains a property with</a>
|
|
<a name="1332"><span class="lineNum"> 1332 </span> : : // the same key, the value will be updated.</a>
|
|
<a name="1333"><span class="lineNum"> 1333 </span> : : void RecordProperty(const std::string& key, const std::string& value);</a>
|
|
<a name="1334"><span class="lineNum"> 1334 </span> : : </a>
|
|
<a name="1335"><span class="lineNum"> 1335 </span> : : // Gets the i-th test case among all the test cases. i can range from 0 to</a>
|
|
<a name="1336"><span class="lineNum"> 1336 </span> : : // total_test_case_count() - 1. If i is not in that range, returns NULL.</a>
|
|
<a name="1337"><span class="lineNum"> 1337 </span> : : TestCase* GetMutableTestCase(int i);</a>
|
|
<a name="1338"><span class="lineNum"> 1338 </span> : : </a>
|
|
<a name="1339"><span class="lineNum"> 1339 </span> : : // Accessors for the implementation object.</a>
|
|
<a name="1340"><span class="lineNum"> 1340 </span> : : internal::UnitTestImpl* impl() { return impl_; }</a>
|
|
<a name="1341"><span class="lineNum"> 1341 </span> : : const internal::UnitTestImpl* impl() const { return impl_; }</a>
|
|
<a name="1342"><span class="lineNum"> 1342 </span> : : </a>
|
|
<a name="1343"><span class="lineNum"> 1343 </span> : : // These classes and functions are friends as they need to access private</a>
|
|
<a name="1344"><span class="lineNum"> 1344 </span> : : // members of UnitTest.</a>
|
|
<a name="1345"><span class="lineNum"> 1345 </span> : : friend class ScopedTrace;</a>
|
|
<a name="1346"><span class="lineNum"> 1346 </span> : : friend class Test;</a>
|
|
<a name="1347"><span class="lineNum"> 1347 </span> : : friend class internal::AssertHelper;</a>
|
|
<a name="1348"><span class="lineNum"> 1348 </span> : : friend class internal::StreamingListenerTest;</a>
|
|
<a name="1349"><span class="lineNum"> 1349 </span> : : friend class internal::UnitTestRecordPropertyTestHelper;</a>
|
|
<a name="1350"><span class="lineNum"> 1350 </span> : : friend Environment* AddGlobalTestEnvironment(Environment* env);</a>
|
|
<a name="1351"><span class="lineNum"> 1351 </span> : : friend internal::UnitTestImpl* internal::GetUnitTestImpl();</a>
|
|
<a name="1352"><span class="lineNum"> 1352 </span> : : friend void internal::ReportFailureInUnknownLocation(</a>
|
|
<a name="1353"><span class="lineNum"> 1353 </span> : : TestPartResult::Type result_type,</a>
|
|
<a name="1354"><span class="lineNum"> 1354 </span> : : const std::string& message);</a>
|
|
<a name="1355"><span class="lineNum"> 1355 </span> : : </a>
|
|
<a name="1356"><span class="lineNum"> 1356 </span> : : // Creates an empty UnitTest.</a>
|
|
<a name="1357"><span class="lineNum"> 1357 </span> : : UnitTest();</a>
|
|
<a name="1358"><span class="lineNum"> 1358 </span> : : </a>
|
|
<a name="1359"><span class="lineNum"> 1359 </span> : : // D'tor</a>
|
|
<a name="1360"><span class="lineNum"> 1360 </span> : : virtual ~UnitTest();</a>
|
|
<a name="1361"><span class="lineNum"> 1361 </span> : : </a>
|
|
<a name="1362"><span class="lineNum"> 1362 </span> : : // Pushes a trace defined by SCOPED_TRACE() on to the per-thread</a>
|
|
<a name="1363"><span class="lineNum"> 1363 </span> : : // Google Test trace stack.</a>
|
|
<a name="1364"><span class="lineNum"> 1364 </span> : : void PushGTestTrace(const internal::TraceInfo& trace)</a>
|
|
<a name="1365"><span class="lineNum"> 1365 </span> : : GTEST_LOCK_EXCLUDED_(mutex_);</a>
|
|
<a name="1366"><span class="lineNum"> 1366 </span> : : </a>
|
|
<a name="1367"><span class="lineNum"> 1367 </span> : : // Pops a trace from the per-thread Google Test trace stack.</a>
|
|
<a name="1368"><span class="lineNum"> 1368 </span> : : void PopGTestTrace()</a>
|
|
<a name="1369"><span class="lineNum"> 1369 </span> : : GTEST_LOCK_EXCLUDED_(mutex_);</a>
|
|
<a name="1370"><span class="lineNum"> 1370 </span> : : </a>
|
|
<a name="1371"><span class="lineNum"> 1371 </span> : : // Protects mutable state in *impl_. This is mutable as some const</a>
|
|
<a name="1372"><span class="lineNum"> 1372 </span> : : // methods need to lock it too.</a>
|
|
<a name="1373"><span class="lineNum"> 1373 </span> : : mutable internal::Mutex mutex_;</a>
|
|
<a name="1374"><span class="lineNum"> 1374 </span> : : </a>
|
|
<a name="1375"><span class="lineNum"> 1375 </span> : : // Opaque implementation object. This field is never changed once</a>
|
|
<a name="1376"><span class="lineNum"> 1376 </span> : : // the object is constructed. We don't mark it as const here, as</a>
|
|
<a name="1377"><span class="lineNum"> 1377 </span> : : // doing so will cause a warning in the constructor of UnitTest.</a>
|
|
<a name="1378"><span class="lineNum"> 1378 </span> : : // Mutable state in *impl_ is protected by mutex_.</a>
|
|
<a name="1379"><span class="lineNum"> 1379 </span> : : internal::UnitTestImpl* impl_;</a>
|
|
<a name="1380"><span class="lineNum"> 1380 </span> : : </a>
|
|
<a name="1381"><span class="lineNum"> 1381 </span> : : // We disallow copying UnitTest.</a>
|
|
<a name="1382"><span class="lineNum"> 1382 </span> : : GTEST_DISALLOW_COPY_AND_ASSIGN_(UnitTest);</a>
|
|
<a name="1383"><span class="lineNum"> 1383 </span> : : };</a>
|
|
<a name="1384"><span class="lineNum"> 1384 </span> : : </a>
|
|
<a name="1385"><span class="lineNum"> 1385 </span> : : // A convenient wrapper for adding an environment for the test</a>
|
|
<a name="1386"><span class="lineNum"> 1386 </span> : : // program.</a>
|
|
<a name="1387"><span class="lineNum"> 1387 </span> : : //</a>
|
|
<a name="1388"><span class="lineNum"> 1388 </span> : : // You should call this before RUN_ALL_TESTS() is called, probably in</a>
|
|
<a name="1389"><span class="lineNum"> 1389 </span> : : // main(). If you use gtest_main, you need to call this before main()</a>
|
|
<a name="1390"><span class="lineNum"> 1390 </span> : : // starts for it to take effect. For example, you can define a global</a>
|
|
<a name="1391"><span class="lineNum"> 1391 </span> : : // variable like this:</a>
|
|
<a name="1392"><span class="lineNum"> 1392 </span> : : //</a>
|
|
<a name="1393"><span class="lineNum"> 1393 </span> : : // testing::Environment* const foo_env =</a>
|
|
<a name="1394"><span class="lineNum"> 1394 </span> : : // testing::AddGlobalTestEnvironment(new FooEnvironment);</a>
|
|
<a name="1395"><span class="lineNum"> 1395 </span> : : //</a>
|
|
<a name="1396"><span class="lineNum"> 1396 </span> : : // However, we strongly recommend you to write your own main() and</a>
|
|
<a name="1397"><span class="lineNum"> 1397 </span> : : // call AddGlobalTestEnvironment() there, as relying on initialization</a>
|
|
<a name="1398"><span class="lineNum"> 1398 </span> : : // of global variables makes the code harder to read and may cause</a>
|
|
<a name="1399"><span class="lineNum"> 1399 </span> : : // problems when you register multiple environments from different</a>
|
|
<a name="1400"><span class="lineNum"> 1400 </span> : : // translation units and the environments have dependencies among them</a>
|
|
<a name="1401"><span class="lineNum"> 1401 </span> : : // (remember that the compiler doesn't guarantee the order in which</a>
|
|
<a name="1402"><span class="lineNum"> 1402 </span> : : // global variables from different translation units are initialized).</a>
|
|
<a name="1403"><span class="lineNum"> 1403 </span> : : inline Environment* AddGlobalTestEnvironment(Environment* env) {</a>
|
|
<a name="1404"><span class="lineNum"> 1404 </span> : : return UnitTest::GetInstance()->AddEnvironment(env);</a>
|
|
<a name="1405"><span class="lineNum"> 1405 </span> : : }</a>
|
|
<a name="1406"><span class="lineNum"> 1406 </span> : : </a>
|
|
<a name="1407"><span class="lineNum"> 1407 </span> : : // Initializes Google Test. This must be called before calling</a>
|
|
<a name="1408"><span class="lineNum"> 1408 </span> : : // RUN_ALL_TESTS(). In particular, it parses a command line for the</a>
|
|
<a name="1409"><span class="lineNum"> 1409 </span> : : // flags that Google Test recognizes. Whenever a Google Test flag is</a>
|
|
<a name="1410"><span class="lineNum"> 1410 </span> : : // seen, it is removed from argv, and *argc is decremented.</a>
|
|
<a name="1411"><span class="lineNum"> 1411 </span> : : //</a>
|
|
<a name="1412"><span class="lineNum"> 1412 </span> : : // No value is returned. Instead, the Google Test flag variables are</a>
|
|
<a name="1413"><span class="lineNum"> 1413 </span> : : // updated.</a>
|
|
<a name="1414"><span class="lineNum"> 1414 </span> : : //</a>
|
|
<a name="1415"><span class="lineNum"> 1415 </span> : : // Calling the function for the second time has no user-visible effect.</a>
|
|
<a name="1416"><span class="lineNum"> 1416 </span> : : GTEST_API_ void InitGoogleTest(int* argc, char** argv);</a>
|
|
<a name="1417"><span class="lineNum"> 1417 </span> : : </a>
|
|
<a name="1418"><span class="lineNum"> 1418 </span> : : // This overloaded version can be used in Windows programs compiled in</a>
|
|
<a name="1419"><span class="lineNum"> 1419 </span> : : // UNICODE mode.</a>
|
|
<a name="1420"><span class="lineNum"> 1420 </span> : : GTEST_API_ void InitGoogleTest(int* argc, wchar_t** argv);</a>
|
|
<a name="1421"><span class="lineNum"> 1421 </span> : : </a>
|
|
<a name="1422"><span class="lineNum"> 1422 </span> : : namespace internal {</a>
|
|
<a name="1423"><span class="lineNum"> 1423 </span> : : </a>
|
|
<a name="1424"><span class="lineNum"> 1424 </span> : : // Separate the error generating code from the code path to reduce the stack</a>
|
|
<a name="1425"><span class="lineNum"> 1425 </span> : : // frame size of CmpHelperEQ. This helps reduce the overhead of some sanitizers</a>
|
|
<a name="1426"><span class="lineNum"> 1426 </span> : : // when calling EXPECT_* in a tight loop.</a>
|
|
<a name="1427"><span class="lineNum"> 1427 </span> : : template <typename T1, typename T2></a>
|
|
<a name="1428"><span class="lineNum"> 1428 </span> :<span class="lineNoCov"> 0 : AssertionResult CmpHelperEQFailure(const char* lhs_expression,</span></a>
|
|
<a name="1429"><span class="lineNum"> 1429 </span> : : const char* rhs_expression,</a>
|
|
<a name="1430"><span class="lineNum"> 1430 </span> : : const T1& lhs, const T2& rhs) {</a>
|
|
<a name="1431"><span class="lineNum"> 1431 </span> : : return EqFailure(lhs_expression,</a>
|
|
<a name="1432"><span class="lineNum"> 1432 </span> : : rhs_expression,</a>
|
|
<a name="1433"><span class="lineNum"> 1433 </span> : : FormatForComparisonFailureMessage(lhs, rhs),</a>
|
|
<a name="1434"><span class="lineNum"> 1434 </span> : : FormatForComparisonFailureMessage(rhs, lhs),</a>
|
|
<a name="1435"><span class="lineNum"> 1435 </span> [<span class="branchNoExec" title="Branch 0 was not executed"> # </span><span class="branchNoExec" title="Branch 1 was not executed"> # </span><span class="branchNoExec" title="Branch 2 was not executed"> # </span><span class="branchNoExec" title="Branch 3 was not executed"> # </span>]:<span class="lineNoCov"> 0 : false);</span></a>
|
|
<a name="1436"><span class="lineNum"> 1436 </span> : : }</a>
|
|
<a name="1437"><span class="lineNum"> 1437 </span> : : </a>
|
|
<a name="1438"><span class="lineNum"> 1438 </span> : : // The helper function for {ASSERT|EXPECT}_EQ.</a>
|
|
<a name="1439"><span class="lineNum"> 1439 </span> : : template <typename T1, typename T2></a>
|
|
<a name="1440"><span class="lineNum"> 1440 </span> :<span class="lineCov"> 5 : AssertionResult CmpHelperEQ(const char* lhs_expression,</span></a>
|
|
<a name="1441"><span class="lineNum"> 1441 </span> : : const char* rhs_expression,</a>
|
|
<a name="1442"><span class="lineNum"> 1442 </span> : : const T1& lhs,</a>
|
|
<a name="1443"><span class="lineNum"> 1443 </span> : : const T2& rhs) {</a>
|
|
<a name="1444"><span class="lineNum"> 1444 </span> [<span class="branchCov" title="Branch 0 was taken 5 times"> + </span><span class="branchNoCov" title="Branch 1 was not taken"> - </span>]:<span class="lineCov"> 5 : if (lhs == rhs) {</span></a>
|
|
<a name="1445"><span class="lineNum"> 1445 </span> :<span class="lineCov"> 5 : return AssertionSuccess();</span></a>
|
|
<a name="1446"><span class="lineNum"> 1446 </span> : : }</a>
|
|
<a name="1447"><span class="lineNum"> 1447 </span> : : </a>
|
|
<a name="1448"><span class="lineNum"> 1448 </span> :<span class="lineNoCov"> 0 : return CmpHelperEQFailure(lhs_expression, rhs_expression, lhs, rhs);</span></a>
|
|
<a name="1449"><span class="lineNum"> 1449 </span> : : }</a>
|
|
<a name="1450"><span class="lineNum"> 1450 </span> : : </a>
|
|
<a name="1451"><span class="lineNum"> 1451 </span> : : // With this overloaded version, we allow anonymous enums to be used</a>
|
|
<a name="1452"><span class="lineNum"> 1452 </span> : : // in {ASSERT|EXPECT}_EQ when compiled with gcc 4, as anonymous enums</a>
|
|
<a name="1453"><span class="lineNum"> 1453 </span> : : // can be implicitly cast to BiggestInt.</a>
|
|
<a name="1454"><span class="lineNum"> 1454 </span> : : GTEST_API_ AssertionResult CmpHelperEQ(const char* lhs_expression,</a>
|
|
<a name="1455"><span class="lineNum"> 1455 </span> : : const char* rhs_expression,</a>
|
|
<a name="1456"><span class="lineNum"> 1456 </span> : : BiggestInt lhs,</a>
|
|
<a name="1457"><span class="lineNum"> 1457 </span> : : BiggestInt rhs);</a>
|
|
<a name="1458"><span class="lineNum"> 1458 </span> : : </a>
|
|
<a name="1459"><span class="lineNum"> 1459 </span> : : // The helper class for {ASSERT|EXPECT}_EQ. The template argument</a>
|
|
<a name="1460"><span class="lineNum"> 1460 </span> : : // lhs_is_null_literal is true iff the first argument to ASSERT_EQ()</a>
|
|
<a name="1461"><span class="lineNum"> 1461 </span> : : // is a null pointer literal. The following default implementation is</a>
|
|
<a name="1462"><span class="lineNum"> 1462 </span> : : // for lhs_is_null_literal being false.</a>
|
|
<a name="1463"><span class="lineNum"> 1463 </span> : : template <bool lhs_is_null_literal></a>
|
|
<a name="1464"><span class="lineNum"> 1464 </span> : : class EqHelper {</a>
|
|
<a name="1465"><span class="lineNum"> 1465 </span> : : public:</a>
|
|
<a name="1466"><span class="lineNum"> 1466 </span> : : // This templatized version is for the general case.</a>
|
|
<a name="1467"><span class="lineNum"> 1467 </span> : : template <typename T1, typename T2></a>
|
|
<a name="1468"><span class="lineNum"> 1468 </span> :<span class="lineCov"> 5 : static AssertionResult Compare(const char* lhs_expression,</span></a>
|
|
<a name="1469"><span class="lineNum"> 1469 </span> : : const char* rhs_expression,</a>
|
|
<a name="1470"><span class="lineNum"> 1470 </span> : : const T1& lhs,</a>
|
|
<a name="1471"><span class="lineNum"> 1471 </span> : : const T2& rhs) {</a>
|
|
<a name="1472"><span class="lineNum"> 1472 </span> :<span class="lineCov"> 5 : return CmpHelperEQ(lhs_expression, rhs_expression, lhs, rhs);</span></a>
|
|
<a name="1473"><span class="lineNum"> 1473 </span> : : }</a>
|
|
<a name="1474"><span class="lineNum"> 1474 </span> : : </a>
|
|
<a name="1475"><span class="lineNum"> 1475 </span> : : // With this overloaded version, we allow anonymous enums to be used</a>
|
|
<a name="1476"><span class="lineNum"> 1476 </span> : : // in {ASSERT|EXPECT}_EQ when compiled with gcc 4, as anonymous</a>
|
|
<a name="1477"><span class="lineNum"> 1477 </span> : : // enums can be implicitly cast to BiggestInt.</a>
|
|
<a name="1478"><span class="lineNum"> 1478 </span> : : //</a>
|
|
<a name="1479"><span class="lineNum"> 1479 </span> : : // Even though its body looks the same as the above version, we</a>
|
|
<a name="1480"><span class="lineNum"> 1480 </span> : : // cannot merge the two, as it will make anonymous enums unhappy.</a>
|
|
<a name="1481"><span class="lineNum"> 1481 </span> : : static AssertionResult Compare(const char* lhs_expression,</a>
|
|
<a name="1482"><span class="lineNum"> 1482 </span> : : const char* rhs_expression,</a>
|
|
<a name="1483"><span class="lineNum"> 1483 </span> : : BiggestInt lhs,</a>
|
|
<a name="1484"><span class="lineNum"> 1484 </span> : : BiggestInt rhs) {</a>
|
|
<a name="1485"><span class="lineNum"> 1485 </span> : : return CmpHelperEQ(lhs_expression, rhs_expression, lhs, rhs);</a>
|
|
<a name="1486"><span class="lineNum"> 1486 </span> : : }</a>
|
|
<a name="1487"><span class="lineNum"> 1487 </span> : : };</a>
|
|
<a name="1488"><span class="lineNum"> 1488 </span> : : </a>
|
|
<a name="1489"><span class="lineNum"> 1489 </span> : : // This specialization is used when the first argument to ASSERT_EQ()</a>
|
|
<a name="1490"><span class="lineNum"> 1490 </span> : : // is a null pointer literal, like NULL, false, or 0.</a>
|
|
<a name="1491"><span class="lineNum"> 1491 </span> : : template <></a>
|
|
<a name="1492"><span class="lineNum"> 1492 </span> : : class EqHelper<true> {</a>
|
|
<a name="1493"><span class="lineNum"> 1493 </span> : : public:</a>
|
|
<a name="1494"><span class="lineNum"> 1494 </span> : : // We define two overloaded versions of Compare(). The first</a>
|
|
<a name="1495"><span class="lineNum"> 1495 </span> : : // version will be picked when the second argument to ASSERT_EQ() is</a>
|
|
<a name="1496"><span class="lineNum"> 1496 </span> : : // NOT a pointer, e.g. ASSERT_EQ(0, AnIntFunction()) or</a>
|
|
<a name="1497"><span class="lineNum"> 1497 </span> : : // EXPECT_EQ(false, a_bool).</a>
|
|
<a name="1498"><span class="lineNum"> 1498 </span> : : template <typename T1, typename T2></a>
|
|
<a name="1499"><span class="lineNum"> 1499 </span> : : static AssertionResult Compare(</a>
|
|
<a name="1500"><span class="lineNum"> 1500 </span> : : const char* lhs_expression,</a>
|
|
<a name="1501"><span class="lineNum"> 1501 </span> : : const char* rhs_expression,</a>
|
|
<a name="1502"><span class="lineNum"> 1502 </span> : : const T1& lhs,</a>
|
|
<a name="1503"><span class="lineNum"> 1503 </span> : : const T2& rhs,</a>
|
|
<a name="1504"><span class="lineNum"> 1504 </span> : : // The following line prevents this overload from being considered if T2</a>
|
|
<a name="1505"><span class="lineNum"> 1505 </span> : : // is not a pointer type. We need this because ASSERT_EQ(NULL, my_ptr)</a>
|
|
<a name="1506"><span class="lineNum"> 1506 </span> : : // expands to Compare("", "", NULL, my_ptr), which requires a conversion</a>
|
|
<a name="1507"><span class="lineNum"> 1507 </span> : : // to match the Secret* in the other overload, which would otherwise make</a>
|
|
<a name="1508"><span class="lineNum"> 1508 </span> : : // this template match better.</a>
|
|
<a name="1509"><span class="lineNum"> 1509 </span> : : typename EnableIf<!is_pointer<T2>::value>::type* = 0) {</a>
|
|
<a name="1510"><span class="lineNum"> 1510 </span> : : return CmpHelperEQ(lhs_expression, rhs_expression, lhs, rhs);</a>
|
|
<a name="1511"><span class="lineNum"> 1511 </span> : : }</a>
|
|
<a name="1512"><span class="lineNum"> 1512 </span> : : </a>
|
|
<a name="1513"><span class="lineNum"> 1513 </span> : : // This version will be picked when the second argument to ASSERT_EQ() is a</a>
|
|
<a name="1514"><span class="lineNum"> 1514 </span> : : // pointer, e.g. ASSERT_EQ(NULL, a_pointer).</a>
|
|
<a name="1515"><span class="lineNum"> 1515 </span> : : template <typename T></a>
|
|
<a name="1516"><span class="lineNum"> 1516 </span> : : static AssertionResult Compare(</a>
|
|
<a name="1517"><span class="lineNum"> 1517 </span> : : const char* lhs_expression,</a>
|
|
<a name="1518"><span class="lineNum"> 1518 </span> : : const char* rhs_expression,</a>
|
|
<a name="1519"><span class="lineNum"> 1519 </span> : : // We used to have a second template parameter instead of Secret*. That</a>
|
|
<a name="1520"><span class="lineNum"> 1520 </span> : : // template parameter would deduce to 'long', making this a better match</a>
|
|
<a name="1521"><span class="lineNum"> 1521 </span> : : // than the first overload even without the first overload's EnableIf.</a>
|
|
<a name="1522"><span class="lineNum"> 1522 </span> : : // Unfortunately, gcc with -Wconversion-null warns when "passing NULL to</a>
|
|
<a name="1523"><span class="lineNum"> 1523 </span> : : // non-pointer argument" (even a deduced integral argument), so the old</a>
|
|
<a name="1524"><span class="lineNum"> 1524 </span> : : // implementation caused warnings in user code.</a>
|
|
<a name="1525"><span class="lineNum"> 1525 </span> : : Secret* /* lhs (NULL) */,</a>
|
|
<a name="1526"><span class="lineNum"> 1526 </span> : : T* rhs) {</a>
|
|
<a name="1527"><span class="lineNum"> 1527 </span> : : // We already know that 'lhs' is a null pointer.</a>
|
|
<a name="1528"><span class="lineNum"> 1528 </span> : : return CmpHelperEQ(lhs_expression, rhs_expression,</a>
|
|
<a name="1529"><span class="lineNum"> 1529 </span> : : static_cast<T*>(NULL), rhs);</a>
|
|
<a name="1530"><span class="lineNum"> 1530 </span> : : }</a>
|
|
<a name="1531"><span class="lineNum"> 1531 </span> : : };</a>
|
|
<a name="1532"><span class="lineNum"> 1532 </span> : : </a>
|
|
<a name="1533"><span class="lineNum"> 1533 </span> : : // Separate the error generating code from the code path to reduce the stack</a>
|
|
<a name="1534"><span class="lineNum"> 1534 </span> : : // frame size of CmpHelperOP. This helps reduce the overhead of some sanitizers</a>
|
|
<a name="1535"><span class="lineNum"> 1535 </span> : : // when calling EXPECT_OP in a tight loop.</a>
|
|
<a name="1536"><span class="lineNum"> 1536 </span> : : template <typename T1, typename T2></a>
|
|
<a name="1537"><span class="lineNum"> 1537 </span> : : AssertionResult CmpHelperOpFailure(const char* expr1, const char* expr2,</a>
|
|
<a name="1538"><span class="lineNum"> 1538 </span> : : const T1& val1, const T2& val2,</a>
|
|
<a name="1539"><span class="lineNum"> 1539 </span> : : const char* op) {</a>
|
|
<a name="1540"><span class="lineNum"> 1540 </span> : : return AssertionFailure()</a>
|
|
<a name="1541"><span class="lineNum"> 1541 </span> : : << "Expected: (" << expr1 << ") " << op << " (" << expr2</a>
|
|
<a name="1542"><span class="lineNum"> 1542 </span> : : << "), actual: " << FormatForComparisonFailureMessage(val1, val2)</a>
|
|
<a name="1543"><span class="lineNum"> 1543 </span> : : << " vs " << FormatForComparisonFailureMessage(val2, val1);</a>
|
|
<a name="1544"><span class="lineNum"> 1544 </span> : : }</a>
|
|
<a name="1545"><span class="lineNum"> 1545 </span> : : </a>
|
|
<a name="1546"><span class="lineNum"> 1546 </span> : : // A macro for implementing the helper functions needed to implement</a>
|
|
<a name="1547"><span class="lineNum"> 1547 </span> : : // ASSERT_?? and EXPECT_??. It is here just to avoid copy-and-paste</a>
|
|
<a name="1548"><span class="lineNum"> 1548 </span> : : // of similar code.</a>
|
|
<a name="1549"><span class="lineNum"> 1549 </span> : : //</a>
|
|
<a name="1550"><span class="lineNum"> 1550 </span> : : // For each templatized helper function, we also define an overloaded</a>
|
|
<a name="1551"><span class="lineNum"> 1551 </span> : : // version for BiggestInt in order to reduce code bloat and allow</a>
|
|
<a name="1552"><span class="lineNum"> 1552 </span> : : // anonymous enums to be used with {ASSERT|EXPECT}_?? when compiled</a>
|
|
<a name="1553"><span class="lineNum"> 1553 </span> : : // with gcc 4.</a>
|
|
<a name="1554"><span class="lineNum"> 1554 </span> : : //</a>
|
|
<a name="1555"><span class="lineNum"> 1555 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="1556"><span class="lineNum"> 1556 </span> : : </a>
|
|
<a name="1557"><span class="lineNum"> 1557 </span> : : #define GTEST_IMPL_CMP_HELPER_(op_name, op)\</a>
|
|
<a name="1558"><span class="lineNum"> 1558 </span> : : template <typename T1, typename T2>\</a>
|
|
<a name="1559"><span class="lineNum"> 1559 </span> : : AssertionResult CmpHelper##op_name(const char* expr1, const char* expr2, \</a>
|
|
<a name="1560"><span class="lineNum"> 1560 </span> : : const T1& val1, const T2& val2) {\</a>
|
|
<a name="1561"><span class="lineNum"> 1561 </span> : : if (val1 op val2) {\</a>
|
|
<a name="1562"><span class="lineNum"> 1562 </span> : : return AssertionSuccess();\</a>
|
|
<a name="1563"><span class="lineNum"> 1563 </span> : : } else {\</a>
|
|
<a name="1564"><span class="lineNum"> 1564 </span> : : return CmpHelperOpFailure(expr1, expr2, val1, val2, #op);\</a>
|
|
<a name="1565"><span class="lineNum"> 1565 </span> : : }\</a>
|
|
<a name="1566"><span class="lineNum"> 1566 </span> : : }\</a>
|
|
<a name="1567"><span class="lineNum"> 1567 </span> : : GTEST_API_ AssertionResult CmpHelper##op_name(\</a>
|
|
<a name="1568"><span class="lineNum"> 1568 </span> : : const char* expr1, const char* expr2, BiggestInt val1, BiggestInt val2)</a>
|
|
<a name="1569"><span class="lineNum"> 1569 </span> : : </a>
|
|
<a name="1570"><span class="lineNum"> 1570 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="1571"><span class="lineNum"> 1571 </span> : : </a>
|
|
<a name="1572"><span class="lineNum"> 1572 </span> : : // Implements the helper function for {ASSERT|EXPECT}_NE</a>
|
|
<a name="1573"><span class="lineNum"> 1573 </span> : : GTEST_IMPL_CMP_HELPER_(NE, !=);</a>
|
|
<a name="1574"><span class="lineNum"> 1574 </span> : : // Implements the helper function for {ASSERT|EXPECT}_LE</a>
|
|
<a name="1575"><span class="lineNum"> 1575 </span> : : GTEST_IMPL_CMP_HELPER_(LE, <=);</a>
|
|
<a name="1576"><span class="lineNum"> 1576 </span> : : // Implements the helper function for {ASSERT|EXPECT}_LT</a>
|
|
<a name="1577"><span class="lineNum"> 1577 </span> : : GTEST_IMPL_CMP_HELPER_(LT, <);</a>
|
|
<a name="1578"><span class="lineNum"> 1578 </span> : : // Implements the helper function for {ASSERT|EXPECT}_GE</a>
|
|
<a name="1579"><span class="lineNum"> 1579 </span> : : GTEST_IMPL_CMP_HELPER_(GE, >=);</a>
|
|
<a name="1580"><span class="lineNum"> 1580 </span> : : // Implements the helper function for {ASSERT|EXPECT}_GT</a>
|
|
<a name="1581"><span class="lineNum"> 1581 </span> : : GTEST_IMPL_CMP_HELPER_(GT, >);</a>
|
|
<a name="1582"><span class="lineNum"> 1582 </span> : : </a>
|
|
<a name="1583"><span class="lineNum"> 1583 </span> : : #undef GTEST_IMPL_CMP_HELPER_</a>
|
|
<a name="1584"><span class="lineNum"> 1584 </span> : : </a>
|
|
<a name="1585"><span class="lineNum"> 1585 </span> : : // The helper function for {ASSERT|EXPECT}_STREQ.</a>
|
|
<a name="1586"><span class="lineNum"> 1586 </span> : : //</a>
|
|
<a name="1587"><span class="lineNum"> 1587 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="1588"><span class="lineNum"> 1588 </span> : : GTEST_API_ AssertionResult CmpHelperSTREQ(const char* s1_expression,</a>
|
|
<a name="1589"><span class="lineNum"> 1589 </span> : : const char* s2_expression,</a>
|
|
<a name="1590"><span class="lineNum"> 1590 </span> : : const char* s1,</a>
|
|
<a name="1591"><span class="lineNum"> 1591 </span> : : const char* s2);</a>
|
|
<a name="1592"><span class="lineNum"> 1592 </span> : : </a>
|
|
<a name="1593"><span class="lineNum"> 1593 </span> : : // The helper function for {ASSERT|EXPECT}_STRCASEEQ.</a>
|
|
<a name="1594"><span class="lineNum"> 1594 </span> : : //</a>
|
|
<a name="1595"><span class="lineNum"> 1595 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="1596"><span class="lineNum"> 1596 </span> : : GTEST_API_ AssertionResult CmpHelperSTRCASEEQ(const char* s1_expression,</a>
|
|
<a name="1597"><span class="lineNum"> 1597 </span> : : const char* s2_expression,</a>
|
|
<a name="1598"><span class="lineNum"> 1598 </span> : : const char* s1,</a>
|
|
<a name="1599"><span class="lineNum"> 1599 </span> : : const char* s2);</a>
|
|
<a name="1600"><span class="lineNum"> 1600 </span> : : </a>
|
|
<a name="1601"><span class="lineNum"> 1601 </span> : : // The helper function for {ASSERT|EXPECT}_STRNE.</a>
|
|
<a name="1602"><span class="lineNum"> 1602 </span> : : //</a>
|
|
<a name="1603"><span class="lineNum"> 1603 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="1604"><span class="lineNum"> 1604 </span> : : GTEST_API_ AssertionResult CmpHelperSTRNE(const char* s1_expression,</a>
|
|
<a name="1605"><span class="lineNum"> 1605 </span> : : const char* s2_expression,</a>
|
|
<a name="1606"><span class="lineNum"> 1606 </span> : : const char* s1,</a>
|
|
<a name="1607"><span class="lineNum"> 1607 </span> : : const char* s2);</a>
|
|
<a name="1608"><span class="lineNum"> 1608 </span> : : </a>
|
|
<a name="1609"><span class="lineNum"> 1609 </span> : : // The helper function for {ASSERT|EXPECT}_STRCASENE.</a>
|
|
<a name="1610"><span class="lineNum"> 1610 </span> : : //</a>
|
|
<a name="1611"><span class="lineNum"> 1611 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="1612"><span class="lineNum"> 1612 </span> : : GTEST_API_ AssertionResult CmpHelperSTRCASENE(const char* s1_expression,</a>
|
|
<a name="1613"><span class="lineNum"> 1613 </span> : : const char* s2_expression,</a>
|
|
<a name="1614"><span class="lineNum"> 1614 </span> : : const char* s1,</a>
|
|
<a name="1615"><span class="lineNum"> 1615 </span> : : const char* s2);</a>
|
|
<a name="1616"><span class="lineNum"> 1616 </span> : : </a>
|
|
<a name="1617"><span class="lineNum"> 1617 </span> : : </a>
|
|
<a name="1618"><span class="lineNum"> 1618 </span> : : // Helper function for *_STREQ on wide strings.</a>
|
|
<a name="1619"><span class="lineNum"> 1619 </span> : : //</a>
|
|
<a name="1620"><span class="lineNum"> 1620 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="1621"><span class="lineNum"> 1621 </span> : : GTEST_API_ AssertionResult CmpHelperSTREQ(const char* s1_expression,</a>
|
|
<a name="1622"><span class="lineNum"> 1622 </span> : : const char* s2_expression,</a>
|
|
<a name="1623"><span class="lineNum"> 1623 </span> : : const wchar_t* s1,</a>
|
|
<a name="1624"><span class="lineNum"> 1624 </span> : : const wchar_t* s2);</a>
|
|
<a name="1625"><span class="lineNum"> 1625 </span> : : </a>
|
|
<a name="1626"><span class="lineNum"> 1626 </span> : : // Helper function for *_STRNE on wide strings.</a>
|
|
<a name="1627"><span class="lineNum"> 1627 </span> : : //</a>
|
|
<a name="1628"><span class="lineNum"> 1628 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="1629"><span class="lineNum"> 1629 </span> : : GTEST_API_ AssertionResult CmpHelperSTRNE(const char* s1_expression,</a>
|
|
<a name="1630"><span class="lineNum"> 1630 </span> : : const char* s2_expression,</a>
|
|
<a name="1631"><span class="lineNum"> 1631 </span> : : const wchar_t* s1,</a>
|
|
<a name="1632"><span class="lineNum"> 1632 </span> : : const wchar_t* s2);</a>
|
|
<a name="1633"><span class="lineNum"> 1633 </span> : : </a>
|
|
<a name="1634"><span class="lineNum"> 1634 </span> : : } // namespace internal</a>
|
|
<a name="1635"><span class="lineNum"> 1635 </span> : : </a>
|
|
<a name="1636"><span class="lineNum"> 1636 </span> : : // IsSubstring() and IsNotSubstring() are intended to be used as the</a>
|
|
<a name="1637"><span class="lineNum"> 1637 </span> : : // first argument to {EXPECT,ASSERT}_PRED_FORMAT2(), not by</a>
|
|
<a name="1638"><span class="lineNum"> 1638 </span> : : // themselves. They check whether needle is a substring of haystack</a>
|
|
<a name="1639"><span class="lineNum"> 1639 </span> : : // (NULL is considered a substring of itself only), and return an</a>
|
|
<a name="1640"><span class="lineNum"> 1640 </span> : : // appropriate error message when they fail.</a>
|
|
<a name="1641"><span class="lineNum"> 1641 </span> : : //</a>
|
|
<a name="1642"><span class="lineNum"> 1642 </span> : : // The {needle,haystack}_expr arguments are the stringified</a>
|
|
<a name="1643"><span class="lineNum"> 1643 </span> : : // expressions that generated the two real arguments.</a>
|
|
<a name="1644"><span class="lineNum"> 1644 </span> : : GTEST_API_ AssertionResult IsSubstring(</a>
|
|
<a name="1645"><span class="lineNum"> 1645 </span> : : const char* needle_expr, const char* haystack_expr,</a>
|
|
<a name="1646"><span class="lineNum"> 1646 </span> : : const char* needle, const char* haystack);</a>
|
|
<a name="1647"><span class="lineNum"> 1647 </span> : : GTEST_API_ AssertionResult IsSubstring(</a>
|
|
<a name="1648"><span class="lineNum"> 1648 </span> : : const char* needle_expr, const char* haystack_expr,</a>
|
|
<a name="1649"><span class="lineNum"> 1649 </span> : : const wchar_t* needle, const wchar_t* haystack);</a>
|
|
<a name="1650"><span class="lineNum"> 1650 </span> : : GTEST_API_ AssertionResult IsNotSubstring(</a>
|
|
<a name="1651"><span class="lineNum"> 1651 </span> : : const char* needle_expr, const char* haystack_expr,</a>
|
|
<a name="1652"><span class="lineNum"> 1652 </span> : : const char* needle, const char* haystack);</a>
|
|
<a name="1653"><span class="lineNum"> 1653 </span> : : GTEST_API_ AssertionResult IsNotSubstring(</a>
|
|
<a name="1654"><span class="lineNum"> 1654 </span> : : const char* needle_expr, const char* haystack_expr,</a>
|
|
<a name="1655"><span class="lineNum"> 1655 </span> : : const wchar_t* needle, const wchar_t* haystack);</a>
|
|
<a name="1656"><span class="lineNum"> 1656 </span> : : GTEST_API_ AssertionResult IsSubstring(</a>
|
|
<a name="1657"><span class="lineNum"> 1657 </span> : : const char* needle_expr, const char* haystack_expr,</a>
|
|
<a name="1658"><span class="lineNum"> 1658 </span> : : const ::std::string& needle, const ::std::string& haystack);</a>
|
|
<a name="1659"><span class="lineNum"> 1659 </span> : : GTEST_API_ AssertionResult IsNotSubstring(</a>
|
|
<a name="1660"><span class="lineNum"> 1660 </span> : : const char* needle_expr, const char* haystack_expr,</a>
|
|
<a name="1661"><span class="lineNum"> 1661 </span> : : const ::std::string& needle, const ::std::string& haystack);</a>
|
|
<a name="1662"><span class="lineNum"> 1662 </span> : : </a>
|
|
<a name="1663"><span class="lineNum"> 1663 </span> : : #if GTEST_HAS_STD_WSTRING</a>
|
|
<a name="1664"><span class="lineNum"> 1664 </span> : : GTEST_API_ AssertionResult IsSubstring(</a>
|
|
<a name="1665"><span class="lineNum"> 1665 </span> : : const char* needle_expr, const char* haystack_expr,</a>
|
|
<a name="1666"><span class="lineNum"> 1666 </span> : : const ::std::wstring& needle, const ::std::wstring& haystack);</a>
|
|
<a name="1667"><span class="lineNum"> 1667 </span> : : GTEST_API_ AssertionResult IsNotSubstring(</a>
|
|
<a name="1668"><span class="lineNum"> 1668 </span> : : const char* needle_expr, const char* haystack_expr,</a>
|
|
<a name="1669"><span class="lineNum"> 1669 </span> : : const ::std::wstring& needle, const ::std::wstring& haystack);</a>
|
|
<a name="1670"><span class="lineNum"> 1670 </span> : : #endif // GTEST_HAS_STD_WSTRING</a>
|
|
<a name="1671"><span class="lineNum"> 1671 </span> : : </a>
|
|
<a name="1672"><span class="lineNum"> 1672 </span> : : namespace internal {</a>
|
|
<a name="1673"><span class="lineNum"> 1673 </span> : : </a>
|
|
<a name="1674"><span class="lineNum"> 1674 </span> : : // Helper template function for comparing floating-points.</a>
|
|
<a name="1675"><span class="lineNum"> 1675 </span> : : //</a>
|
|
<a name="1676"><span class="lineNum"> 1676 </span> : : // Template parameter:</a>
|
|
<a name="1677"><span class="lineNum"> 1677 </span> : : //</a>
|
|
<a name="1678"><span class="lineNum"> 1678 </span> : : // RawType: the raw floating-point type (either float or double)</a>
|
|
<a name="1679"><span class="lineNum"> 1679 </span> : : //</a>
|
|
<a name="1680"><span class="lineNum"> 1680 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="1681"><span class="lineNum"> 1681 </span> : : template <typename RawType></a>
|
|
<a name="1682"><span class="lineNum"> 1682 </span> : : AssertionResult CmpHelperFloatingPointEQ(const char* lhs_expression,</a>
|
|
<a name="1683"><span class="lineNum"> 1683 </span> : : const char* rhs_expression,</a>
|
|
<a name="1684"><span class="lineNum"> 1684 </span> : : RawType lhs_value,</a>
|
|
<a name="1685"><span class="lineNum"> 1685 </span> : : RawType rhs_value) {</a>
|
|
<a name="1686"><span class="lineNum"> 1686 </span> : : const FloatingPoint<RawType> lhs(lhs_value), rhs(rhs_value);</a>
|
|
<a name="1687"><span class="lineNum"> 1687 </span> : : </a>
|
|
<a name="1688"><span class="lineNum"> 1688 </span> : : if (lhs.AlmostEquals(rhs)) {</a>
|
|
<a name="1689"><span class="lineNum"> 1689 </span> : : return AssertionSuccess();</a>
|
|
<a name="1690"><span class="lineNum"> 1690 </span> : : }</a>
|
|
<a name="1691"><span class="lineNum"> 1691 </span> : : </a>
|
|
<a name="1692"><span class="lineNum"> 1692 </span> : : ::std::stringstream lhs_ss;</a>
|
|
<a name="1693"><span class="lineNum"> 1693 </span> : : lhs_ss << std::setprecision(std::numeric_limits<RawType>::digits10 + 2)</a>
|
|
<a name="1694"><span class="lineNum"> 1694 </span> : : << lhs_value;</a>
|
|
<a name="1695"><span class="lineNum"> 1695 </span> : : </a>
|
|
<a name="1696"><span class="lineNum"> 1696 </span> : : ::std::stringstream rhs_ss;</a>
|
|
<a name="1697"><span class="lineNum"> 1697 </span> : : rhs_ss << std::setprecision(std::numeric_limits<RawType>::digits10 + 2)</a>
|
|
<a name="1698"><span class="lineNum"> 1698 </span> : : << rhs_value;</a>
|
|
<a name="1699"><span class="lineNum"> 1699 </span> : : </a>
|
|
<a name="1700"><span class="lineNum"> 1700 </span> : : return EqFailure(lhs_expression,</a>
|
|
<a name="1701"><span class="lineNum"> 1701 </span> : : rhs_expression,</a>
|
|
<a name="1702"><span class="lineNum"> 1702 </span> : : StringStreamToString(&lhs_ss),</a>
|
|
<a name="1703"><span class="lineNum"> 1703 </span> : : StringStreamToString(&rhs_ss),</a>
|
|
<a name="1704"><span class="lineNum"> 1704 </span> : : false);</a>
|
|
<a name="1705"><span class="lineNum"> 1705 </span> : : }</a>
|
|
<a name="1706"><span class="lineNum"> 1706 </span> : : </a>
|
|
<a name="1707"><span class="lineNum"> 1707 </span> : : // Helper function for implementing ASSERT_NEAR.</a>
|
|
<a name="1708"><span class="lineNum"> 1708 </span> : : //</a>
|
|
<a name="1709"><span class="lineNum"> 1709 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</a>
|
|
<a name="1710"><span class="lineNum"> 1710 </span> : : GTEST_API_ AssertionResult DoubleNearPredFormat(const char* expr1,</a>
|
|
<a name="1711"><span class="lineNum"> 1711 </span> : : const char* expr2,</a>
|
|
<a name="1712"><span class="lineNum"> 1712 </span> : : const char* abs_error_expr,</a>
|
|
<a name="1713"><span class="lineNum"> 1713 </span> : : double val1,</a>
|
|
<a name="1714"><span class="lineNum"> 1714 </span> : : double val2,</a>
|
|
<a name="1715"><span class="lineNum"> 1715 </span> : : double abs_error);</a>
|
|
<a name="1716"><span class="lineNum"> 1716 </span> : : </a>
|
|
<a name="1717"><span class="lineNum"> 1717 </span> : : // INTERNAL IMPLEMENTATION - DO NOT USE IN USER CODE.</a>
|
|
<a name="1718"><span class="lineNum"> 1718 </span> : : // A class that enables one to stream messages to assertion macros</a>
|
|
<a name="1719"><span class="lineNum"> 1719 </span> : : class GTEST_API_ AssertHelper {</a>
|
|
<a name="1720"><span class="lineNum"> 1720 </span> : : public:</a>
|
|
<a name="1721"><span class="lineNum"> 1721 </span> : : // Constructor.</a>
|
|
<a name="1722"><span class="lineNum"> 1722 </span> : : AssertHelper(TestPartResult::Type type,</a>
|
|
<a name="1723"><span class="lineNum"> 1723 </span> : : const char* file,</a>
|
|
<a name="1724"><span class="lineNum"> 1724 </span> : : int line,</a>
|
|
<a name="1725"><span class="lineNum"> 1725 </span> : : const char* message);</a>
|
|
<a name="1726"><span class="lineNum"> 1726 </span> : : ~AssertHelper();</a>
|
|
<a name="1727"><span class="lineNum"> 1727 </span> : : </a>
|
|
<a name="1728"><span class="lineNum"> 1728 </span> : : // Message assignment is a semantic trick to enable assertion</a>
|
|
<a name="1729"><span class="lineNum"> 1729 </span> : : // streaming; see the GTEST_MESSAGE_ macro below.</a>
|
|
<a name="1730"><span class="lineNum"> 1730 </span> : : void operator=(const Message& message) const;</a>
|
|
<a name="1731"><span class="lineNum"> 1731 </span> : : </a>
|
|
<a name="1732"><span class="lineNum"> 1732 </span> : : private:</a>
|
|
<a name="1733"><span class="lineNum"> 1733 </span> : : // We put our data in a struct so that the size of the AssertHelper class can</a>
|
|
<a name="1734"><span class="lineNum"> 1734 </span> : : // be as small as possible. This is important because gcc is incapable of</a>
|
|
<a name="1735"><span class="lineNum"> 1735 </span> : : // re-using stack space even for temporary variables, so every EXPECT_EQ</a>
|
|
<a name="1736"><span class="lineNum"> 1736 </span> : : // reserves stack space for another AssertHelper.</a>
|
|
<a name="1737"><span class="lineNum"> 1737 </span> : : struct AssertHelperData {</a>
|
|
<a name="1738"><span class="lineNum"> 1738 </span> : : AssertHelperData(TestPartResult::Type t,</a>
|
|
<a name="1739"><span class="lineNum"> 1739 </span> : : const char* srcfile,</a>
|
|
<a name="1740"><span class="lineNum"> 1740 </span> : : int line_num,</a>
|
|
<a name="1741"><span class="lineNum"> 1741 </span> : : const char* msg)</a>
|
|
<a name="1742"><span class="lineNum"> 1742 </span> : : : type(t), file(srcfile), line(line_num), message(msg) { }</a>
|
|
<a name="1743"><span class="lineNum"> 1743 </span> : : </a>
|
|
<a name="1744"><span class="lineNum"> 1744 </span> : : TestPartResult::Type const type;</a>
|
|
<a name="1745"><span class="lineNum"> 1745 </span> : : const char* const file;</a>
|
|
<a name="1746"><span class="lineNum"> 1746 </span> : : int const line;</a>
|
|
<a name="1747"><span class="lineNum"> 1747 </span> : : std::string const message;</a>
|
|
<a name="1748"><span class="lineNum"> 1748 </span> : : </a>
|
|
<a name="1749"><span class="lineNum"> 1749 </span> : : private:</a>
|
|
<a name="1750"><span class="lineNum"> 1750 </span> : : GTEST_DISALLOW_COPY_AND_ASSIGN_(AssertHelperData);</a>
|
|
<a name="1751"><span class="lineNum"> 1751 </span> : : };</a>
|
|
<a name="1752"><span class="lineNum"> 1752 </span> : : </a>
|
|
<a name="1753"><span class="lineNum"> 1753 </span> : : AssertHelperData* const data_;</a>
|
|
<a name="1754"><span class="lineNum"> 1754 </span> : : </a>
|
|
<a name="1755"><span class="lineNum"> 1755 </span> : : GTEST_DISALLOW_COPY_AND_ASSIGN_(AssertHelper);</a>
|
|
<a name="1756"><span class="lineNum"> 1756 </span> : : };</a>
|
|
<a name="1757"><span class="lineNum"> 1757 </span> : : </a>
|
|
<a name="1758"><span class="lineNum"> 1758 </span> : : } // namespace internal</a>
|
|
<a name="1759"><span class="lineNum"> 1759 </span> : : </a>
|
|
<a name="1760"><span class="lineNum"> 1760 </span> : : // The pure interface class that all value-parameterized tests inherit from.</a>
|
|
<a name="1761"><span class="lineNum"> 1761 </span> : : // A value-parameterized class must inherit from both ::testing::Test and</a>
|
|
<a name="1762"><span class="lineNum"> 1762 </span> : : // ::testing::WithParamInterface. In most cases that just means inheriting</a>
|
|
<a name="1763"><span class="lineNum"> 1763 </span> : : // from ::testing::TestWithParam, but more complicated test hierarchies</a>
|
|
<a name="1764"><span class="lineNum"> 1764 </span> : : // may need to inherit from Test and WithParamInterface at different levels.</a>
|
|
<a name="1765"><span class="lineNum"> 1765 </span> : : //</a>
|
|
<a name="1766"><span class="lineNum"> 1766 </span> : : // This interface has support for accessing the test parameter value via</a>
|
|
<a name="1767"><span class="lineNum"> 1767 </span> : : // the GetParam() method.</a>
|
|
<a name="1768"><span class="lineNum"> 1768 </span> : : //</a>
|
|
<a name="1769"><span class="lineNum"> 1769 </span> : : // Use it with one of the parameter generator defining functions, like Range(),</a>
|
|
<a name="1770"><span class="lineNum"> 1770 </span> : : // Values(), ValuesIn(), Bool(), and Combine().</a>
|
|
<a name="1771"><span class="lineNum"> 1771 </span> : : //</a>
|
|
<a name="1772"><span class="lineNum"> 1772 </span> : : // class FooTest : public ::testing::TestWithParam<int> {</a>
|
|
<a name="1773"><span class="lineNum"> 1773 </span> : : // protected:</a>
|
|
<a name="1774"><span class="lineNum"> 1774 </span> : : // FooTest() {</a>
|
|
<a name="1775"><span class="lineNum"> 1775 </span> : : // // Can use GetParam() here.</a>
|
|
<a name="1776"><span class="lineNum"> 1776 </span> : : // }</a>
|
|
<a name="1777"><span class="lineNum"> 1777 </span> : : // virtual ~FooTest() {</a>
|
|
<a name="1778"><span class="lineNum"> 1778 </span> : : // // Can use GetParam() here.</a>
|
|
<a name="1779"><span class="lineNum"> 1779 </span> : : // }</a>
|
|
<a name="1780"><span class="lineNum"> 1780 </span> : : // virtual void SetUp() {</a>
|
|
<a name="1781"><span class="lineNum"> 1781 </span> : : // // Can use GetParam() here.</a>
|
|
<a name="1782"><span class="lineNum"> 1782 </span> : : // }</a>
|
|
<a name="1783"><span class="lineNum"> 1783 </span> : : // virtual void TearDown {</a>
|
|
<a name="1784"><span class="lineNum"> 1784 </span> : : // // Can use GetParam() here.</a>
|
|
<a name="1785"><span class="lineNum"> 1785 </span> : : // }</a>
|
|
<a name="1786"><span class="lineNum"> 1786 </span> : : // };</a>
|
|
<a name="1787"><span class="lineNum"> 1787 </span> : : // TEST_P(FooTest, DoesBar) {</a>
|
|
<a name="1788"><span class="lineNum"> 1788 </span> : : // // Can use GetParam() method here.</a>
|
|
<a name="1789"><span class="lineNum"> 1789 </span> : : // Foo foo;</a>
|
|
<a name="1790"><span class="lineNum"> 1790 </span> : : // ASSERT_TRUE(foo.DoesBar(GetParam()));</a>
|
|
<a name="1791"><span class="lineNum"> 1791 </span> : : // }</a>
|
|
<a name="1792"><span class="lineNum"> 1792 </span> : : // INSTANTIATE_TEST_CASE_P(OneToTenRange, FooTest, ::testing::Range(1, 10));</a>
|
|
<a name="1793"><span class="lineNum"> 1793 </span> : : </a>
|
|
<a name="1794"><span class="lineNum"> 1794 </span> : : template <typename T></a>
|
|
<a name="1795"><span class="lineNum"> 1795 </span> : : class WithParamInterface {</a>
|
|
<a name="1796"><span class="lineNum"> 1796 </span> : : public:</a>
|
|
<a name="1797"><span class="lineNum"> 1797 </span> : : typedef T ParamType;</a>
|
|
<a name="1798"><span class="lineNum"> 1798 </span> : : virtual ~WithParamInterface() {}</a>
|
|
<a name="1799"><span class="lineNum"> 1799 </span> : : </a>
|
|
<a name="1800"><span class="lineNum"> 1800 </span> : : // The current parameter value. Is also available in the test fixture's</a>
|
|
<a name="1801"><span class="lineNum"> 1801 </span> : : // constructor. This member function is non-static, even though it only</a>
|
|
<a name="1802"><span class="lineNum"> 1802 </span> : : // references static data, to reduce the opportunity for incorrect uses</a>
|
|
<a name="1803"><span class="lineNum"> 1803 </span> : : // like writing 'WithParamInterface<bool>::GetParam()' for a test that</a>
|
|
<a name="1804"><span class="lineNum"> 1804 </span> : : // uses a fixture whose parameter type is int.</a>
|
|
<a name="1805"><span class="lineNum"> 1805 </span> : : const ParamType& GetParam() const {</a>
|
|
<a name="1806"><span class="lineNum"> 1806 </span> : : GTEST_CHECK_(parameter_ != NULL)</a>
|
|
<a name="1807"><span class="lineNum"> 1807 </span> : : << "GetParam() can only be called inside a value-parameterized test "</a>
|
|
<a name="1808"><span class="lineNum"> 1808 </span> : : << "-- did you intend to write TEST_P instead of TEST_F?";</a>
|
|
<a name="1809"><span class="lineNum"> 1809 </span> : : return *parameter_;</a>
|
|
<a name="1810"><span class="lineNum"> 1810 </span> : : }</a>
|
|
<a name="1811"><span class="lineNum"> 1811 </span> : : </a>
|
|
<a name="1812"><span class="lineNum"> 1812 </span> : : private:</a>
|
|
<a name="1813"><span class="lineNum"> 1813 </span> : : // Sets parameter value. The caller is responsible for making sure the value</a>
|
|
<a name="1814"><span class="lineNum"> 1814 </span> : : // remains alive and unchanged throughout the current test.</a>
|
|
<a name="1815"><span class="lineNum"> 1815 </span> : : static void SetParam(const ParamType* parameter) {</a>
|
|
<a name="1816"><span class="lineNum"> 1816 </span> : : parameter_ = parameter;</a>
|
|
<a name="1817"><span class="lineNum"> 1817 </span> : : }</a>
|
|
<a name="1818"><span class="lineNum"> 1818 </span> : : </a>
|
|
<a name="1819"><span class="lineNum"> 1819 </span> : : // Static value used for accessing parameter during a test lifetime.</a>
|
|
<a name="1820"><span class="lineNum"> 1820 </span> : : static const ParamType* parameter_;</a>
|
|
<a name="1821"><span class="lineNum"> 1821 </span> : : </a>
|
|
<a name="1822"><span class="lineNum"> 1822 </span> : : // TestClass must be a subclass of WithParamInterface<T> and Test.</a>
|
|
<a name="1823"><span class="lineNum"> 1823 </span> : : template <class TestClass> friend class internal::ParameterizedTestFactory;</a>
|
|
<a name="1824"><span class="lineNum"> 1824 </span> : : };</a>
|
|
<a name="1825"><span class="lineNum"> 1825 </span> : : </a>
|
|
<a name="1826"><span class="lineNum"> 1826 </span> : : template <typename T></a>
|
|
<a name="1827"><span class="lineNum"> 1827 </span> : : const T* WithParamInterface<T>::parameter_ = NULL;</a>
|
|
<a name="1828"><span class="lineNum"> 1828 </span> : : </a>
|
|
<a name="1829"><span class="lineNum"> 1829 </span> : : // Most value-parameterized classes can ignore the existence of</a>
|
|
<a name="1830"><span class="lineNum"> 1830 </span> : : // WithParamInterface, and can just inherit from ::testing::TestWithParam.</a>
|
|
<a name="1831"><span class="lineNum"> 1831 </span> : : </a>
|
|
<a name="1832"><span class="lineNum"> 1832 </span> : : template <typename T></a>
|
|
<a name="1833"><span class="lineNum"> 1833 </span> : : class TestWithParam : public Test, public WithParamInterface<T> {</a>
|
|
<a name="1834"><span class="lineNum"> 1834 </span> : : };</a>
|
|
<a name="1835"><span class="lineNum"> 1835 </span> : : </a>
|
|
<a name="1836"><span class="lineNum"> 1836 </span> : : // Macros for indicating success/failure in test code.</a>
|
|
<a name="1837"><span class="lineNum"> 1837 </span> : : </a>
|
|
<a name="1838"><span class="lineNum"> 1838 </span> : : // ADD_FAILURE unconditionally adds a failure to the current test.</a>
|
|
<a name="1839"><span class="lineNum"> 1839 </span> : : // SUCCEED generates a success - it doesn't automatically make the</a>
|
|
<a name="1840"><span class="lineNum"> 1840 </span> : : // current test successful, as a test is only successful when it has</a>
|
|
<a name="1841"><span class="lineNum"> 1841 </span> : : // no failure.</a>
|
|
<a name="1842"><span class="lineNum"> 1842 </span> : : //</a>
|
|
<a name="1843"><span class="lineNum"> 1843 </span> : : // EXPECT_* verifies that a certain condition is satisfied. If not,</a>
|
|
<a name="1844"><span class="lineNum"> 1844 </span> : : // it behaves like ADD_FAILURE. In particular:</a>
|
|
<a name="1845"><span class="lineNum"> 1845 </span> : : //</a>
|
|
<a name="1846"><span class="lineNum"> 1846 </span> : : // EXPECT_TRUE verifies that a Boolean condition is true.</a>
|
|
<a name="1847"><span class="lineNum"> 1847 </span> : : // EXPECT_FALSE verifies that a Boolean condition is false.</a>
|
|
<a name="1848"><span class="lineNum"> 1848 </span> : : //</a>
|
|
<a name="1849"><span class="lineNum"> 1849 </span> : : // FAIL and ASSERT_* are similar to ADD_FAILURE and EXPECT_*, except</a>
|
|
<a name="1850"><span class="lineNum"> 1850 </span> : : // that they will also abort the current function on failure. People</a>
|
|
<a name="1851"><span class="lineNum"> 1851 </span> : : // usually want the fail-fast behavior of FAIL and ASSERT_*, but those</a>
|
|
<a name="1852"><span class="lineNum"> 1852 </span> : : // writing data-driven tests often find themselves using ADD_FAILURE</a>
|
|
<a name="1853"><span class="lineNum"> 1853 </span> : : // and EXPECT_* more.</a>
|
|
<a name="1854"><span class="lineNum"> 1854 </span> : : </a>
|
|
<a name="1855"><span class="lineNum"> 1855 </span> : : // Generates a nonfatal failure with a generic message.</a>
|
|
<a name="1856"><span class="lineNum"> 1856 </span> : : #define ADD_FAILURE() GTEST_NONFATAL_FAILURE_("Failed")</a>
|
|
<a name="1857"><span class="lineNum"> 1857 </span> : : </a>
|
|
<a name="1858"><span class="lineNum"> 1858 </span> : : // Generates a nonfatal failure at the given source file location with</a>
|
|
<a name="1859"><span class="lineNum"> 1859 </span> : : // a generic message.</a>
|
|
<a name="1860"><span class="lineNum"> 1860 </span> : : #define ADD_FAILURE_AT(file, line) \</a>
|
|
<a name="1861"><span class="lineNum"> 1861 </span> : : GTEST_MESSAGE_AT_(file, line, "Failed", \</a>
|
|
<a name="1862"><span class="lineNum"> 1862 </span> : : ::testing::TestPartResult::kNonFatalFailure)</a>
|
|
<a name="1863"><span class="lineNum"> 1863 </span> : : </a>
|
|
<a name="1864"><span class="lineNum"> 1864 </span> : : // Generates a fatal failure with a generic message.</a>
|
|
<a name="1865"><span class="lineNum"> 1865 </span> : : #define GTEST_FAIL() GTEST_FATAL_FAILURE_("Failed")</a>
|
|
<a name="1866"><span class="lineNum"> 1866 </span> : : </a>
|
|
<a name="1867"><span class="lineNum"> 1867 </span> : : // Define this macro to 1 to omit the definition of FAIL(), which is a</a>
|
|
<a name="1868"><span class="lineNum"> 1868 </span> : : // generic name and clashes with some other libraries.</a>
|
|
<a name="1869"><span class="lineNum"> 1869 </span> : : #if !GTEST_DONT_DEFINE_FAIL</a>
|
|
<a name="1870"><span class="lineNum"> 1870 </span> : : # define FAIL() GTEST_FAIL()</a>
|
|
<a name="1871"><span class="lineNum"> 1871 </span> : : #endif</a>
|
|
<a name="1872"><span class="lineNum"> 1872 </span> : : </a>
|
|
<a name="1873"><span class="lineNum"> 1873 </span> : : // Generates a success with a generic message.</a>
|
|
<a name="1874"><span class="lineNum"> 1874 </span> : : #define GTEST_SUCCEED() GTEST_SUCCESS_("Succeeded")</a>
|
|
<a name="1875"><span class="lineNum"> 1875 </span> : : </a>
|
|
<a name="1876"><span class="lineNum"> 1876 </span> : : // Define this macro to 1 to omit the definition of SUCCEED(), which</a>
|
|
<a name="1877"><span class="lineNum"> 1877 </span> : : // is a generic name and clashes with some other libraries.</a>
|
|
<a name="1878"><span class="lineNum"> 1878 </span> : : #if !GTEST_DONT_DEFINE_SUCCEED</a>
|
|
<a name="1879"><span class="lineNum"> 1879 </span> : : # define SUCCEED() GTEST_SUCCEED()</a>
|
|
<a name="1880"><span class="lineNum"> 1880 </span> : : #endif</a>
|
|
<a name="1881"><span class="lineNum"> 1881 </span> : : </a>
|
|
<a name="1882"><span class="lineNum"> 1882 </span> : : // Macros for testing exceptions.</a>
|
|
<a name="1883"><span class="lineNum"> 1883 </span> : : //</a>
|
|
<a name="1884"><span class="lineNum"> 1884 </span> : : // * {ASSERT|EXPECT}_THROW(statement, expected_exception):</a>
|
|
<a name="1885"><span class="lineNum"> 1885 </span> : : // Tests that the statement throws the expected exception.</a>
|
|
<a name="1886"><span class="lineNum"> 1886 </span> : : // * {ASSERT|EXPECT}_NO_THROW(statement):</a>
|
|
<a name="1887"><span class="lineNum"> 1887 </span> : : // Tests that the statement doesn't throw any exception.</a>
|
|
<a name="1888"><span class="lineNum"> 1888 </span> : : // * {ASSERT|EXPECT}_ANY_THROW(statement):</a>
|
|
<a name="1889"><span class="lineNum"> 1889 </span> : : // Tests that the statement throws an exception.</a>
|
|
<a name="1890"><span class="lineNum"> 1890 </span> : : </a>
|
|
<a name="1891"><span class="lineNum"> 1891 </span> : : #define EXPECT_THROW(statement, expected_exception) \</a>
|
|
<a name="1892"><span class="lineNum"> 1892 </span> : : GTEST_TEST_THROW_(statement, expected_exception, GTEST_NONFATAL_FAILURE_)</a>
|
|
<a name="1893"><span class="lineNum"> 1893 </span> : : #define EXPECT_NO_THROW(statement) \</a>
|
|
<a name="1894"><span class="lineNum"> 1894 </span> : : GTEST_TEST_NO_THROW_(statement, GTEST_NONFATAL_FAILURE_)</a>
|
|
<a name="1895"><span class="lineNum"> 1895 </span> : : #define EXPECT_ANY_THROW(statement) \</a>
|
|
<a name="1896"><span class="lineNum"> 1896 </span> : : GTEST_TEST_ANY_THROW_(statement, GTEST_NONFATAL_FAILURE_)</a>
|
|
<a name="1897"><span class="lineNum"> 1897 </span> : : #define ASSERT_THROW(statement, expected_exception) \</a>
|
|
<a name="1898"><span class="lineNum"> 1898 </span> : : GTEST_TEST_THROW_(statement, expected_exception, GTEST_FATAL_FAILURE_)</a>
|
|
<a name="1899"><span class="lineNum"> 1899 </span> : : #define ASSERT_NO_THROW(statement) \</a>
|
|
<a name="1900"><span class="lineNum"> 1900 </span> : : GTEST_TEST_NO_THROW_(statement, GTEST_FATAL_FAILURE_)</a>
|
|
<a name="1901"><span class="lineNum"> 1901 </span> : : #define ASSERT_ANY_THROW(statement) \</a>
|
|
<a name="1902"><span class="lineNum"> 1902 </span> : : GTEST_TEST_ANY_THROW_(statement, GTEST_FATAL_FAILURE_)</a>
|
|
<a name="1903"><span class="lineNum"> 1903 </span> : : </a>
|
|
<a name="1904"><span class="lineNum"> 1904 </span> : : // Boolean assertions. Condition can be either a Boolean expression or an</a>
|
|
<a name="1905"><span class="lineNum"> 1905 </span> : : // AssertionResult. For more information on how to use AssertionResult with</a>
|
|
<a name="1906"><span class="lineNum"> 1906 </span> : : // these macros see comments on that class.</a>
|
|
<a name="1907"><span class="lineNum"> 1907 </span> : : #define EXPECT_TRUE(condition) \</a>
|
|
<a name="1908"><span class="lineNum"> 1908 </span> : : GTEST_TEST_BOOLEAN_(condition, #condition, false, true, \</a>
|
|
<a name="1909"><span class="lineNum"> 1909 </span> : : GTEST_NONFATAL_FAILURE_)</a>
|
|
<a name="1910"><span class="lineNum"> 1910 </span> : : #define EXPECT_FALSE(condition) \</a>
|
|
<a name="1911"><span class="lineNum"> 1911 </span> : : GTEST_TEST_BOOLEAN_(!(condition), #condition, true, false, \</a>
|
|
<a name="1912"><span class="lineNum"> 1912 </span> : : GTEST_NONFATAL_FAILURE_)</a>
|
|
<a name="1913"><span class="lineNum"> 1913 </span> : : #define ASSERT_TRUE(condition) \</a>
|
|
<a name="1914"><span class="lineNum"> 1914 </span> : : GTEST_TEST_BOOLEAN_(condition, #condition, false, true, \</a>
|
|
<a name="1915"><span class="lineNum"> 1915 </span> : : GTEST_FATAL_FAILURE_)</a>
|
|
<a name="1916"><span class="lineNum"> 1916 </span> : : #define ASSERT_FALSE(condition) \</a>
|
|
<a name="1917"><span class="lineNum"> 1917 </span> : : GTEST_TEST_BOOLEAN_(!(condition), #condition, true, false, \</a>
|
|
<a name="1918"><span class="lineNum"> 1918 </span> : : GTEST_FATAL_FAILURE_)</a>
|
|
<a name="1919"><span class="lineNum"> 1919 </span> : : </a>
|
|
<a name="1920"><span class="lineNum"> 1920 </span> : : // Macros for testing equalities and inequalities.</a>
|
|
<a name="1921"><span class="lineNum"> 1921 </span> : : //</a>
|
|
<a name="1922"><span class="lineNum"> 1922 </span> : : // * {ASSERT|EXPECT}_EQ(v1, v2): Tests that v1 == v2</a>
|
|
<a name="1923"><span class="lineNum"> 1923 </span> : : // * {ASSERT|EXPECT}_NE(v1, v2): Tests that v1 != v2</a>
|
|
<a name="1924"><span class="lineNum"> 1924 </span> : : // * {ASSERT|EXPECT}_LT(v1, v2): Tests that v1 < v2</a>
|
|
<a name="1925"><span class="lineNum"> 1925 </span> : : // * {ASSERT|EXPECT}_LE(v1, v2): Tests that v1 <= v2</a>
|
|
<a name="1926"><span class="lineNum"> 1926 </span> : : // * {ASSERT|EXPECT}_GT(v1, v2): Tests that v1 > v2</a>
|
|
<a name="1927"><span class="lineNum"> 1927 </span> : : // * {ASSERT|EXPECT}_GE(v1, v2): Tests that v1 >= v2</a>
|
|
<a name="1928"><span class="lineNum"> 1928 </span> : : //</a>
|
|
<a name="1929"><span class="lineNum"> 1929 </span> : : // When they are not, Google Test prints both the tested expressions and</a>
|
|
<a name="1930"><span class="lineNum"> 1930 </span> : : // their actual values. The values must be compatible built-in types,</a>
|
|
<a name="1931"><span class="lineNum"> 1931 </span> : : // or you will get a compiler error. By "compatible" we mean that the</a>
|
|
<a name="1932"><span class="lineNum"> 1932 </span> : : // values can be compared by the respective operator.</a>
|
|
<a name="1933"><span class="lineNum"> 1933 </span> : : //</a>
|
|
<a name="1934"><span class="lineNum"> 1934 </span> : : // Note:</a>
|
|
<a name="1935"><span class="lineNum"> 1935 </span> : : //</a>
|
|
<a name="1936"><span class="lineNum"> 1936 </span> : : // 1. It is possible to make a user-defined type work with</a>
|
|
<a name="1937"><span class="lineNum"> 1937 </span> : : // {ASSERT|EXPECT}_??(), but that requires overloading the</a>
|
|
<a name="1938"><span class="lineNum"> 1938 </span> : : // comparison operators and is thus discouraged by the Google C++</a>
|
|
<a name="1939"><span class="lineNum"> 1939 </span> : : // Usage Guide. Therefore, you are advised to use the</a>
|
|
<a name="1940"><span class="lineNum"> 1940 </span> : : // {ASSERT|EXPECT}_TRUE() macro to assert that two objects are</a>
|
|
<a name="1941"><span class="lineNum"> 1941 </span> : : // equal.</a>
|
|
<a name="1942"><span class="lineNum"> 1942 </span> : : //</a>
|
|
<a name="1943"><span class="lineNum"> 1943 </span> : : // 2. The {ASSERT|EXPECT}_??() macros do pointer comparisons on</a>
|
|
<a name="1944"><span class="lineNum"> 1944 </span> : : // pointers (in particular, C strings). Therefore, if you use it</a>
|
|
<a name="1945"><span class="lineNum"> 1945 </span> : : // with two C strings, you are testing how their locations in memory</a>
|
|
<a name="1946"><span class="lineNum"> 1946 </span> : : // are related, not how their content is related. To compare two C</a>
|
|
<a name="1947"><span class="lineNum"> 1947 </span> : : // strings by content, use {ASSERT|EXPECT}_STR*().</a>
|
|
<a name="1948"><span class="lineNum"> 1948 </span> : : //</a>
|
|
<a name="1949"><span class="lineNum"> 1949 </span> : : // 3. {ASSERT|EXPECT}_EQ(v1, v2) is preferred to</a>
|
|
<a name="1950"><span class="lineNum"> 1950 </span> : : // {ASSERT|EXPECT}_TRUE(v1 == v2), as the former tells you</a>
|
|
<a name="1951"><span class="lineNum"> 1951 </span> : : // what the actual value is when it fails, and similarly for the</a>
|
|
<a name="1952"><span class="lineNum"> 1952 </span> : : // other comparisons.</a>
|
|
<a name="1953"><span class="lineNum"> 1953 </span> : : //</a>
|
|
<a name="1954"><span class="lineNum"> 1954 </span> : : // 4. Do not depend on the order in which {ASSERT|EXPECT}_??()</a>
|
|
<a name="1955"><span class="lineNum"> 1955 </span> : : // evaluate their arguments, which is undefined.</a>
|
|
<a name="1956"><span class="lineNum"> 1956 </span> : : //</a>
|
|
<a name="1957"><span class="lineNum"> 1957 </span> : : // 5. These macros evaluate their arguments exactly once.</a>
|
|
<a name="1958"><span class="lineNum"> 1958 </span> : : //</a>
|
|
<a name="1959"><span class="lineNum"> 1959 </span> : : // Examples:</a>
|
|
<a name="1960"><span class="lineNum"> 1960 </span> : : //</a>
|
|
<a name="1961"><span class="lineNum"> 1961 </span> : : // EXPECT_NE(Foo(), 5);</a>
|
|
<a name="1962"><span class="lineNum"> 1962 </span> : : // EXPECT_EQ(a_pointer, NULL);</a>
|
|
<a name="1963"><span class="lineNum"> 1963 </span> : : // ASSERT_LT(i, array_size);</a>
|
|
<a name="1964"><span class="lineNum"> 1964 </span> : : // ASSERT_GT(records.size(), 0) << "There is no record left.";</a>
|
|
<a name="1965"><span class="lineNum"> 1965 </span> : : </a>
|
|
<a name="1966"><span class="lineNum"> 1966 </span> : : #define EXPECT_EQ(val1, val2) \</a>
|
|
<a name="1967"><span class="lineNum"> 1967 </span> : : EXPECT_PRED_FORMAT2(::testing::internal:: \</a>
|
|
<a name="1968"><span class="lineNum"> 1968 </span> : : EqHelper<GTEST_IS_NULL_LITERAL_(val1)>::Compare, \</a>
|
|
<a name="1969"><span class="lineNum"> 1969 </span> : : val1, val2)</a>
|
|
<a name="1970"><span class="lineNum"> 1970 </span> : : #define EXPECT_NE(val1, val2) \</a>
|
|
<a name="1971"><span class="lineNum"> 1971 </span> : : EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperNE, val1, val2)</a>
|
|
<a name="1972"><span class="lineNum"> 1972 </span> : : #define EXPECT_LE(val1, val2) \</a>
|
|
<a name="1973"><span class="lineNum"> 1973 </span> : : EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperLE, val1, val2)</a>
|
|
<a name="1974"><span class="lineNum"> 1974 </span> : : #define EXPECT_LT(val1, val2) \</a>
|
|
<a name="1975"><span class="lineNum"> 1975 </span> : : EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperLT, val1, val2)</a>
|
|
<a name="1976"><span class="lineNum"> 1976 </span> : : #define EXPECT_GE(val1, val2) \</a>
|
|
<a name="1977"><span class="lineNum"> 1977 </span> : : EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperGE, val1, val2)</a>
|
|
<a name="1978"><span class="lineNum"> 1978 </span> : : #define EXPECT_GT(val1, val2) \</a>
|
|
<a name="1979"><span class="lineNum"> 1979 </span> : : EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperGT, val1, val2)</a>
|
|
<a name="1980"><span class="lineNum"> 1980 </span> : : </a>
|
|
<a name="1981"><span class="lineNum"> 1981 </span> : : #define GTEST_ASSERT_EQ(val1, val2) \</a>
|
|
<a name="1982"><span class="lineNum"> 1982 </span> : : ASSERT_PRED_FORMAT2(::testing::internal:: \</a>
|
|
<a name="1983"><span class="lineNum"> 1983 </span> : : EqHelper<GTEST_IS_NULL_LITERAL_(val1)>::Compare, \</a>
|
|
<a name="1984"><span class="lineNum"> 1984 </span> : : val1, val2)</a>
|
|
<a name="1985"><span class="lineNum"> 1985 </span> : : #define GTEST_ASSERT_NE(val1, val2) \</a>
|
|
<a name="1986"><span class="lineNum"> 1986 </span> : : ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperNE, val1, val2)</a>
|
|
<a name="1987"><span class="lineNum"> 1987 </span> : : #define GTEST_ASSERT_LE(val1, val2) \</a>
|
|
<a name="1988"><span class="lineNum"> 1988 </span> : : ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperLE, val1, val2)</a>
|
|
<a name="1989"><span class="lineNum"> 1989 </span> : : #define GTEST_ASSERT_LT(val1, val2) \</a>
|
|
<a name="1990"><span class="lineNum"> 1990 </span> : : ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperLT, val1, val2)</a>
|
|
<a name="1991"><span class="lineNum"> 1991 </span> : : #define GTEST_ASSERT_GE(val1, val2) \</a>
|
|
<a name="1992"><span class="lineNum"> 1992 </span> : : ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperGE, val1, val2)</a>
|
|
<a name="1993"><span class="lineNum"> 1993 </span> : : #define GTEST_ASSERT_GT(val1, val2) \</a>
|
|
<a name="1994"><span class="lineNum"> 1994 </span> : : ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperGT, val1, val2)</a>
|
|
<a name="1995"><span class="lineNum"> 1995 </span> : : </a>
|
|
<a name="1996"><span class="lineNum"> 1996 </span> : : // Define macro GTEST_DONT_DEFINE_ASSERT_XY to 1 to omit the definition of</a>
|
|
<a name="1997"><span class="lineNum"> 1997 </span> : : // ASSERT_XY(), which clashes with some users' own code.</a>
|
|
<a name="1998"><span class="lineNum"> 1998 </span> : : </a>
|
|
<a name="1999"><span class="lineNum"> 1999 </span> : : #if !GTEST_DONT_DEFINE_ASSERT_EQ</a>
|
|
<a name="2000"><span class="lineNum"> 2000 </span> : : # define ASSERT_EQ(val1, val2) GTEST_ASSERT_EQ(val1, val2)</a>
|
|
<a name="2001"><span class="lineNum"> 2001 </span> : : #endif</a>
|
|
<a name="2002"><span class="lineNum"> 2002 </span> : : </a>
|
|
<a name="2003"><span class="lineNum"> 2003 </span> : : #if !GTEST_DONT_DEFINE_ASSERT_NE</a>
|
|
<a name="2004"><span class="lineNum"> 2004 </span> : : # define ASSERT_NE(val1, val2) GTEST_ASSERT_NE(val1, val2)</a>
|
|
<a name="2005"><span class="lineNum"> 2005 </span> : : #endif</a>
|
|
<a name="2006"><span class="lineNum"> 2006 </span> : : </a>
|
|
<a name="2007"><span class="lineNum"> 2007 </span> : : #if !GTEST_DONT_DEFINE_ASSERT_LE</a>
|
|
<a name="2008"><span class="lineNum"> 2008 </span> : : # define ASSERT_LE(val1, val2) GTEST_ASSERT_LE(val1, val2)</a>
|
|
<a name="2009"><span class="lineNum"> 2009 </span> : : #endif</a>
|
|
<a name="2010"><span class="lineNum"> 2010 </span> : : </a>
|
|
<a name="2011"><span class="lineNum"> 2011 </span> : : #if !GTEST_DONT_DEFINE_ASSERT_LT</a>
|
|
<a name="2012"><span class="lineNum"> 2012 </span> : : # define ASSERT_LT(val1, val2) GTEST_ASSERT_LT(val1, val2)</a>
|
|
<a name="2013"><span class="lineNum"> 2013 </span> : : #endif</a>
|
|
<a name="2014"><span class="lineNum"> 2014 </span> : : </a>
|
|
<a name="2015"><span class="lineNum"> 2015 </span> : : #if !GTEST_DONT_DEFINE_ASSERT_GE</a>
|
|
<a name="2016"><span class="lineNum"> 2016 </span> : : # define ASSERT_GE(val1, val2) GTEST_ASSERT_GE(val1, val2)</a>
|
|
<a name="2017"><span class="lineNum"> 2017 </span> : : #endif</a>
|
|
<a name="2018"><span class="lineNum"> 2018 </span> : : </a>
|
|
<a name="2019"><span class="lineNum"> 2019 </span> : : #if !GTEST_DONT_DEFINE_ASSERT_GT</a>
|
|
<a name="2020"><span class="lineNum"> 2020 </span> : : # define ASSERT_GT(val1, val2) GTEST_ASSERT_GT(val1, val2)</a>
|
|
<a name="2021"><span class="lineNum"> 2021 </span> : : #endif</a>
|
|
<a name="2022"><span class="lineNum"> 2022 </span> : : </a>
|
|
<a name="2023"><span class="lineNum"> 2023 </span> : : // C-string Comparisons. All tests treat NULL and any non-NULL string</a>
|
|
<a name="2024"><span class="lineNum"> 2024 </span> : : // as different. Two NULLs are equal.</a>
|
|
<a name="2025"><span class="lineNum"> 2025 </span> : : //</a>
|
|
<a name="2026"><span class="lineNum"> 2026 </span> : : // * {ASSERT|EXPECT}_STREQ(s1, s2): Tests that s1 == s2</a>
|
|
<a name="2027"><span class="lineNum"> 2027 </span> : : // * {ASSERT|EXPECT}_STRNE(s1, s2): Tests that s1 != s2</a>
|
|
<a name="2028"><span class="lineNum"> 2028 </span> : : // * {ASSERT|EXPECT}_STRCASEEQ(s1, s2): Tests that s1 == s2, ignoring case</a>
|
|
<a name="2029"><span class="lineNum"> 2029 </span> : : // * {ASSERT|EXPECT}_STRCASENE(s1, s2): Tests that s1 != s2, ignoring case</a>
|
|
<a name="2030"><span class="lineNum"> 2030 </span> : : //</a>
|
|
<a name="2031"><span class="lineNum"> 2031 </span> : : // For wide or narrow string objects, you can use the</a>
|
|
<a name="2032"><span class="lineNum"> 2032 </span> : : // {ASSERT|EXPECT}_??() macros.</a>
|
|
<a name="2033"><span class="lineNum"> 2033 </span> : : //</a>
|
|
<a name="2034"><span class="lineNum"> 2034 </span> : : // Don't depend on the order in which the arguments are evaluated,</a>
|
|
<a name="2035"><span class="lineNum"> 2035 </span> : : // which is undefined.</a>
|
|
<a name="2036"><span class="lineNum"> 2036 </span> : : //</a>
|
|
<a name="2037"><span class="lineNum"> 2037 </span> : : // These macros evaluate their arguments exactly once.</a>
|
|
<a name="2038"><span class="lineNum"> 2038 </span> : : </a>
|
|
<a name="2039"><span class="lineNum"> 2039 </span> : : #define EXPECT_STREQ(s1, s2) \</a>
|
|
<a name="2040"><span class="lineNum"> 2040 </span> : : EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, s1, s2)</a>
|
|
<a name="2041"><span class="lineNum"> 2041 </span> : : #define EXPECT_STRNE(s1, s2) \</a>
|
|
<a name="2042"><span class="lineNum"> 2042 </span> : : EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)</a>
|
|
<a name="2043"><span class="lineNum"> 2043 </span> : : #define EXPECT_STRCASEEQ(s1, s2) \</a>
|
|
<a name="2044"><span class="lineNum"> 2044 </span> : : EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, s1, s2)</a>
|
|
<a name="2045"><span class="lineNum"> 2045 </span> : : #define EXPECT_STRCASENE(s1, s2)\</a>
|
|
<a name="2046"><span class="lineNum"> 2046 </span> : : EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)</a>
|
|
<a name="2047"><span class="lineNum"> 2047 </span> : : </a>
|
|
<a name="2048"><span class="lineNum"> 2048 </span> : : #define ASSERT_STREQ(s1, s2) \</a>
|
|
<a name="2049"><span class="lineNum"> 2049 </span> : : ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, s1, s2)</a>
|
|
<a name="2050"><span class="lineNum"> 2050 </span> : : #define ASSERT_STRNE(s1, s2) \</a>
|
|
<a name="2051"><span class="lineNum"> 2051 </span> : : ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)</a>
|
|
<a name="2052"><span class="lineNum"> 2052 </span> : : #define ASSERT_STRCASEEQ(s1, s2) \</a>
|
|
<a name="2053"><span class="lineNum"> 2053 </span> : : ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, s1, s2)</a>
|
|
<a name="2054"><span class="lineNum"> 2054 </span> : : #define ASSERT_STRCASENE(s1, s2)\</a>
|
|
<a name="2055"><span class="lineNum"> 2055 </span> : : ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)</a>
|
|
<a name="2056"><span class="lineNum"> 2056 </span> : : </a>
|
|
<a name="2057"><span class="lineNum"> 2057 </span> : : // Macros for comparing floating-point numbers.</a>
|
|
<a name="2058"><span class="lineNum"> 2058 </span> : : //</a>
|
|
<a name="2059"><span class="lineNum"> 2059 </span> : : // * {ASSERT|EXPECT}_FLOAT_EQ(val1, val2):</a>
|
|
<a name="2060"><span class="lineNum"> 2060 </span> : : // Tests that two float values are almost equal.</a>
|
|
<a name="2061"><span class="lineNum"> 2061 </span> : : // * {ASSERT|EXPECT}_DOUBLE_EQ(val1, val2):</a>
|
|
<a name="2062"><span class="lineNum"> 2062 </span> : : // Tests that two double values are almost equal.</a>
|
|
<a name="2063"><span class="lineNum"> 2063 </span> : : // * {ASSERT|EXPECT}_NEAR(v1, v2, abs_error):</a>
|
|
<a name="2064"><span class="lineNum"> 2064 </span> : : // Tests that v1 and v2 are within the given distance to each other.</a>
|
|
<a name="2065"><span class="lineNum"> 2065 </span> : : //</a>
|
|
<a name="2066"><span class="lineNum"> 2066 </span> : : // Google Test uses ULP-based comparison to automatically pick a default</a>
|
|
<a name="2067"><span class="lineNum"> 2067 </span> : : // error bound that is appropriate for the operands. See the</a>
|
|
<a name="2068"><span class="lineNum"> 2068 </span> : : // FloatingPoint template class in gtest-internal.h if you are</a>
|
|
<a name="2069"><span class="lineNum"> 2069 </span> : : // interested in the implementation details.</a>
|
|
<a name="2070"><span class="lineNum"> 2070 </span> : : </a>
|
|
<a name="2071"><span class="lineNum"> 2071 </span> : : #define EXPECT_FLOAT_EQ(val1, val2)\</a>
|
|
<a name="2072"><span class="lineNum"> 2072 </span> : : EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<float>, \</a>
|
|
<a name="2073"><span class="lineNum"> 2073 </span> : : val1, val2)</a>
|
|
<a name="2074"><span class="lineNum"> 2074 </span> : : </a>
|
|
<a name="2075"><span class="lineNum"> 2075 </span> : : #define EXPECT_DOUBLE_EQ(val1, val2)\</a>
|
|
<a name="2076"><span class="lineNum"> 2076 </span> : : EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<double>, \</a>
|
|
<a name="2077"><span class="lineNum"> 2077 </span> : : val1, val2)</a>
|
|
<a name="2078"><span class="lineNum"> 2078 </span> : : </a>
|
|
<a name="2079"><span class="lineNum"> 2079 </span> : : #define ASSERT_FLOAT_EQ(val1, val2)\</a>
|
|
<a name="2080"><span class="lineNum"> 2080 </span> : : ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<float>, \</a>
|
|
<a name="2081"><span class="lineNum"> 2081 </span> : : val1, val2)</a>
|
|
<a name="2082"><span class="lineNum"> 2082 </span> : : </a>
|
|
<a name="2083"><span class="lineNum"> 2083 </span> : : #define ASSERT_DOUBLE_EQ(val1, val2)\</a>
|
|
<a name="2084"><span class="lineNum"> 2084 </span> : : ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<double>, \</a>
|
|
<a name="2085"><span class="lineNum"> 2085 </span> : : val1, val2)</a>
|
|
<a name="2086"><span class="lineNum"> 2086 </span> : : </a>
|
|
<a name="2087"><span class="lineNum"> 2087 </span> : : #define EXPECT_NEAR(val1, val2, abs_error)\</a>
|
|
<a name="2088"><span class="lineNum"> 2088 </span> : : EXPECT_PRED_FORMAT3(::testing::internal::DoubleNearPredFormat, \</a>
|
|
<a name="2089"><span class="lineNum"> 2089 </span> : : val1, val2, abs_error)</a>
|
|
<a name="2090"><span class="lineNum"> 2090 </span> : : </a>
|
|
<a name="2091"><span class="lineNum"> 2091 </span> : : #define ASSERT_NEAR(val1, val2, abs_error)\</a>
|
|
<a name="2092"><span class="lineNum"> 2092 </span> : : ASSERT_PRED_FORMAT3(::testing::internal::DoubleNearPredFormat, \</a>
|
|
<a name="2093"><span class="lineNum"> 2093 </span> : : val1, val2, abs_error)</a>
|
|
<a name="2094"><span class="lineNum"> 2094 </span> : : </a>
|
|
<a name="2095"><span class="lineNum"> 2095 </span> : : // These predicate format functions work on floating-point values, and</a>
|
|
<a name="2096"><span class="lineNum"> 2096 </span> : : // can be used in {ASSERT|EXPECT}_PRED_FORMAT2*(), e.g.</a>
|
|
<a name="2097"><span class="lineNum"> 2097 </span> : : //</a>
|
|
<a name="2098"><span class="lineNum"> 2098 </span> : : // EXPECT_PRED_FORMAT2(testing::DoubleLE, Foo(), 5.0);</a>
|
|
<a name="2099"><span class="lineNum"> 2099 </span> : : </a>
|
|
<a name="2100"><span class="lineNum"> 2100 </span> : : // Asserts that val1 is less than, or almost equal to, val2. Fails</a>
|
|
<a name="2101"><span class="lineNum"> 2101 </span> : : // otherwise. In particular, it fails if either val1 or val2 is NaN.</a>
|
|
<a name="2102"><span class="lineNum"> 2102 </span> : : GTEST_API_ AssertionResult FloatLE(const char* expr1, const char* expr2,</a>
|
|
<a name="2103"><span class="lineNum"> 2103 </span> : : float val1, float val2);</a>
|
|
<a name="2104"><span class="lineNum"> 2104 </span> : : GTEST_API_ AssertionResult DoubleLE(const char* expr1, const char* expr2,</a>
|
|
<a name="2105"><span class="lineNum"> 2105 </span> : : double val1, double val2);</a>
|
|
<a name="2106"><span class="lineNum"> 2106 </span> : : </a>
|
|
<a name="2107"><span class="lineNum"> 2107 </span> : : </a>
|
|
<a name="2108"><span class="lineNum"> 2108 </span> : : #if GTEST_OS_WINDOWS</a>
|
|
<a name="2109"><span class="lineNum"> 2109 </span> : : </a>
|
|
<a name="2110"><span class="lineNum"> 2110 </span> : : // Macros that test for HRESULT failure and success, these are only useful</a>
|
|
<a name="2111"><span class="lineNum"> 2111 </span> : : // on Windows, and rely on Windows SDK macros and APIs to compile.</a>
|
|
<a name="2112"><span class="lineNum"> 2112 </span> : : //</a>
|
|
<a name="2113"><span class="lineNum"> 2113 </span> : : // * {ASSERT|EXPECT}_HRESULT_{SUCCEEDED|FAILED}(expr)</a>
|
|
<a name="2114"><span class="lineNum"> 2114 </span> : : //</a>
|
|
<a name="2115"><span class="lineNum"> 2115 </span> : : // When expr unexpectedly fails or succeeds, Google Test prints the</a>
|
|
<a name="2116"><span class="lineNum"> 2116 </span> : : // expected result and the actual result with both a human-readable</a>
|
|
<a name="2117"><span class="lineNum"> 2117 </span> : : // string representation of the error, if available, as well as the</a>
|
|
<a name="2118"><span class="lineNum"> 2118 </span> : : // hex result code.</a>
|
|
<a name="2119"><span class="lineNum"> 2119 </span> : : # define EXPECT_HRESULT_SUCCEEDED(expr) \</a>
|
|
<a name="2120"><span class="lineNum"> 2120 </span> : : EXPECT_PRED_FORMAT1(::testing::internal::IsHRESULTSuccess, (expr))</a>
|
|
<a name="2121"><span class="lineNum"> 2121 </span> : : </a>
|
|
<a name="2122"><span class="lineNum"> 2122 </span> : : # define ASSERT_HRESULT_SUCCEEDED(expr) \</a>
|
|
<a name="2123"><span class="lineNum"> 2123 </span> : : ASSERT_PRED_FORMAT1(::testing::internal::IsHRESULTSuccess, (expr))</a>
|
|
<a name="2124"><span class="lineNum"> 2124 </span> : : </a>
|
|
<a name="2125"><span class="lineNum"> 2125 </span> : : # define EXPECT_HRESULT_FAILED(expr) \</a>
|
|
<a name="2126"><span class="lineNum"> 2126 </span> : : EXPECT_PRED_FORMAT1(::testing::internal::IsHRESULTFailure, (expr))</a>
|
|
<a name="2127"><span class="lineNum"> 2127 </span> : : </a>
|
|
<a name="2128"><span class="lineNum"> 2128 </span> : : # define ASSERT_HRESULT_FAILED(expr) \</a>
|
|
<a name="2129"><span class="lineNum"> 2129 </span> : : ASSERT_PRED_FORMAT1(::testing::internal::IsHRESULTFailure, (expr))</a>
|
|
<a name="2130"><span class="lineNum"> 2130 </span> : : </a>
|
|
<a name="2131"><span class="lineNum"> 2131 </span> : : #endif // GTEST_OS_WINDOWS</a>
|
|
<a name="2132"><span class="lineNum"> 2132 </span> : : </a>
|
|
<a name="2133"><span class="lineNum"> 2133 </span> : : // Macros that execute statement and check that it doesn't generate new fatal</a>
|
|
<a name="2134"><span class="lineNum"> 2134 </span> : : // failures in the current thread.</a>
|
|
<a name="2135"><span class="lineNum"> 2135 </span> : : //</a>
|
|
<a name="2136"><span class="lineNum"> 2136 </span> : : // * {ASSERT|EXPECT}_NO_FATAL_FAILURE(statement);</a>
|
|
<a name="2137"><span class="lineNum"> 2137 </span> : : //</a>
|
|
<a name="2138"><span class="lineNum"> 2138 </span> : : // Examples:</a>
|
|
<a name="2139"><span class="lineNum"> 2139 </span> : : //</a>
|
|
<a name="2140"><span class="lineNum"> 2140 </span> : : // EXPECT_NO_FATAL_FAILURE(Process());</a>
|
|
<a name="2141"><span class="lineNum"> 2141 </span> : : // ASSERT_NO_FATAL_FAILURE(Process()) << "Process() failed";</a>
|
|
<a name="2142"><span class="lineNum"> 2142 </span> : : //</a>
|
|
<a name="2143"><span class="lineNum"> 2143 </span> : : #define ASSERT_NO_FATAL_FAILURE(statement) \</a>
|
|
<a name="2144"><span class="lineNum"> 2144 </span> : : GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_FATAL_FAILURE_)</a>
|
|
<a name="2145"><span class="lineNum"> 2145 </span> : : #define EXPECT_NO_FATAL_FAILURE(statement) \</a>
|
|
<a name="2146"><span class="lineNum"> 2146 </span> : : GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_NONFATAL_FAILURE_)</a>
|
|
<a name="2147"><span class="lineNum"> 2147 </span> : : </a>
|
|
<a name="2148"><span class="lineNum"> 2148 </span> : : // Causes a trace (including the given source file path and line number,</a>
|
|
<a name="2149"><span class="lineNum"> 2149 </span> : : // and the given message) to be included in every test failure message generated</a>
|
|
<a name="2150"><span class="lineNum"> 2150 </span> : : // by code in the scope of the lifetime of an instance of this class. The effect</a>
|
|
<a name="2151"><span class="lineNum"> 2151 </span> : : // is undone with the destruction of the instance.</a>
|
|
<a name="2152"><span class="lineNum"> 2152 </span> : : //</a>
|
|
<a name="2153"><span class="lineNum"> 2153 </span> : : // The message argument can be anything streamable to std::ostream.</a>
|
|
<a name="2154"><span class="lineNum"> 2154 </span> : : //</a>
|
|
<a name="2155"><span class="lineNum"> 2155 </span> : : // Example:</a>
|
|
<a name="2156"><span class="lineNum"> 2156 </span> : : // testing::ScopedTrace trace("file.cc", 123, "message");</a>
|
|
<a name="2157"><span class="lineNum"> 2157 </span> : : //</a>
|
|
<a name="2158"><span class="lineNum"> 2158 </span> : : class GTEST_API_ ScopedTrace {</a>
|
|
<a name="2159"><span class="lineNum"> 2159 </span> : : public:</a>
|
|
<a name="2160"><span class="lineNum"> 2160 </span> : : // The c'tor pushes the given source file location and message onto</a>
|
|
<a name="2161"><span class="lineNum"> 2161 </span> : : // a trace stack maintained by Google Test.</a>
|
|
<a name="2162"><span class="lineNum"> 2162 </span> : : </a>
|
|
<a name="2163"><span class="lineNum"> 2163 </span> : : // Template version. Uses Message() to convert the values into strings.</a>
|
|
<a name="2164"><span class="lineNum"> 2164 </span> : : // Slow, but flexible.</a>
|
|
<a name="2165"><span class="lineNum"> 2165 </span> : : template <typename T></a>
|
|
<a name="2166"><span class="lineNum"> 2166 </span> : : ScopedTrace(const char* file, int line, const T& message) {</a>
|
|
<a name="2167"><span class="lineNum"> 2167 </span> : : PushTrace(file, line, (Message() << message).GetString());</a>
|
|
<a name="2168"><span class="lineNum"> 2168 </span> : : }</a>
|
|
<a name="2169"><span class="lineNum"> 2169 </span> : : </a>
|
|
<a name="2170"><span class="lineNum"> 2170 </span> : : // Optimize for some known types.</a>
|
|
<a name="2171"><span class="lineNum"> 2171 </span> : : ScopedTrace(const char* file, int line, const char* message) {</a>
|
|
<a name="2172"><span class="lineNum"> 2172 </span> : : PushTrace(file, line, message ? message : "(null)");</a>
|
|
<a name="2173"><span class="lineNum"> 2173 </span> : : }</a>
|
|
<a name="2174"><span class="lineNum"> 2174 </span> : : </a>
|
|
<a name="2175"><span class="lineNum"> 2175 </span> : : #if GTEST_HAS_GLOBAL_STRING</a>
|
|
<a name="2176"><span class="lineNum"> 2176 </span> : : ScopedTrace(const char* file, int line, const ::string& message) {</a>
|
|
<a name="2177"><span class="lineNum"> 2177 </span> : : PushTrace(file, line, message);</a>
|
|
<a name="2178"><span class="lineNum"> 2178 </span> : : }</a>
|
|
<a name="2179"><span class="lineNum"> 2179 </span> : : #endif</a>
|
|
<a name="2180"><span class="lineNum"> 2180 </span> : : </a>
|
|
<a name="2181"><span class="lineNum"> 2181 </span> : : ScopedTrace(const char* file, int line, const std::string& message) {</a>
|
|
<a name="2182"><span class="lineNum"> 2182 </span> : : PushTrace(file, line, message);</a>
|
|
<a name="2183"><span class="lineNum"> 2183 </span> : : }</a>
|
|
<a name="2184"><span class="lineNum"> 2184 </span> : : </a>
|
|
<a name="2185"><span class="lineNum"> 2185 </span> : : // The d'tor pops the info pushed by the c'tor.</a>
|
|
<a name="2186"><span class="lineNum"> 2186 </span> : : //</a>
|
|
<a name="2187"><span class="lineNum"> 2187 </span> : : // Note that the d'tor is not virtual in order to be efficient.</a>
|
|
<a name="2188"><span class="lineNum"> 2188 </span> : : // Don't inherit from ScopedTrace!</a>
|
|
<a name="2189"><span class="lineNum"> 2189 </span> : : ~ScopedTrace();</a>
|
|
<a name="2190"><span class="lineNum"> 2190 </span> : : </a>
|
|
<a name="2191"><span class="lineNum"> 2191 </span> : : private:</a>
|
|
<a name="2192"><span class="lineNum"> 2192 </span> : : void PushTrace(const char* file, int line, std::string message);</a>
|
|
<a name="2193"><span class="lineNum"> 2193 </span> : : </a>
|
|
<a name="2194"><span class="lineNum"> 2194 </span> : : GTEST_DISALLOW_COPY_AND_ASSIGN_(ScopedTrace);</a>
|
|
<a name="2195"><span class="lineNum"> 2195 </span> : : } GTEST_ATTRIBUTE_UNUSED_; // A ScopedTrace object does its job in its</a>
|
|
<a name="2196"><span class="lineNum"> 2196 </span> : : // c'tor and d'tor. Therefore it doesn't</a>
|
|
<a name="2197"><span class="lineNum"> 2197 </span> : : // need to be used otherwise.</a>
|
|
<a name="2198"><span class="lineNum"> 2198 </span> : : </a>
|
|
<a name="2199"><span class="lineNum"> 2199 </span> : : // Causes a trace (including the source file path, the current line</a>
|
|
<a name="2200"><span class="lineNum"> 2200 </span> : : // number, and the given message) to be included in every test failure</a>
|
|
<a name="2201"><span class="lineNum"> 2201 </span> : : // message generated by code in the current scope. The effect is</a>
|
|
<a name="2202"><span class="lineNum"> 2202 </span> : : // undone when the control leaves the current scope.</a>
|
|
<a name="2203"><span class="lineNum"> 2203 </span> : : //</a>
|
|
<a name="2204"><span class="lineNum"> 2204 </span> : : // The message argument can be anything streamable to std::ostream.</a>
|
|
<a name="2205"><span class="lineNum"> 2205 </span> : : //</a>
|
|
<a name="2206"><span class="lineNum"> 2206 </span> : : // In the implementation, we include the current line number as part</a>
|
|
<a name="2207"><span class="lineNum"> 2207 </span> : : // of the dummy variable name, thus allowing multiple SCOPED_TRACE()s</a>
|
|
<a name="2208"><span class="lineNum"> 2208 </span> : : // to appear in the same block - as long as they are on different</a>
|
|
<a name="2209"><span class="lineNum"> 2209 </span> : : // lines.</a>
|
|
<a name="2210"><span class="lineNum"> 2210 </span> : : //</a>
|
|
<a name="2211"><span class="lineNum"> 2211 </span> : : // Assuming that each thread maintains its own stack of traces.</a>
|
|
<a name="2212"><span class="lineNum"> 2212 </span> : : // Therefore, a SCOPED_TRACE() would (correctly) only affect the</a>
|
|
<a name="2213"><span class="lineNum"> 2213 </span> : : // assertions in its own thread.</a>
|
|
<a name="2214"><span class="lineNum"> 2214 </span> : : #define SCOPED_TRACE(message) \</a>
|
|
<a name="2215"><span class="lineNum"> 2215 </span> : : ::testing::ScopedTrace GTEST_CONCAT_TOKEN_(gtest_trace_, __LINE__)(\</a>
|
|
<a name="2216"><span class="lineNum"> 2216 </span> : : __FILE__, __LINE__, (message))</a>
|
|
<a name="2217"><span class="lineNum"> 2217 </span> : : </a>
|
|
<a name="2218"><span class="lineNum"> 2218 </span> : : </a>
|
|
<a name="2219"><span class="lineNum"> 2219 </span> : : // Compile-time assertion for type equality.</a>
|
|
<a name="2220"><span class="lineNum"> 2220 </span> : : // StaticAssertTypeEq<type1, type2>() compiles iff type1 and type2 are</a>
|
|
<a name="2221"><span class="lineNum"> 2221 </span> : : // the same type. The value it returns is not interesting.</a>
|
|
<a name="2222"><span class="lineNum"> 2222 </span> : : //</a>
|
|
<a name="2223"><span class="lineNum"> 2223 </span> : : // Instead of making StaticAssertTypeEq a class template, we make it a</a>
|
|
<a name="2224"><span class="lineNum"> 2224 </span> : : // function template that invokes a helper class template. This</a>
|
|
<a name="2225"><span class="lineNum"> 2225 </span> : : // prevents a user from misusing StaticAssertTypeEq<T1, T2> by</a>
|
|
<a name="2226"><span class="lineNum"> 2226 </span> : : // defining objects of that type.</a>
|
|
<a name="2227"><span class="lineNum"> 2227 </span> : : //</a>
|
|
<a name="2228"><span class="lineNum"> 2228 </span> : : // CAVEAT:</a>
|
|
<a name="2229"><span class="lineNum"> 2229 </span> : : //</a>
|
|
<a name="2230"><span class="lineNum"> 2230 </span> : : // When used inside a method of a class template,</a>
|
|
<a name="2231"><span class="lineNum"> 2231 </span> : : // StaticAssertTypeEq<T1, T2>() is effective ONLY IF the method is</a>
|
|
<a name="2232"><span class="lineNum"> 2232 </span> : : // instantiated. For example, given:</a>
|
|
<a name="2233"><span class="lineNum"> 2233 </span> : : //</a>
|
|
<a name="2234"><span class="lineNum"> 2234 </span> : : // template <typename T> class Foo {</a>
|
|
<a name="2235"><span class="lineNum"> 2235 </span> : : // public:</a>
|
|
<a name="2236"><span class="lineNum"> 2236 </span> : : // void Bar() { testing::StaticAssertTypeEq<int, T>(); }</a>
|
|
<a name="2237"><span class="lineNum"> 2237 </span> : : // };</a>
|
|
<a name="2238"><span class="lineNum"> 2238 </span> : : //</a>
|
|
<a name="2239"><span class="lineNum"> 2239 </span> : : // the code:</a>
|
|
<a name="2240"><span class="lineNum"> 2240 </span> : : //</a>
|
|
<a name="2241"><span class="lineNum"> 2241 </span> : : // void Test1() { Foo<bool> foo; }</a>
|
|
<a name="2242"><span class="lineNum"> 2242 </span> : : //</a>
|
|
<a name="2243"><span class="lineNum"> 2243 </span> : : // will NOT generate a compiler error, as Foo<bool>::Bar() is never</a>
|
|
<a name="2244"><span class="lineNum"> 2244 </span> : : // actually instantiated. Instead, you need:</a>
|
|
<a name="2245"><span class="lineNum"> 2245 </span> : : //</a>
|
|
<a name="2246"><span class="lineNum"> 2246 </span> : : // void Test2() { Foo<bool> foo; foo.Bar(); }</a>
|
|
<a name="2247"><span class="lineNum"> 2247 </span> : : //</a>
|
|
<a name="2248"><span class="lineNum"> 2248 </span> : : // to cause a compiler error.</a>
|
|
<a name="2249"><span class="lineNum"> 2249 </span> : : template <typename T1, typename T2></a>
|
|
<a name="2250"><span class="lineNum"> 2250 </span> : : bool StaticAssertTypeEq() {</a>
|
|
<a name="2251"><span class="lineNum"> 2251 </span> : : (void)internal::StaticAssertTypeEqHelper<T1, T2>();</a>
|
|
<a name="2252"><span class="lineNum"> 2252 </span> : : return true;</a>
|
|
<a name="2253"><span class="lineNum"> 2253 </span> : : }</a>
|
|
<a name="2254"><span class="lineNum"> 2254 </span> : : </a>
|
|
<a name="2255"><span class="lineNum"> 2255 </span> : : // Defines a test.</a>
|
|
<a name="2256"><span class="lineNum"> 2256 </span> : : //</a>
|
|
<a name="2257"><span class="lineNum"> 2257 </span> : : // The first parameter is the name of the test case, and the second</a>
|
|
<a name="2258"><span class="lineNum"> 2258 </span> : : // parameter is the name of the test within the test case.</a>
|
|
<a name="2259"><span class="lineNum"> 2259 </span> : : //</a>
|
|
<a name="2260"><span class="lineNum"> 2260 </span> : : // The convention is to end the test case name with "Test". For</a>
|
|
<a name="2261"><span class="lineNum"> 2261 </span> : : // example, a test case for the Foo class can be named FooTest.</a>
|
|
<a name="2262"><span class="lineNum"> 2262 </span> : : //</a>
|
|
<a name="2263"><span class="lineNum"> 2263 </span> : : // Test code should appear between braces after an invocation of</a>
|
|
<a name="2264"><span class="lineNum"> 2264 </span> : : // this macro. Example:</a>
|
|
<a name="2265"><span class="lineNum"> 2265 </span> : : //</a>
|
|
<a name="2266"><span class="lineNum"> 2266 </span> : : // TEST(FooTest, InitializesCorrectly) {</a>
|
|
<a name="2267"><span class="lineNum"> 2267 </span> : : // Foo foo;</a>
|
|
<a name="2268"><span class="lineNum"> 2268 </span> : : // EXPECT_TRUE(foo.StatusIsOK());</a>
|
|
<a name="2269"><span class="lineNum"> 2269 </span> : : // }</a>
|
|
<a name="2270"><span class="lineNum"> 2270 </span> : : </a>
|
|
<a name="2271"><span class="lineNum"> 2271 </span> : : // Note that we call GetTestTypeId() instead of GetTypeId<</a>
|
|
<a name="2272"><span class="lineNum"> 2272 </span> : : // ::testing::Test>() here to get the type ID of testing::Test. This</a>
|
|
<a name="2273"><span class="lineNum"> 2273 </span> : : // is to work around a suspected linker bug when using Google Test as</a>
|
|
<a name="2274"><span class="lineNum"> 2274 </span> : : // a framework on Mac OS X. The bug causes GetTypeId<</a>
|
|
<a name="2275"><span class="lineNum"> 2275 </span> : : // ::testing::Test>() to return different values depending on whether</a>
|
|
<a name="2276"><span class="lineNum"> 2276 </span> : : // the call is from the Google Test framework itself or from user test</a>
|
|
<a name="2277"><span class="lineNum"> 2277 </span> : : // code. GetTestTypeId() is guaranteed to always return the same</a>
|
|
<a name="2278"><span class="lineNum"> 2278 </span> : : // value, as it always calls GetTypeId<>() from the Google Test</a>
|
|
<a name="2279"><span class="lineNum"> 2279 </span> : : // framework.</a>
|
|
<a name="2280"><span class="lineNum"> 2280 </span> : : #define GTEST_TEST(test_case_name, test_name)\</a>
|
|
<a name="2281"><span class="lineNum"> 2281 </span> : : GTEST_TEST_(test_case_name, test_name, \</a>
|
|
<a name="2282"><span class="lineNum"> 2282 </span> : : ::testing::Test, ::testing::internal::GetTestTypeId())</a>
|
|
<a name="2283"><span class="lineNum"> 2283 </span> : : </a>
|
|
<a name="2284"><span class="lineNum"> 2284 </span> : : // Define this macro to 1 to omit the definition of TEST(), which</a>
|
|
<a name="2285"><span class="lineNum"> 2285 </span> : : // is a generic name and clashes with some other libraries.</a>
|
|
<a name="2286"><span class="lineNum"> 2286 </span> : : #if !GTEST_DONT_DEFINE_TEST</a>
|
|
<a name="2287"><span class="lineNum"> 2287 </span> : : # define TEST(test_case_name, test_name) GTEST_TEST(test_case_name, test_name)</a>
|
|
<a name="2288"><span class="lineNum"> 2288 </span> : : #endif</a>
|
|
<a name="2289"><span class="lineNum"> 2289 </span> : : </a>
|
|
<a name="2290"><span class="lineNum"> 2290 </span> : : // Defines a test that uses a test fixture.</a>
|
|
<a name="2291"><span class="lineNum"> 2291 </span> : : //</a>
|
|
<a name="2292"><span class="lineNum"> 2292 </span> : : // The first parameter is the name of the test fixture class, which</a>
|
|
<a name="2293"><span class="lineNum"> 2293 </span> : : // also doubles as the test case name. The second parameter is the</a>
|
|
<a name="2294"><span class="lineNum"> 2294 </span> : : // name of the test within the test case.</a>
|
|
<a name="2295"><span class="lineNum"> 2295 </span> : : //</a>
|
|
<a name="2296"><span class="lineNum"> 2296 </span> : : // A test fixture class must be declared earlier. The user should put</a>
|
|
<a name="2297"><span class="lineNum"> 2297 </span> : : // the test code between braces after using this macro. Example:</a>
|
|
<a name="2298"><span class="lineNum"> 2298 </span> : : //</a>
|
|
<a name="2299"><span class="lineNum"> 2299 </span> : : // class FooTest : public testing::Test {</a>
|
|
<a name="2300"><span class="lineNum"> 2300 </span> : : // protected:</a>
|
|
<a name="2301"><span class="lineNum"> 2301 </span> : : // virtual void SetUp() { b_.AddElement(3); }</a>
|
|
<a name="2302"><span class="lineNum"> 2302 </span> : : //</a>
|
|
<a name="2303"><span class="lineNum"> 2303 </span> : : // Foo a_;</a>
|
|
<a name="2304"><span class="lineNum"> 2304 </span> : : // Foo b_;</a>
|
|
<a name="2305"><span class="lineNum"> 2305 </span> : : // };</a>
|
|
<a name="2306"><span class="lineNum"> 2306 </span> : : //</a>
|
|
<a name="2307"><span class="lineNum"> 2307 </span> : : // TEST_F(FooTest, InitializesCorrectly) {</a>
|
|
<a name="2308"><span class="lineNum"> 2308 </span> : : // EXPECT_TRUE(a_.StatusIsOK());</a>
|
|
<a name="2309"><span class="lineNum"> 2309 </span> : : // }</a>
|
|
<a name="2310"><span class="lineNum"> 2310 </span> : : //</a>
|
|
<a name="2311"><span class="lineNum"> 2311 </span> : : // TEST_F(FooTest, ReturnsElementCountCorrectly) {</a>
|
|
<a name="2312"><span class="lineNum"> 2312 </span> : : // EXPECT_EQ(a_.size(), 0);</a>
|
|
<a name="2313"><span class="lineNum"> 2313 </span> : : // EXPECT_EQ(b_.size(), 1);</a>
|
|
<a name="2314"><span class="lineNum"> 2314 </span> : : // }</a>
|
|
<a name="2315"><span class="lineNum"> 2315 </span> : : </a>
|
|
<a name="2316"><span class="lineNum"> 2316 </span> : : #define TEST_F(test_fixture, test_name)\</a>
|
|
<a name="2317"><span class="lineNum"> 2317 </span> : : GTEST_TEST_(test_fixture, test_name, test_fixture, \</a>
|
|
<a name="2318"><span class="lineNum"> 2318 </span> : : ::testing::internal::GetTypeId<test_fixture>())</a>
|
|
<a name="2319"><span class="lineNum"> 2319 </span> : : </a>
|
|
<a name="2320"><span class="lineNum"> 2320 </span> : : // Returns a path to temporary directory.</a>
|
|
<a name="2321"><span class="lineNum"> 2321 </span> : : // Tries to determine an appropriate directory for the platform.</a>
|
|
<a name="2322"><span class="lineNum"> 2322 </span> : : GTEST_API_ std::string TempDir();</a>
|
|
<a name="2323"><span class="lineNum"> 2323 </span> : : </a>
|
|
<a name="2324"><span class="lineNum"> 2324 </span> : : #ifdef _MSC_VER</a>
|
|
<a name="2325"><span class="lineNum"> 2325 </span> : : # pragma warning(pop)</a>
|
|
<a name="2326"><span class="lineNum"> 2326 </span> : : #endif</a>
|
|
<a name="2327"><span class="lineNum"> 2327 </span> : : </a>
|
|
<a name="2328"><span class="lineNum"> 2328 </span> : : } // namespace testing</a>
|
|
<a name="2329"><span class="lineNum"> 2329 </span> : : </a>
|
|
<a name="2330"><span class="lineNum"> 2330 </span> : : // Use this function in main() to run all tests. It returns 0 if all</a>
|
|
<a name="2331"><span class="lineNum"> 2331 </span> : : // tests are successful, or 1 otherwise.</a>
|
|
<a name="2332"><span class="lineNum"> 2332 </span> : : //</a>
|
|
<a name="2333"><span class="lineNum"> 2333 </span> : : // RUN_ALL_TESTS() should be invoked after the command line has been</a>
|
|
<a name="2334"><span class="lineNum"> 2334 </span> : : // parsed by InitGoogleTest().</a>
|
|
<a name="2335"><span class="lineNum"> 2335 </span> : : //</a>
|
|
<a name="2336"><span class="lineNum"> 2336 </span> : : // This function was formerly a macro; thus, it is in the global</a>
|
|
<a name="2337"><span class="lineNum"> 2337 </span> : : // namespace and has an all-caps name.</a>
|
|
<a name="2338"><span class="lineNum"> 2338 </span> : : int RUN_ALL_TESTS() GTEST_MUST_USE_RESULT_;</a>
|
|
<a name="2339"><span class="lineNum"> 2339 </span> : : </a>
|
|
<a name="2340"><span class="lineNum"> 2340 </span> :<span class="lineCov"> 1 : inline int RUN_ALL_TESTS() {</span></a>
|
|
<a name="2341"><span class="lineNum"> 2341 </span> :<span class="lineCov"> 1 : return ::testing::UnitTest::GetInstance()->Run();</span></a>
|
|
<a name="2342"><span class="lineNum"> 2342 </span> : : }</a>
|
|
<a name="2343"><span class="lineNum"> 2343 </span> : : </a>
|
|
<a name="2344"><span class="lineNum"> 2344 </span> : : GTEST_DISABLE_MSC_WARNINGS_POP_() // 4251</a>
|
|
<a name="2345"><span class="lineNum"> 2345 </span> : : </a>
|
|
<a name="2346"><span class="lineNum"> 2346 </span> : : #endif // GTEST_INCLUDE_GTEST_GTEST_H_</a>
|
|
</pre>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
|
|
<table width="100%" border=0 cellspacing=0 cellpadding=0>
|
|
<tr><td class="ruler"><img src="../../../glass.png" width=3 height=3 alt=""></td></tr>
|
|
<tr><td class="versionInfo">Generated by: <a href="http://ltp.sourceforge.net/coverage/lcov.php" target="_parent">LCOV version 1.14</a></td></tr>
|
|
</table>
|
|
<br>
|
|
|
|
</body>
|
|
</html>
|