2363 lines
358 KiB
HTML
2363 lines
358 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
|
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
|
<meta name="generator" content="Doxygen 1.8.5"/>
|
|
<title>Faiss: /data/users/matthijs/github_faiss/faiss/tests/gtest/include/gtest/gtest.h Source File</title>
|
|
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="jquery.js"></script>
|
|
<script type="text/javascript" src="dynsections.js"></script>
|
|
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="search/search.js"></script>
|
|
<script type="text/javascript">
|
|
$(document).ready(function() { searchBox.OnSelectItem(0); });
|
|
</script>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
|
</head>
|
|
<body>
|
|
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
|
<div id="titlearea">
|
|
<table cellspacing="0" cellpadding="0">
|
|
<tbody>
|
|
<tr style="height: 56px;">
|
|
<td style="padding-left: 0.5em;">
|
|
<div id="projectname">Faiss
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<!-- end header part -->
|
|
<!-- Generated by Doxygen 1.8.5 -->
|
|
<script type="text/javascript">
|
|
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
|
</script>
|
|
<div id="navrow1" class="tabs">
|
|
<ul class="tablist">
|
|
<li><a href="index.html"><span>Main Page</span></a></li>
|
|
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
|
|
<li><a href="annotated.html"><span>Classes</span></a></li>
|
|
<li class="current"><a href="files.html"><span>Files</span></a></li>
|
|
<li>
|
|
<div id="MSearchBox" class="MSearchBoxInactive">
|
|
<span class="left">
|
|
<img id="MSearchSelect" src="search/mag_sel.png"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
alt=""/>
|
|
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
|
onfocus="searchBox.OnSearchFieldFocus(true)"
|
|
onblur="searchBox.OnSearchFieldFocus(false)"
|
|
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
|
</span><span class="right">
|
|
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
|
</span>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div id="navrow2" class="tabs2">
|
|
<ul class="tablist">
|
|
<li><a href="files.html"><span>File List</span></a></li>
|
|
</ul>
|
|
</div>
|
|
<!-- window showing the filter options -->
|
|
<div id="MSearchSelectWindow"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
|
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Friends</a></div>
|
|
|
|
<!-- iframe showing the search results (closed by default) -->
|
|
<div id="MSearchResultsWindow">
|
|
<iframe src="javascript:void(0)" frameborder="0"
|
|
name="MSearchResults" id="MSearchResults">
|
|
</iframe>
|
|
</div>
|
|
|
|
<div id="nav-path" class="navpath">
|
|
<ul>
|
|
<li class="navelem"><a class="el" href="dir_59425e443f801f1f2fd8bbe4959a3ccf.html">tests</a></li><li class="navelem"><a class="el" href="dir_3291c6cb888298ddcba2a410413770df.html">gtest</a></li><li class="navelem"><a class="el" href="dir_86c593ae31c77ba48c763c2f86ee625e.html">include</a></li><li class="navelem"><a class="el" href="dir_c1957a98abcd1de27355b577e8583658.html">gtest</a></li> </ul>
|
|
</div>
|
|
</div><!-- top -->
|
|
<div class="header">
|
|
<div class="headertitle">
|
|
<div class="title">gtest.h</div> </div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">// Copyright 2005, Google Inc.</span></div>
|
|
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment">// All rights reserved.</span></div>
|
|
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment">// Redistribution and use in source and binary forms, with or without</span></div>
|
|
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment">// modification, are permitted provided that the following conditions are</span></div>
|
|
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment">// met:</span></div>
|
|
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment">// * Redistributions of source code must retain the above copyright</span></div>
|
|
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment">// notice, this list of conditions and the following disclaimer.</span></div>
|
|
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment">// * Redistributions in binary form must reproduce the above</span></div>
|
|
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment">// copyright notice, this list of conditions and the following disclaimer</span></div>
|
|
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment">// in the documentation and/or other materials provided with the</span></div>
|
|
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment">// distribution.</span></div>
|
|
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment">// * Neither the name of Google Inc. nor the names of its</span></div>
|
|
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment">// contributors may be used to endorse or promote products derived from</span></div>
|
|
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment">// this software without specific prior written permission.</span></div>
|
|
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment">// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS</span></div>
|
|
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment">// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT</span></div>
|
|
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment">// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR</span></div>
|
|
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment">// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT</span></div>
|
|
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="comment">// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,</span></div>
|
|
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment">// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT</span></div>
|
|
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="comment">// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,</span></div>
|
|
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="comment">// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY</span></div>
|
|
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="comment">// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT</span></div>
|
|
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="comment">// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE</span></div>
|
|
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="comment">// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</span></div>
|
|
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="comment">// Author: wan@google.com (Zhanyong Wan)</span></div>
|
|
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="comment">// The Google C++ Testing Framework (Google Test)</span></div>
|
|
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="comment">// This header file defines the public API for Google Test. It should be</span></div>
|
|
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="comment">// included by any test program that uses Google Test.</span></div>
|
|
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="comment">// IMPORTANT NOTE: Due to limitation of the C++ language, we have to</span></div>
|
|
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="comment">// leave some internal implementation details in this header file.</span></div>
|
|
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="comment">// They are clearly marked by comments like this:</span></div>
|
|
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="comment">// // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment">// Such code is NOT meant to be used by a user directly, and is subject</span></div>
|
|
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment">// to CHANGE WITHOUT NOTICE. Therefore DO NOT DEPEND ON IT in a user</span></div>
|
|
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">// program!</span></div>
|
|
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// Acknowledgment: Google Test borrowed the idea of automatic test</span></div>
|
|
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// registration from Barthelemy Dagenais' (barthelemy@prologique.com)</span></div>
|
|
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">// easyUnit framework.</span></div>
|
|
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> </div>
|
|
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="preprocessor">#ifndef GTEST_INCLUDE_GTEST_GTEST_H_</span></div>
|
|
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="preprocessor"></span><span class="preprocessor">#define GTEST_INCLUDE_GTEST_GTEST_H_</span></div>
|
|
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="preprocessor">#include <limits></span></div>
|
|
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="preprocessor">#include <ostream></span></div>
|
|
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="preprocessor">#include <vector></span></div>
|
|
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span> </div>
|
|
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="preprocessor">#include "gtest/internal/gtest-internal.h"</span></div>
|
|
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="preprocessor">#include "gtest/internal/gtest-string.h"</span></div>
|
|
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="preprocessor">#include "gtest/gtest-death-test.h"</span></div>
|
|
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="preprocessor">#include "gtest/gtest-message.h"</span></div>
|
|
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="preprocessor">#include "gtest/gtest-param-test.h"</span></div>
|
|
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="preprocessor">#include "gtest/gtest-printers.h"</span></div>
|
|
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="preprocessor">#include "gtest/gtest_prod.h"</span></div>
|
|
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="preprocessor">#include "gtest/gtest-test-part.h"</span></div>
|
|
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="preprocessor">#include "gtest/gtest-typed-test.h"</span></div>
|
|
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span> </div>
|
|
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span> <span class="comment">// Depending on the platform, different string classes are available.</span></div>
|
|
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="comment">// On Linux, in addition to ::std::string, Google also makes use of</span></div>
|
|
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="comment">// class ::string, which has the same interface as ::std::string, but</span></div>
|
|
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="comment">// has a different implementation.</span></div>
|
|
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="comment">// You can define GTEST_HAS_GLOBAL_STRING to 1 to indicate that</span></div>
|
|
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="comment">// ::string is available AND is a distinct type to ::std::string, or</span></div>
|
|
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span> <span class="comment">// define it to 0 to indicate otherwise.</span></div>
|
|
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="comment">// If ::std::string and ::string are the same class on your platform</span></div>
|
|
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span> <span class="comment">// due to aliasing, you should define GTEST_HAS_GLOBAL_STRING to 0.</span></div>
|
|
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span> <span class="comment">// If you do not define GTEST_HAS_GLOBAL_STRING, it is defined</span></div>
|
|
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span> <span class="comment">// heuristically.</span></div>
|
|
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span> </div>
|
|
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="keyword">namespace </span>testing {</div>
|
|
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span> </div>
|
|
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span> <span class="comment">// Declares the flags.</span></div>
|
|
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span> </div>
|
|
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span> <span class="comment">// This flag temporary enables the disabled tests.</span></div>
|
|
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span> GTEST_DECLARE_bool_(also_run_disabled_tests);</div>
|
|
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span> </div>
|
|
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span> <span class="comment">// This flag brings the debugger on an assertion failure.</span></div>
|
|
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span> GTEST_DECLARE_bool_(break_on_failure);</div>
|
|
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span> </div>
|
|
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span> <span class="comment">// This flag controls whether Google Test catches all test-thrown exceptions</span></div>
|
|
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span> <span class="comment">// and logs them as failures.</span></div>
|
|
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span> GTEST_DECLARE_bool_(catch_exceptions);</div>
|
|
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span> </div>
|
|
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span> <span class="comment">// This flag enables using colors in terminal output. Available values are</span></div>
|
|
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span> <span class="comment">// "yes" to enable colors, "no" (disable colors), or "auto" (the default)</span></div>
|
|
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span> <span class="comment">// to let Google Test decide.</span></div>
|
|
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span> GTEST_DECLARE_string_(color);</div>
|
|
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span> </div>
|
|
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span> <span class="comment">// This flag sets up the filter to select by name using a glob pattern</span></div>
|
|
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span> <span class="comment">// the tests to run. If the filter is not given all tests are executed.</span></div>
|
|
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span> GTEST_DECLARE_string_(filter);</div>
|
|
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span> </div>
|
|
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span> <span class="comment">// This flag causes the Google Test to list tests. None of the tests listed</span></div>
|
|
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span> <span class="comment">// are actually run if the flag is provided.</span></div>
|
|
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span> GTEST_DECLARE_bool_(list_tests);</div>
|
|
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span> </div>
|
|
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span> <span class="comment">// This flag controls whether Google Test emits a detailed XML report to a file</span></div>
|
|
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span> <span class="comment">// in addition to its normal textual output.</span></div>
|
|
<div class="line"><a name="l00112"></a><span class="lineno"> 112</span> GTEST_DECLARE_string_(output);</div>
|
|
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span> </div>
|
|
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span> <span class="comment">// This flags control whether Google Test prints the elapsed time for each</span></div>
|
|
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span> <span class="comment">// test.</span></div>
|
|
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span> GTEST_DECLARE_bool_(print_time);</div>
|
|
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span> </div>
|
|
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span> <span class="comment">// This flag specifies the random number seed.</span></div>
|
|
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span> GTEST_DECLARE_int32_(random_seed);</div>
|
|
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span> </div>
|
|
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span> <span class="comment">// This flag sets how many times the tests are repeated. The default value</span></div>
|
|
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span> <span class="comment">// is 1. If the value is -1 the tests are repeating forever.</span></div>
|
|
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span> GTEST_DECLARE_int32_(repeat);</div>
|
|
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span> </div>
|
|
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <span class="comment">// This flag controls whether Google Test includes Google Test internal</span></div>
|
|
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="comment">// stack frames in failure stack traces.</span></div>
|
|
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span> GTEST_DECLARE_bool_(show_internal_stack_frames);</div>
|
|
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span> </div>
|
|
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span> <span class="comment">// When this flag is specified, tests' order is randomized on every iteration.</span></div>
|
|
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span> GTEST_DECLARE_bool_(shuffle);</div>
|
|
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span> </div>
|
|
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span> <span class="comment">// This flag specifies the maximum number of stack frames to be</span></div>
|
|
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span> <span class="comment">// printed in a failure message.</span></div>
|
|
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span> GTEST_DECLARE_int32_(stack_trace_depth);</div>
|
|
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span> </div>
|
|
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span> <span class="comment">// When this flag is specified, a failed assertion will throw an</span></div>
|
|
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span> <span class="comment">// exception if exceptions are enabled, or exit the program with a</span></div>
|
|
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span> <span class="comment">// non-zero code otherwise.</span></div>
|
|
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span> GTEST_DECLARE_bool_(throw_on_failure);</div>
|
|
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span> </div>
|
|
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span> <span class="comment">// When this flag is set with a "host:port" string, on supported</span></div>
|
|
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span> <span class="comment">// platforms test results are streamed to the specified port on</span></div>
|
|
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span> <span class="comment">// the specified host machine.</span></div>
|
|
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span> GTEST_DECLARE_string_(stream_result_to);</div>
|
|
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span> </div>
|
|
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span> <span class="comment">// The upper limit for valid stack trace depths.</span></div>
|
|
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span> <span class="keyword">const</span> <span class="keywordtype">int</span> kMaxStackTraceDepth = 100;</div>
|
|
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span> </div>
|
|
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span> <span class="keyword">namespace </span>internal {</div>
|
|
<div class="line"><a name="l00150"></a><span class="lineno"> 150</span> </div>
|
|
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span> <span class="keyword">class </span>AssertHelper;</div>
|
|
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span> <span class="keyword">class </span>DefaultGlobalTestPartResultReporter;</div>
|
|
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span> <span class="keyword">class </span>ExecDeathTest;</div>
|
|
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span> <span class="keyword">class </span>NoExecDeathTest;</div>
|
|
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span> <span class="keyword">class </span>FinalSuccessChecker;</div>
|
|
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span> <span class="keyword">class </span>GTestFlagSaver;</div>
|
|
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span> <span class="keyword">class </span>StreamingListenerTest;</div>
|
|
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span> <span class="keyword">class </span>TestResultAccessor;</div>
|
|
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span> <span class="keyword">class </span>TestEventListenersAccessor;</div>
|
|
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span> <span class="keyword">class </span>TestEventRepeater;</div>
|
|
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span> <span class="keyword">class </span>UnitTestRecordPropertyTestHelper;</div>
|
|
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span> <span class="keyword">class </span>WindowsDeathTest;</div>
|
|
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span> <span class="keyword">class </span>UnitTestImpl* GetUnitTestImpl();</div>
|
|
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span> <span class="keywordtype">void</span> ReportFailureInUnknownLocation(TestPartResult::Type result_type,</div>
|
|
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  <span class="keyword">const</span> std::string& message);</div>
|
|
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span> </div>
|
|
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span> } <span class="comment">// namespace internal</span></div>
|
|
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span> </div>
|
|
<div class="line"><a name="l00169"></a><span class="lineno"> 169</span> <span class="comment">// The friend relationship of some of these classes is cyclic.</span></div>
|
|
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span> <span class="comment">// If we don't forward declare them the compiler might confuse the classes</span></div>
|
|
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span> <span class="comment">// in friendship clauses with same named classes on the scope.</span></div>
|
|
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span> <span class="keyword">class </span>Test;</div>
|
|
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span> <span class="keyword">class </span>TestCase;</div>
|
|
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span> <span class="keyword">class </span>TestInfo;</div>
|
|
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span> <span class="keyword">class </span>UnitTest;</div>
|
|
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span> </div>
|
|
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span> <span class="comment">// A class for indicating whether an assertion was successful. When</span></div>
|
|
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span> <span class="comment">// the assertion wasn't successful, the AssertionResult object</span></div>
|
|
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span> <span class="comment">// remembers a non-empty message that describes how it failed.</span></div>
|
|
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span> <span class="comment">// To create an instance of this class, use one of the factory functions</span></div>
|
|
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span> <span class="comment">// (AssertionSuccess() and AssertionFailure()).</span></div>
|
|
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span> <span class="comment">// This class is useful for two purposes:</span></div>
|
|
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span> <span class="comment">// 1. Defining predicate functions to be used with Boolean test assertions</span></div>
|
|
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span> <span class="comment">// EXPECT_TRUE/EXPECT_FALSE and their ASSERT_ counterparts</span></div>
|
|
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span> <span class="comment">// 2. Defining predicate-format functions to be</span></div>
|
|
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span> <span class="comment">// used with predicate assertions (ASSERT_PRED_FORMAT*, etc).</span></div>
|
|
<div class="line"><a name="l00189"></a><span class="lineno"> 189</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00190"></a><span class="lineno"> 190</span> <span class="comment">// For example, if you define IsEven predicate:</span></div>
|
|
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span> <span class="comment">// testing::AssertionResult IsEven(int n) {</span></div>
|
|
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span> <span class="comment">// if ((n % 2) == 0)</span></div>
|
|
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span> <span class="comment">// return testing::AssertionSuccess();</span></div>
|
|
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span> <span class="comment">// else</span></div>
|
|
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span> <span class="comment">// return testing::AssertionFailure() << n << " is odd";</span></div>
|
|
<div class="line"><a name="l00197"></a><span class="lineno"> 197</span> <span class="comment">// }</span></div>
|
|
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span> <span class="comment">// Then the failed expectation EXPECT_TRUE(IsEven(Fib(5)))</span></div>
|
|
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span> <span class="comment">// will print the message</span></div>
|
|
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span> <span class="comment">// Value of: IsEven(Fib(5))</span></div>
|
|
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span> <span class="comment">// Actual: false (5 is odd)</span></div>
|
|
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span> <span class="comment">// Expected: true</span></div>
|
|
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span> <span class="comment">// instead of a more opaque</span></div>
|
|
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span> <span class="comment">// Value of: IsEven(Fib(5))</span></div>
|
|
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span> <span class="comment">// Actual: false</span></div>
|
|
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span> <span class="comment">// Expected: true</span></div>
|
|
<div class="line"><a name="l00211"></a><span class="lineno"> 211</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span> <span class="comment">// in case IsEven is a simple Boolean predicate.</span></div>
|
|
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00214"></a><span class="lineno"> 214</span> <span class="comment">// If you expect your predicate to be reused and want to support informative</span></div>
|
|
<div class="line"><a name="l00215"></a><span class="lineno"> 215</span> <span class="comment">// messages in EXPECT_FALSE and ASSERT_FALSE (negative assertions show up</span></div>
|
|
<div class="line"><a name="l00216"></a><span class="lineno"> 216</span> <span class="comment">// about half as often as positive ones in our tests), supply messages for</span></div>
|
|
<div class="line"><a name="l00217"></a><span class="lineno"> 217</span> <span class="comment">// both success and failure cases:</span></div>
|
|
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span> <span class="comment">// testing::AssertionResult IsEven(int n) {</span></div>
|
|
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span> <span class="comment">// if ((n % 2) == 0)</span></div>
|
|
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span> <span class="comment">// return testing::AssertionSuccess() << n << " is even";</span></div>
|
|
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span> <span class="comment">// else</span></div>
|
|
<div class="line"><a name="l00223"></a><span class="lineno"> 223</span> <span class="comment">// return testing::AssertionFailure() << n << " is odd";</span></div>
|
|
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span> <span class="comment">// }</span></div>
|
|
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span> <span class="comment">// Then a statement EXPECT_FALSE(IsEven(Fib(6))) will print</span></div>
|
|
<div class="line"><a name="l00227"></a><span class="lineno"> 227</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00228"></a><span class="lineno"> 228</span> <span class="comment">// Value of: IsEven(Fib(6))</span></div>
|
|
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span> <span class="comment">// Actual: true (8 is even)</span></div>
|
|
<div class="line"><a name="l00230"></a><span class="lineno"> 230</span> <span class="comment">// Expected: false</span></div>
|
|
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00232"></a><span class="lineno"> 232</span> <span class="comment">// NB: Predicates that support negative Boolean assertions have reduced</span></div>
|
|
<div class="line"><a name="l00233"></a><span class="lineno"> 233</span> <span class="comment">// performance in positive ones so be careful not to use them in tests</span></div>
|
|
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span> <span class="comment">// that have lots (tens of thousands) of positive Boolean assertions.</span></div>
|
|
<div class="line"><a name="l00235"></a><span class="lineno"> 235</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span> <span class="comment">// To use this class with EXPECT_PRED_FORMAT assertions such as:</span></div>
|
|
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span> <span class="comment">// // Verifies that Foo() returns an even number.</span></div>
|
|
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span> <span class="comment">// EXPECT_PRED_FORMAT1(IsEven, Foo());</span></div>
|
|
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span> <span class="comment">// you need to define:</span></div>
|
|
<div class="line"><a name="l00242"></a><span class="lineno"> 242</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00243"></a><span class="lineno"> 243</span> <span class="comment">// testing::AssertionResult IsEven(const char* expr, int n) {</span></div>
|
|
<div class="line"><a name="l00244"></a><span class="lineno"> 244</span> <span class="comment">// if ((n % 2) == 0)</span></div>
|
|
<div class="line"><a name="l00245"></a><span class="lineno"> 245</span> <span class="comment">// return testing::AssertionSuccess();</span></div>
|
|
<div class="line"><a name="l00246"></a><span class="lineno"> 246</span> <span class="comment">// else</span></div>
|
|
<div class="line"><a name="l00247"></a><span class="lineno"> 247</span> <span class="comment">// return testing::AssertionFailure()</span></div>
|
|
<div class="line"><a name="l00248"></a><span class="lineno"> 248</span> <span class="comment">// << "Expected: " << expr << " is even\n Actual: it's " << n;</span></div>
|
|
<div class="line"><a name="l00249"></a><span class="lineno"> 249</span> <span class="comment">// }</span></div>
|
|
<div class="line"><a name="l00250"></a><span class="lineno"> 250</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00251"></a><span class="lineno"> 251</span> <span class="comment">// If Foo() returns 5, you will see the following message:</span></div>
|
|
<div class="line"><a name="l00252"></a><span class="lineno"> 252</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00253"></a><span class="lineno"> 253</span> <span class="comment">// Expected: Foo() is even</span></div>
|
|
<div class="line"><a name="l00254"></a><span class="lineno"> 254</span> <span class="comment">// Actual: it's 5</span></div>
|
|
<div class="line"><a name="l00255"></a><span class="lineno"> 255</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00256"></a><span class="lineno"><a class="line" href="classtesting_1_1AssertionResult.html"> 256</a></span> <span class="keyword">class </span>GTEST_API_ <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> {</div>
|
|
<div class="line"><a name="l00257"></a><span class="lineno"> 257</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00258"></a><span class="lineno"> 258</span>  <span class="comment">// Copy constructor.</span></div>
|
|
<div class="line"><a name="l00259"></a><span class="lineno"> 259</span>  <span class="comment">// Used in EXPECT_TRUE/FALSE(assertion_result).</span></div>
|
|
<div class="line"><a name="l00260"></a><span class="lineno"> 260</span>  <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a>(<span class="keyword">const</span> <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a>& other);</div>
|
|
<div class="line"><a name="l00261"></a><span class="lineno"> 261</span> </div>
|
|
<div class="line"><a name="l00262"></a><span class="lineno"> 262</span>  GTEST_DISABLE_MSC_WARNINGS_PUSH_(4800 <span class="comment">/* forcing value to bool */</span>)</div>
|
|
<div class="line"><a name="l00263"></a><span class="lineno"> 263</span> </div>
|
|
<div class="line"><a name="l00264"></a><span class="lineno"> 264</span>  <span class="comment">// Used in the EXPECT_TRUE/FALSE(bool_expression).</span></div>
|
|
<div class="line"><a name="l00265"></a><span class="lineno"> 265</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00266"></a><span class="lineno"> 266</span>  <span class="comment">// T must be contextually convertible to bool.</span></div>
|
|
<div class="line"><a name="l00267"></a><span class="lineno"> 267</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00268"></a><span class="lineno"> 268</span>  <span class="comment">// The second parameter prevents this overload from being considered if</span></div>
|
|
<div class="line"><a name="l00269"></a><span class="lineno"> 269</span>  <span class="comment">// the argument is implicitly convertible to AssertionResult. In that case</span></div>
|
|
<div class="line"><a name="l00270"></a><span class="lineno"> 270</span>  <span class="comment">// we want AssertionResult's copy constructor to be used.</span></div>
|
|
<div class="line"><a name="l00271"></a><span class="lineno"> 271</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
|
|
<div class="line"><a name="l00272"></a><span class="lineno"> 272</span>  <span class="keyword">explicit</span> <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a>(</div>
|
|
<div class="line"><a name="l00273"></a><span class="lineno"> 273</span>  <span class="keyword">const</span> T& success,</div>
|
|
<div class="line"><a name="l00274"></a><span class="lineno"> 274</span>  <span class="keyword">typename</span> <a class="code" href="structtesting_1_1internal_1_1EnableIf.html">internal::EnableIf</a><</div>
|
|
<div class="line"><a name="l00275"></a><span class="lineno"> 275</span>  !<a class="code" href="classtesting_1_1internal_1_1ImplicitlyConvertible.html">internal::ImplicitlyConvertible<T, AssertionResult>::value</a>>::type*</div>
|
|
<div class="line"><a name="l00276"></a><span class="lineno"> 276</span>  <span class="comment">/*enabler*/</span> = NULL)</div>
|
|
<div class="line"><a name="l00277"></a><span class="lineno"> 277</span>  : success_(success) {}</div>
|
|
<div class="line"><a name="l00278"></a><span class="lineno"> 278</span> </div>
|
|
<div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  GTEST_DISABLE_MSC_WARNINGS_POP_()</div>
|
|
<div class="line"><a name="l00280"></a><span class="lineno"> 280</span> </div>
|
|
<div class="line"><a name="l00281"></a><span class="lineno"> 281</span>  <span class="comment">// Assignment operator.</span></div>
|
|
<div class="line"><a name="l00282"></a><span class="lineno"> 282</span>  <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a>& operator=(<a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> other) {</div>
|
|
<div class="line"><a name="l00283"></a><span class="lineno"> 283</span>  swap(other);</div>
|
|
<div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
|
|
<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  }</div>
|
|
<div class="line"><a name="l00286"></a><span class="lineno"> 286</span> </div>
|
|
<div class="line"><a name="l00287"></a><span class="lineno"> 287</span>  <span class="comment">// Returns true iff the assertion succeeded.</span></div>
|
|
<div class="line"><a name="l00288"></a><span class="lineno"> 288</span>  <span class="keyword">operator</span> bool()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> success_; } <span class="comment">// NOLINT</span></div>
|
|
<div class="line"><a name="l00289"></a><span class="lineno"> 289</span> </div>
|
|
<div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  <span class="comment">// Returns the assertion's negation. Used with EXPECT/ASSERT_FALSE.</span></div>
|
|
<div class="line"><a name="l00291"></a><span class="lineno"> 291</span>  <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> operator!() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00292"></a><span class="lineno"> 292</span> </div>
|
|
<div class="line"><a name="l00293"></a><span class="lineno"> 293</span>  <span class="comment">// Returns the text streamed into this AssertionResult. Test assertions</span></div>
|
|
<div class="line"><a name="l00294"></a><span class="lineno"> 294</span>  <span class="comment">// use it when they fail (i.e., the predicate's outcome doesn't match the</span></div>
|
|
<div class="line"><a name="l00295"></a><span class="lineno"> 295</span>  <span class="comment">// assertion's expectation). When nothing has been streamed into the</span></div>
|
|
<div class="line"><a name="l00296"></a><span class="lineno"> 296</span>  <span class="comment">// object, returns an empty string.</span></div>
|
|
<div class="line"><a name="l00297"></a><span class="lineno"> 297</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* message()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l00298"></a><span class="lineno"> 298</span>  <span class="keywordflow">return</span> message_.get() != NULL ? message_->c_str() : <span class="stringliteral">""</span>;</div>
|
|
<div class="line"><a name="l00299"></a><span class="lineno"> 299</span>  }</div>
|
|
<div class="line"><a name="l00300"></a><span class="lineno"> 300</span>  <span class="comment">// TODO(vladl@google.com): Remove this after making sure no clients use it.</span></div>
|
|
<div class="line"><a name="l00301"></a><span class="lineno"> 301</span>  <span class="comment">// Deprecated; please use message() instead.</span></div>
|
|
<div class="line"><a name="l00302"></a><span class="lineno"> 302</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* failure_message()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> message(); }</div>
|
|
<div class="line"><a name="l00303"></a><span class="lineno"> 303</span> </div>
|
|
<div class="line"><a name="l00304"></a><span class="lineno"> 304</span>  <span class="comment">// Streams a custom failure message into this object.</span></div>
|
|
<div class="line"><a name="l00305"></a><span class="lineno"> 305</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T> <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a>& operator<<(<span class="keyword">const</span> T& value) {</div>
|
|
<div class="line"><a name="l00306"></a><span class="lineno"> 306</span>  AppendMessage(<a class="code" href="classtesting_1_1Message.html">Message</a>() << value);</div>
|
|
<div class="line"><a name="l00307"></a><span class="lineno"> 307</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
|
|
<div class="line"><a name="l00308"></a><span class="lineno"> 308</span>  }</div>
|
|
<div class="line"><a name="l00309"></a><span class="lineno"> 309</span> </div>
|
|
<div class="line"><a name="l00310"></a><span class="lineno"> 310</span>  <span class="comment">// Allows streaming basic output manipulators such as endl or flush into</span></div>
|
|
<div class="line"><a name="l00311"></a><span class="lineno"> 311</span>  <span class="comment">// this object.</span></div>
|
|
<div class="line"><a name="l00312"></a><span class="lineno"> 312</span>  <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a>& operator<<(</div>
|
|
<div class="line"><a name="l00313"></a><span class="lineno"> 313</span>  ::std::ostream& (*basic_manipulator)(::std::ostream& stream)) {</div>
|
|
<div class="line"><a name="l00314"></a><span class="lineno"> 314</span>  AppendMessage(<a class="code" href="classtesting_1_1Message.html">Message</a>() << basic_manipulator);</div>
|
|
<div class="line"><a name="l00315"></a><span class="lineno"> 315</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
|
|
<div class="line"><a name="l00316"></a><span class="lineno"> 316</span>  }</div>
|
|
<div class="line"><a name="l00317"></a><span class="lineno"> 317</span> </div>
|
|
<div class="line"><a name="l00318"></a><span class="lineno"> 318</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l00319"></a><span class="lineno"> 319</span>  <span class="comment">// Appends the contents of message to message_.</span></div>
|
|
<div class="line"><a name="l00320"></a><span class="lineno"> 320</span>  <span class="keywordtype">void</span> AppendMessage(<span class="keyword">const</span> <a class="code" href="classtesting_1_1Message.html">Message</a>& a_message) {</div>
|
|
<div class="line"><a name="l00321"></a><span class="lineno"> 321</span>  <span class="keywordflow">if</span> (message_.get() == NULL)</div>
|
|
<div class="line"><a name="l00322"></a><span class="lineno"> 322</span>  message_.reset(new ::std::string);</div>
|
|
<div class="line"><a name="l00323"></a><span class="lineno"> 323</span>  message_->append(a_message.GetString().c_str());</div>
|
|
<div class="line"><a name="l00324"></a><span class="lineno"> 324</span>  }</div>
|
|
<div class="line"><a name="l00325"></a><span class="lineno"> 325</span> </div>
|
|
<div class="line"><a name="l00326"></a><span class="lineno"> 326</span>  <span class="comment">// Swap the contents of this AssertionResult with other.</span></div>
|
|
<div class="line"><a name="l00327"></a><span class="lineno"> 327</span>  <span class="keywordtype">void</span> swap(<a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a>& other);</div>
|
|
<div class="line"><a name="l00328"></a><span class="lineno"> 328</span> </div>
|
|
<div class="line"><a name="l00329"></a><span class="lineno"> 329</span>  <span class="comment">// Stores result of the assertion predicate.</span></div>
|
|
<div class="line"><a name="l00330"></a><span class="lineno"> 330</span>  <span class="keywordtype">bool</span> success_;</div>
|
|
<div class="line"><a name="l00331"></a><span class="lineno"> 331</span>  <span class="comment">// Stores the message describing the condition in case the expectation</span></div>
|
|
<div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  <span class="comment">// construct is not satisfied with the predicate's outcome.</span></div>
|
|
<div class="line"><a name="l00333"></a><span class="lineno"> 333</span>  <span class="comment">// Referenced via a pointer to avoid taking too much stack frame space</span></div>
|
|
<div class="line"><a name="l00334"></a><span class="lineno"> 334</span>  <span class="comment">// with test assertions.</span></div>
|
|
<div class="line"><a name="l00335"></a><span class="lineno"> 335</span>  <a class="code" href="classtesting_1_1internal_1_1scoped__ptr.html">internal::scoped_ptr< ::std::string></a> message_;</div>
|
|
<div class="line"><a name="l00336"></a><span class="lineno"> 336</span> };</div>
|
|
<div class="line"><a name="l00337"></a><span class="lineno"> 337</span> </div>
|
|
<div class="line"><a name="l00338"></a><span class="lineno"> 338</span> <span class="comment">// Makes a successful assertion result.</span></div>
|
|
<div class="line"><a name="l00339"></a><span class="lineno"> 339</span> GTEST_API_ <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> AssertionSuccess();</div>
|
|
<div class="line"><a name="l00340"></a><span class="lineno"> 340</span> </div>
|
|
<div class="line"><a name="l00341"></a><span class="lineno"> 341</span> <span class="comment">// Makes a failed assertion result.</span></div>
|
|
<div class="line"><a name="l00342"></a><span class="lineno"> 342</span> GTEST_API_ <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> AssertionFailure();</div>
|
|
<div class="line"><a name="l00343"></a><span class="lineno"> 343</span> </div>
|
|
<div class="line"><a name="l00344"></a><span class="lineno"> 344</span> <span class="comment">// Makes a failed assertion result with the given failure message.</span></div>
|
|
<div class="line"><a name="l00345"></a><span class="lineno"> 345</span> <span class="comment">// Deprecated; use AssertionFailure() << msg.</span></div>
|
|
<div class="line"><a name="l00346"></a><span class="lineno"> 346</span> GTEST_API_ <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> AssertionFailure(<span class="keyword">const</span> <a class="code" href="classtesting_1_1Message.html">Message</a>& msg);</div>
|
|
<div class="line"><a name="l00347"></a><span class="lineno"> 347</span> </div>
|
|
<div class="line"><a name="l00348"></a><span class="lineno"> 348</span> <span class="comment">// The abstract class that all tests inherit from.</span></div>
|
|
<div class="line"><a name="l00349"></a><span class="lineno"> 349</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00350"></a><span class="lineno"> 350</span> <span class="comment">// In Google Test, a unit test program contains one or many TestCases, and</span></div>
|
|
<div class="line"><a name="l00351"></a><span class="lineno"> 351</span> <span class="comment">// each TestCase contains one or many Tests.</span></div>
|
|
<div class="line"><a name="l00352"></a><span class="lineno"> 352</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00353"></a><span class="lineno"> 353</span> <span class="comment">// When you define a test using the TEST macro, you don't need to</span></div>
|
|
<div class="line"><a name="l00354"></a><span class="lineno"> 354</span> <span class="comment">// explicitly derive from Test - the TEST macro automatically does</span></div>
|
|
<div class="line"><a name="l00355"></a><span class="lineno"> 355</span> <span class="comment">// this for you.</span></div>
|
|
<div class="line"><a name="l00356"></a><span class="lineno"> 356</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00357"></a><span class="lineno"> 357</span> <span class="comment">// The only time you derive from Test is when defining a test fixture</span></div>
|
|
<div class="line"><a name="l00358"></a><span class="lineno"> 358</span> <span class="comment">// to be used a TEST_F. For example:</span></div>
|
|
<div class="line"><a name="l00359"></a><span class="lineno"> 359</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00360"></a><span class="lineno"> 360</span> <span class="comment">// class FooTest : public testing::Test {</span></div>
|
|
<div class="line"><a name="l00361"></a><span class="lineno"> 361</span> <span class="comment">// protected:</span></div>
|
|
<div class="line"><a name="l00362"></a><span class="lineno"> 362</span> <span class="comment">// void SetUp() override { ... }</span></div>
|
|
<div class="line"><a name="l00363"></a><span class="lineno"> 363</span> <span class="comment">// void TearDown() override { ... }</span></div>
|
|
<div class="line"><a name="l00364"></a><span class="lineno"> 364</span> <span class="comment">// ...</span></div>
|
|
<div class="line"><a name="l00365"></a><span class="lineno"> 365</span> <span class="comment">// };</span></div>
|
|
<div class="line"><a name="l00366"></a><span class="lineno"> 366</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00367"></a><span class="lineno"> 367</span> <span class="comment">// TEST_F(FooTest, Bar) { ... }</span></div>
|
|
<div class="line"><a name="l00368"></a><span class="lineno"> 368</span> <span class="comment">// TEST_F(FooTest, Baz) { ... }</span></div>
|
|
<div class="line"><a name="l00369"></a><span class="lineno"> 369</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00370"></a><span class="lineno"> 370</span> <span class="comment">// Test is not copyable.</span></div>
|
|
<div class="line"><a name="l00371"></a><span class="lineno"><a class="line" href="classtesting_1_1Test.html"> 371</a></span> <span class="keyword">class </span>GTEST_API_ <a class="code" href="classtesting_1_1Test.html">Test</a> {</div>
|
|
<div class="line"><a name="l00372"></a><span class="lineno"> 372</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00373"></a><span class="lineno"> 373</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>;</div>
|
|
<div class="line"><a name="l00374"></a><span class="lineno"> 374</span> </div>
|
|
<div class="line"><a name="l00375"></a><span class="lineno"> 375</span>  <span class="comment">// Defines types for pointers to functions that set up and tear down</span></div>
|
|
<div class="line"><a name="l00376"></a><span class="lineno"> 376</span>  <span class="comment">// a test case.</span></div>
|
|
<div class="line"><a name="l00377"></a><span class="lineno"> 377</span>  <span class="keyword">typedef</span> internal::SetUpTestCaseFunc SetUpTestCaseFunc;</div>
|
|
<div class="line"><a name="l00378"></a><span class="lineno"> 378</span>  <span class="keyword">typedef</span> internal::TearDownTestCaseFunc TearDownTestCaseFunc;</div>
|
|
<div class="line"><a name="l00379"></a><span class="lineno"> 379</span> </div>
|
|
<div class="line"><a name="l00380"></a><span class="lineno"> 380</span>  <span class="comment">// The d'tor is virtual as we intend to inherit from Test.</span></div>
|
|
<div class="line"><a name="l00381"></a><span class="lineno"> 381</span>  <span class="keyword">virtual</span> ~<a class="code" href="classtesting_1_1Test.html">Test</a>();</div>
|
|
<div class="line"><a name="l00382"></a><span class="lineno"> 382</span> </div>
|
|
<div class="line"><a name="l00383"></a><span class="lineno"> 383</span>  <span class="comment">// Sets up the stuff shared by all tests in this test case.</span></div>
|
|
<div class="line"><a name="l00384"></a><span class="lineno"> 384</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00385"></a><span class="lineno"> 385</span>  <span class="comment">// Google Test will call Foo::SetUpTestCase() before running the first</span></div>
|
|
<div class="line"><a name="l00386"></a><span class="lineno"> 386</span>  <span class="comment">// test in test case Foo. Hence a sub-class can define its own</span></div>
|
|
<div class="line"><a name="l00387"></a><span class="lineno"> 387</span>  <span class="comment">// SetUpTestCase() method to shadow the one defined in the super</span></div>
|
|
<div class="line"><a name="l00388"></a><span class="lineno"> 388</span>  <span class="comment">// class.</span></div>
|
|
<div class="line"><a name="l00389"></a><span class="lineno"> 389</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> SetUpTestCase() {}</div>
|
|
<div class="line"><a name="l00390"></a><span class="lineno"> 390</span> </div>
|
|
<div class="line"><a name="l00391"></a><span class="lineno"> 391</span>  <span class="comment">// Tears down the stuff shared by all tests in this test case.</span></div>
|
|
<div class="line"><a name="l00392"></a><span class="lineno"> 392</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00393"></a><span class="lineno"> 393</span>  <span class="comment">// Google Test will call Foo::TearDownTestCase() after running the last</span></div>
|
|
<div class="line"><a name="l00394"></a><span class="lineno"> 394</span>  <span class="comment">// test in test case Foo. Hence a sub-class can define its own</span></div>
|
|
<div class="line"><a name="l00395"></a><span class="lineno"> 395</span>  <span class="comment">// TearDownTestCase() method to shadow the one defined in the super</span></div>
|
|
<div class="line"><a name="l00396"></a><span class="lineno"> 396</span>  <span class="comment">// class.</span></div>
|
|
<div class="line"><a name="l00397"></a><span class="lineno"> 397</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> TearDownTestCase() {}</div>
|
|
<div class="line"><a name="l00398"></a><span class="lineno"> 398</span> </div>
|
|
<div class="line"><a name="l00399"></a><span class="lineno"> 399</span>  <span class="comment">// Returns true iff the current test has a fatal failure.</span></div>
|
|
<div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> HasFatalFailure();</div>
|
|
<div class="line"><a name="l00401"></a><span class="lineno"> 401</span> </div>
|
|
<div class="line"><a name="l00402"></a><span class="lineno"> 402</span>  <span class="comment">// Returns true iff the current test has a non-fatal failure.</span></div>
|
|
<div class="line"><a name="l00403"></a><span class="lineno"> 403</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> HasNonfatalFailure();</div>
|
|
<div class="line"><a name="l00404"></a><span class="lineno"> 404</span> </div>
|
|
<div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  <span class="comment">// Returns true iff the current test has a (either fatal or</span></div>
|
|
<div class="line"><a name="l00406"></a><span class="lineno"> 406</span>  <span class="comment">// non-fatal) failure.</span></div>
|
|
<div class="line"><a name="l00407"></a><span class="lineno"> 407</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> HasFailure() { <span class="keywordflow">return</span> HasFatalFailure() || HasNonfatalFailure(); }</div>
|
|
<div class="line"><a name="l00408"></a><span class="lineno"> 408</span> </div>
|
|
<div class="line"><a name="l00409"></a><span class="lineno"> 409</span>  <span class="comment">// Logs a property for the current test, test case, or for the entire</span></div>
|
|
<div class="line"><a name="l00410"></a><span class="lineno"> 410</span>  <span class="comment">// invocation of the test program when used outside of the context of a</span></div>
|
|
<div class="line"><a name="l00411"></a><span class="lineno"> 411</span>  <span class="comment">// test case. Only the last value for a given key is remembered. These</span></div>
|
|
<div class="line"><a name="l00412"></a><span class="lineno"> 412</span>  <span class="comment">// are public static so they can be called from utility functions that are</span></div>
|
|
<div class="line"><a name="l00413"></a><span class="lineno"> 413</span>  <span class="comment">// not members of the test fixture. Calls to RecordProperty made during</span></div>
|
|
<div class="line"><a name="l00414"></a><span class="lineno"> 414</span>  <span class="comment">// lifespan of the test (from the moment its constructor starts to the</span></div>
|
|
<div class="line"><a name="l00415"></a><span class="lineno"> 415</span>  <span class="comment">// moment its destructor finishes) will be output in XML as attributes of</span></div>
|
|
<div class="line"><a name="l00416"></a><span class="lineno"> 416</span>  <span class="comment">// the <testcase> element. Properties recorded from fixture's</span></div>
|
|
<div class="line"><a name="l00417"></a><span class="lineno"> 417</span>  <span class="comment">// SetUpTestCase or TearDownTestCase are logged as attributes of the</span></div>
|
|
<div class="line"><a name="l00418"></a><span class="lineno"> 418</span>  <span class="comment">// corresponding <testsuite> element. Calls to RecordProperty made in the</span></div>
|
|
<div class="line"><a name="l00419"></a><span class="lineno"> 419</span>  <span class="comment">// global context (before or after invocation of RUN_ALL_TESTS and from</span></div>
|
|
<div class="line"><a name="l00420"></a><span class="lineno"> 420</span>  <span class="comment">// SetUp/TearDown method of Environment objects registered with Google</span></div>
|
|
<div class="line"><a name="l00421"></a><span class="lineno"> 421</span>  <span class="comment">// Test) will be output as attributes of the <testsuites> element.</span></div>
|
|
<div class="line"><a name="l00422"></a><span class="lineno"> 422</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> RecordProperty(<span class="keyword">const</span> std::string& key, <span class="keyword">const</span> std::string& value);</div>
|
|
<div class="line"><a name="l00423"></a><span class="lineno"> 423</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> RecordProperty(<span class="keyword">const</span> std::string& key, <span class="keywordtype">int</span> value);</div>
|
|
<div class="line"><a name="l00424"></a><span class="lineno"> 424</span> </div>
|
|
<div class="line"><a name="l00425"></a><span class="lineno"> 425</span>  <span class="keyword">protected</span>:</div>
|
|
<div class="line"><a name="l00426"></a><span class="lineno"> 426</span>  <span class="comment">// Creates a Test object.</span></div>
|
|
<div class="line"><a name="l00427"></a><span class="lineno"> 427</span>  <a class="code" href="classtesting_1_1Test.html">Test</a>();</div>
|
|
<div class="line"><a name="l00428"></a><span class="lineno"> 428</span> </div>
|
|
<div class="line"><a name="l00429"></a><span class="lineno"> 429</span>  <span class="comment">// Sets up the test fixture.</span></div>
|
|
<div class="line"><a name="l00430"></a><span class="lineno"> 430</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> SetUp();</div>
|
|
<div class="line"><a name="l00431"></a><span class="lineno"> 431</span> </div>
|
|
<div class="line"><a name="l00432"></a><span class="lineno"> 432</span>  <span class="comment">// Tears down the test fixture.</span></div>
|
|
<div class="line"><a name="l00433"></a><span class="lineno"> 433</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> TearDown();</div>
|
|
<div class="line"><a name="l00434"></a><span class="lineno"> 434</span> </div>
|
|
<div class="line"><a name="l00435"></a><span class="lineno"> 435</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l00436"></a><span class="lineno"> 436</span>  <span class="comment">// Returns true iff the current test has the same fixture class as</span></div>
|
|
<div class="line"><a name="l00437"></a><span class="lineno"> 437</span>  <span class="comment">// the first test in the current test case.</span></div>
|
|
<div class="line"><a name="l00438"></a><span class="lineno"> 438</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> HasSameFixtureClass();</div>
|
|
<div class="line"><a name="l00439"></a><span class="lineno"> 439</span> </div>
|
|
<div class="line"><a name="l00440"></a><span class="lineno"> 440</span>  <span class="comment">// Runs the test after the test fixture has been set up.</span></div>
|
|
<div class="line"><a name="l00441"></a><span class="lineno"> 441</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00442"></a><span class="lineno"> 442</span>  <span class="comment">// A sub-class must implement this to define the test logic.</span></div>
|
|
<div class="line"><a name="l00443"></a><span class="lineno"> 443</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00444"></a><span class="lineno"> 444</span>  <span class="comment">// DO NOT OVERRIDE THIS FUNCTION DIRECTLY IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l00445"></a><span class="lineno"> 445</span>  <span class="comment">// Instead, use the TEST or TEST_F macro.</span></div>
|
|
<div class="line"><a name="l00446"></a><span class="lineno"> 446</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> TestBody() = 0;</div>
|
|
<div class="line"><a name="l00447"></a><span class="lineno"> 447</span> </div>
|
|
<div class="line"><a name="l00448"></a><span class="lineno"> 448</span>  <span class="comment">// Sets up, executes, and tears down the test.</span></div>
|
|
<div class="line"><a name="l00449"></a><span class="lineno"> 449</span>  <span class="keywordtype">void</span> Run();</div>
|
|
<div class="line"><a name="l00450"></a><span class="lineno"> 450</span> </div>
|
|
<div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  <span class="comment">// Deletes self. We deliberately pick an unusual name for this</span></div>
|
|
<div class="line"><a name="l00452"></a><span class="lineno"> 452</span>  <span class="comment">// internal method to avoid clashing with names used in user TESTs.</span></div>
|
|
<div class="line"><a name="l00453"></a><span class="lineno"> 453</span>  <span class="keywordtype">void</span> DeleteSelf_() { <span class="keyword">delete</span> <span class="keyword">this</span>; }</div>
|
|
<div class="line"><a name="l00454"></a><span class="lineno"> 454</span> </div>
|
|
<div class="line"><a name="l00455"></a><span class="lineno"> 455</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1internal_1_1scoped__ptr.html">internal::scoped_ptr< GTEST_FLAG_SAVER_ ></a> gtest_flag_saver_;</div>
|
|
<div class="line"><a name="l00456"></a><span class="lineno"> 456</span> </div>
|
|
<div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  <span class="comment">// Often a user misspells SetUp() as Setup() and spends a long time</span></div>
|
|
<div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  <span class="comment">// wondering why it is never called by Google Test. The declaration of</span></div>
|
|
<div class="line"><a name="l00459"></a><span class="lineno"> 459</span>  <span class="comment">// the following method is solely for catching such an error at</span></div>
|
|
<div class="line"><a name="l00460"></a><span class="lineno"> 460</span>  <span class="comment">// compile time:</span></div>
|
|
<div class="line"><a name="l00461"></a><span class="lineno"> 461</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00462"></a><span class="lineno"> 462</span>  <span class="comment">// - The return type is deliberately chosen to be not void, so it</span></div>
|
|
<div class="line"><a name="l00463"></a><span class="lineno"> 463</span>  <span class="comment">// will be a conflict if void Setup() is declared in the user's</span></div>
|
|
<div class="line"><a name="l00464"></a><span class="lineno"> 464</span>  <span class="comment">// test fixture.</span></div>
|
|
<div class="line"><a name="l00465"></a><span class="lineno"> 465</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00466"></a><span class="lineno"> 466</span>  <span class="comment">// - This method is private, so it will be another compiler error</span></div>
|
|
<div class="line"><a name="l00467"></a><span class="lineno"> 467</span>  <span class="comment">// if the method is called from the user's test fixture.</span></div>
|
|
<div class="line"><a name="l00468"></a><span class="lineno"> 468</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  <span class="comment">// DO NOT OVERRIDE THIS FUNCTION.</span></div>
|
|
<div class="line"><a name="l00470"></a><span class="lineno"> 470</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00471"></a><span class="lineno"> 471</span>  <span class="comment">// If you see an error about overriding the following function or</span></div>
|
|
<div class="line"><a name="l00472"></a><span class="lineno"> 472</span>  <span class="comment">// about it being private, you have mis-spelled SetUp() as Setup().</span></div>
|
|
<div class="line"><a name="l00473"></a><span class="lineno"> 473</span>  <span class="keyword">struct </span>Setup_should_be_spelled_SetUp {};</div>
|
|
<div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  <span class="keyword">virtual</span> Setup_should_be_spelled_SetUp* Setup() { <span class="keywordflow">return</span> NULL; }</div>
|
|
<div class="line"><a name="l00475"></a><span class="lineno"> 475</span> </div>
|
|
<div class="line"><a name="l00476"></a><span class="lineno"> 476</span>  <span class="comment">// We disallow copying Tests.</span></div>
|
|
<div class="line"><a name="l00477"></a><span class="lineno"> 477</span>  GTEST_DISALLOW_COPY_AND_ASSIGN_(<a class="code" href="classtesting_1_1Test.html">Test</a>);</div>
|
|
<div class="line"><a name="l00478"></a><span class="lineno"> 478</span> };</div>
|
|
<div class="line"><a name="l00479"></a><span class="lineno"> 479</span> </div>
|
|
<div class="line"><a name="l00480"></a><span class="lineno"> 480</span> <span class="keyword">typedef</span> internal::TimeInMillis TimeInMillis;</div>
|
|
<div class="line"><a name="l00481"></a><span class="lineno"> 481</span> </div>
|
|
<div class="line"><a name="l00482"></a><span class="lineno"> 482</span> <span class="comment">// A copyable object representing a user specified test property which can be</span></div>
|
|
<div class="line"><a name="l00483"></a><span class="lineno"> 483</span> <span class="comment">// output as a key/value string pair.</span></div>
|
|
<div class="line"><a name="l00484"></a><span class="lineno"> 484</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00485"></a><span class="lineno"> 485</span> <span class="comment">// Don't inherit from TestProperty as its destructor is not virtual.</span></div>
|
|
<div class="line"><a name="l00486"></a><span class="lineno"><a class="line" href="classtesting_1_1TestProperty.html"> 486</a></span> <span class="keyword">class </span><a class="code" href="classtesting_1_1TestProperty.html">TestProperty</a> {</div>
|
|
<div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  <span class="comment">// C'tor. TestProperty does NOT have a default constructor.</span></div>
|
|
<div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  <span class="comment">// Always use this constructor (with parameters) to create a</span></div>
|
|
<div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  <span class="comment">// TestProperty object.</span></div>
|
|
<div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  <a class="code" href="classtesting_1_1TestProperty.html">TestProperty</a>(<span class="keyword">const</span> std::string& a_key, <span class="keyword">const</span> std::string& a_value) :</div>
|
|
<div class="line"><a name="l00492"></a><span class="lineno"> 492</span>  key_(a_key), value_(a_value) {</div>
|
|
<div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  }</div>
|
|
<div class="line"><a name="l00494"></a><span class="lineno"> 494</span> </div>
|
|
<div class="line"><a name="l00495"></a><span class="lineno"> 495</span>  <span class="comment">// Gets the user supplied key.</span></div>
|
|
<div class="line"><a name="l00496"></a><span class="lineno"> 496</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* key()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l00497"></a><span class="lineno"> 497</span>  <span class="keywordflow">return</span> key_.c_str();</div>
|
|
<div class="line"><a name="l00498"></a><span class="lineno"> 498</span>  }</div>
|
|
<div class="line"><a name="l00499"></a><span class="lineno"> 499</span> </div>
|
|
<div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  <span class="comment">// Gets the user supplied value.</span></div>
|
|
<div class="line"><a name="l00501"></a><span class="lineno"> 501</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* value()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l00502"></a><span class="lineno"> 502</span>  <span class="keywordflow">return</span> value_.c_str();</div>
|
|
<div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  }</div>
|
|
<div class="line"><a name="l00504"></a><span class="lineno"> 504</span> </div>
|
|
<div class="line"><a name="l00505"></a><span class="lineno"> 505</span>  <span class="comment">// Sets a new value, overriding the one supplied in the constructor.</span></div>
|
|
<div class="line"><a name="l00506"></a><span class="lineno"> 506</span>  <span class="keywordtype">void</span> SetValue(<span class="keyword">const</span> std::string& new_value) {</div>
|
|
<div class="line"><a name="l00507"></a><span class="lineno"> 507</span>  value_ = new_value;</div>
|
|
<div class="line"><a name="l00508"></a><span class="lineno"> 508</span>  }</div>
|
|
<div class="line"><a name="l00509"></a><span class="lineno"> 509</span> </div>
|
|
<div class="line"><a name="l00510"></a><span class="lineno"> 510</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l00511"></a><span class="lineno"> 511</span>  <span class="comment">// The key supplied by the user.</span></div>
|
|
<div class="line"><a name="l00512"></a><span class="lineno"> 512</span>  std::string key_;</div>
|
|
<div class="line"><a name="l00513"></a><span class="lineno"> 513</span>  <span class="comment">// The value supplied by the user.</span></div>
|
|
<div class="line"><a name="l00514"></a><span class="lineno"> 514</span>  std::string value_;</div>
|
|
<div class="line"><a name="l00515"></a><span class="lineno"> 515</span> };</div>
|
|
<div class="line"><a name="l00516"></a><span class="lineno"> 516</span> </div>
|
|
<div class="line"><a name="l00517"></a><span class="lineno"> 517</span> <span class="comment">// The result of a single Test. This includes a list of</span></div>
|
|
<div class="line"><a name="l00518"></a><span class="lineno"> 518</span> <span class="comment">// TestPartResults, a list of TestProperties, a count of how many</span></div>
|
|
<div class="line"><a name="l00519"></a><span class="lineno"> 519</span> <span class="comment">// death tests there are in the Test, and how much time it took to run</span></div>
|
|
<div class="line"><a name="l00520"></a><span class="lineno"> 520</span> <span class="comment">// the Test.</span></div>
|
|
<div class="line"><a name="l00521"></a><span class="lineno"> 521</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00522"></a><span class="lineno"> 522</span> <span class="comment">// TestResult is not copyable.</span></div>
|
|
<div class="line"><a name="l00523"></a><span class="lineno"><a class="line" href="classtesting_1_1TestResult.html"> 523</a></span> <span class="keyword">class </span>GTEST_API_ <a class="code" href="classtesting_1_1TestResult.html">TestResult</a> {</div>
|
|
<div class="line"><a name="l00524"></a><span class="lineno"> 524</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00525"></a><span class="lineno"> 525</span>  <span class="comment">// Creates an empty TestResult.</span></div>
|
|
<div class="line"><a name="l00526"></a><span class="lineno"> 526</span>  <a class="code" href="classtesting_1_1TestResult.html">TestResult</a>();</div>
|
|
<div class="line"><a name="l00527"></a><span class="lineno"> 527</span> </div>
|
|
<div class="line"><a name="l00528"></a><span class="lineno"> 528</span>  <span class="comment">// D'tor. Do not inherit from TestResult.</span></div>
|
|
<div class="line"><a name="l00529"></a><span class="lineno"> 529</span>  ~<a class="code" href="classtesting_1_1TestResult.html">TestResult</a>();</div>
|
|
<div class="line"><a name="l00530"></a><span class="lineno"> 530</span> </div>
|
|
<div class="line"><a name="l00531"></a><span class="lineno"> 531</span>  <span class="comment">// Gets the number of all test parts. This is the sum of the number</span></div>
|
|
<div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  <span class="comment">// of successful test parts and the number of failed test parts.</span></div>
|
|
<div class="line"><a name="l00533"></a><span class="lineno"> 533</span>  <span class="keywordtype">int</span> total_part_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00534"></a><span class="lineno"> 534</span> </div>
|
|
<div class="line"><a name="l00535"></a><span class="lineno"> 535</span>  <span class="comment">// Returns the number of the test properties.</span></div>
|
|
<div class="line"><a name="l00536"></a><span class="lineno"> 536</span>  <span class="keywordtype">int</span> test_property_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00537"></a><span class="lineno"> 537</span> </div>
|
|
<div class="line"><a name="l00538"></a><span class="lineno"> 538</span>  <span class="comment">// Returns true iff the test passed (i.e. no test part failed).</span></div>
|
|
<div class="line"><a name="l00539"></a><span class="lineno"> 539</span>  <span class="keywordtype">bool</span> Passed()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> !Failed(); }</div>
|
|
<div class="line"><a name="l00540"></a><span class="lineno"> 540</span> </div>
|
|
<div class="line"><a name="l00541"></a><span class="lineno"> 541</span>  <span class="comment">// Returns true iff the test failed.</span></div>
|
|
<div class="line"><a name="l00542"></a><span class="lineno"> 542</span>  <span class="keywordtype">bool</span> Failed() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00543"></a><span class="lineno"> 543</span> </div>
|
|
<div class="line"><a name="l00544"></a><span class="lineno"> 544</span>  <span class="comment">// Returns true iff the test fatally failed.</span></div>
|
|
<div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  <span class="keywordtype">bool</span> HasFatalFailure() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00546"></a><span class="lineno"> 546</span> </div>
|
|
<div class="line"><a name="l00547"></a><span class="lineno"> 547</span>  <span class="comment">// Returns true iff the test has a non-fatal failure.</span></div>
|
|
<div class="line"><a name="l00548"></a><span class="lineno"> 548</span>  <span class="keywordtype">bool</span> HasNonfatalFailure() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00549"></a><span class="lineno"> 549</span> </div>
|
|
<div class="line"><a name="l00550"></a><span class="lineno"> 550</span>  <span class="comment">// Returns the elapsed time, in milliseconds.</span></div>
|
|
<div class="line"><a name="l00551"></a><span class="lineno"> 551</span>  TimeInMillis elapsed_time()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> elapsed_time_; }</div>
|
|
<div class="line"><a name="l00552"></a><span class="lineno"> 552</span> </div>
|
|
<div class="line"><a name="l00553"></a><span class="lineno"> 553</span>  <span class="comment">// Returns the i-th test part result among all the results. i can range</span></div>
|
|
<div class="line"><a name="l00554"></a><span class="lineno"> 554</span>  <span class="comment">// from 0 to test_property_count() - 1. If i is not in that range, aborts</span></div>
|
|
<div class="line"><a name="l00555"></a><span class="lineno"> 555</span>  <span class="comment">// the program.</span></div>
|
|
<div class="line"><a name="l00556"></a><span class="lineno"> 556</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1TestPartResult.html">TestPartResult</a>& GetTestPartResult(<span class="keywordtype">int</span> i) <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00557"></a><span class="lineno"> 557</span> </div>
|
|
<div class="line"><a name="l00558"></a><span class="lineno"> 558</span>  <span class="comment">// Returns the i-th test property. i can range from 0 to</span></div>
|
|
<div class="line"><a name="l00559"></a><span class="lineno"> 559</span>  <span class="comment">// test_property_count() - 1. If i is not in that range, aborts the</span></div>
|
|
<div class="line"><a name="l00560"></a><span class="lineno"> 560</span>  <span class="comment">// program.</span></div>
|
|
<div class="line"><a name="l00561"></a><span class="lineno"> 561</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1TestProperty.html">TestProperty</a>& GetTestProperty(<span class="keywordtype">int</span> i) <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00562"></a><span class="lineno"> 562</span> </div>
|
|
<div class="line"><a name="l00563"></a><span class="lineno"> 563</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l00564"></a><span class="lineno"> 564</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>;</div>
|
|
<div class="line"><a name="l00565"></a><span class="lineno"> 565</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1TestCase.html">TestCase</a>;</div>
|
|
<div class="line"><a name="l00566"></a><span class="lineno"> 566</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>;</div>
|
|
<div class="line"><a name="l00567"></a><span class="lineno"> 567</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1DefaultGlobalTestPartResultReporter.html">internal::DefaultGlobalTestPartResultReporter</a>;</div>
|
|
<div class="line"><a name="l00568"></a><span class="lineno"> 568</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::ExecDeathTest;</div>
|
|
<div class="line"><a name="l00569"></a><span class="lineno"> 569</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1TestResultAccessor.html">internal::TestResultAccessor</a>;</div>
|
|
<div class="line"><a name="l00570"></a><span class="lineno"> 570</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1UnitTestImpl.html">internal::UnitTestImpl</a>;</div>
|
|
<div class="line"><a name="l00571"></a><span class="lineno"> 571</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::WindowsDeathTest;</div>
|
|
<div class="line"><a name="l00572"></a><span class="lineno"> 572</span> </div>
|
|
<div class="line"><a name="l00573"></a><span class="lineno"> 573</span>  <span class="comment">// Gets the vector of TestPartResults.</span></div>
|
|
<div class="line"><a name="l00574"></a><span class="lineno"> 574</span>  <span class="keyword">const</span> std::vector<TestPartResult>& test_part_results()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l00575"></a><span class="lineno"> 575</span>  <span class="keywordflow">return</span> test_part_results_;</div>
|
|
<div class="line"><a name="l00576"></a><span class="lineno"> 576</span>  }</div>
|
|
<div class="line"><a name="l00577"></a><span class="lineno"> 577</span> </div>
|
|
<div class="line"><a name="l00578"></a><span class="lineno"> 578</span>  <span class="comment">// Gets the vector of TestProperties.</span></div>
|
|
<div class="line"><a name="l00579"></a><span class="lineno"> 579</span>  <span class="keyword">const</span> std::vector<TestProperty>& test_properties()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l00580"></a><span class="lineno"> 580</span>  <span class="keywordflow">return</span> test_properties_;</div>
|
|
<div class="line"><a name="l00581"></a><span class="lineno"> 581</span>  }</div>
|
|
<div class="line"><a name="l00582"></a><span class="lineno"> 582</span> </div>
|
|
<div class="line"><a name="l00583"></a><span class="lineno"> 583</span>  <span class="comment">// Sets the elapsed time.</span></div>
|
|
<div class="line"><a name="l00584"></a><span class="lineno"> 584</span>  <span class="keywordtype">void</span> set_elapsed_time(TimeInMillis elapsed) { elapsed_time_ = elapsed; }</div>
|
|
<div class="line"><a name="l00585"></a><span class="lineno"> 585</span> </div>
|
|
<div class="line"><a name="l00586"></a><span class="lineno"> 586</span>  <span class="comment">// Adds a test property to the list. The property is validated and may add</span></div>
|
|
<div class="line"><a name="l00587"></a><span class="lineno"> 587</span>  <span class="comment">// a non-fatal failure if invalid (e.g., if it conflicts with reserved</span></div>
|
|
<div class="line"><a name="l00588"></a><span class="lineno"> 588</span>  <span class="comment">// key names). If a property is already recorded for the same key, the</span></div>
|
|
<div class="line"><a name="l00589"></a><span class="lineno"> 589</span>  <span class="comment">// value will be updated, rather than storing multiple values for the same</span></div>
|
|
<div class="line"><a name="l00590"></a><span class="lineno"> 590</span>  <span class="comment">// key. xml_element specifies the element for which the property is being</span></div>
|
|
<div class="line"><a name="l00591"></a><span class="lineno"> 591</span>  <span class="comment">// recorded and is used for validation.</span></div>
|
|
<div class="line"><a name="l00592"></a><span class="lineno"> 592</span>  <span class="keywordtype">void</span> RecordProperty(<span class="keyword">const</span> std::string& xml_element,</div>
|
|
<div class="line"><a name="l00593"></a><span class="lineno"> 593</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1TestProperty.html">TestProperty</a>& test_property);</div>
|
|
<div class="line"><a name="l00594"></a><span class="lineno"> 594</span> </div>
|
|
<div class="line"><a name="l00595"></a><span class="lineno"> 595</span>  <span class="comment">// Adds a failure if the key is a reserved attribute of Google Test</span></div>
|
|
<div class="line"><a name="l00596"></a><span class="lineno"> 596</span>  <span class="comment">// testcase tags. Returns true if the property is valid.</span></div>
|
|
<div class="line"><a name="l00597"></a><span class="lineno"> 597</span>  <span class="comment">// TODO(russr): Validate attribute names are legal and human readable.</span></div>
|
|
<div class="line"><a name="l00598"></a><span class="lineno"> 598</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> ValidateTestProperty(<span class="keyword">const</span> std::string& xml_element,</div>
|
|
<div class="line"><a name="l00599"></a><span class="lineno"> 599</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1TestProperty.html">TestProperty</a>& test_property);</div>
|
|
<div class="line"><a name="l00600"></a><span class="lineno"> 600</span> </div>
|
|
<div class="line"><a name="l00601"></a><span class="lineno"> 601</span>  <span class="comment">// Adds a test part result to the list.</span></div>
|
|
<div class="line"><a name="l00602"></a><span class="lineno"> 602</span>  <span class="keywordtype">void</span> AddTestPartResult(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestPartResult.html">TestPartResult</a>& test_part_result);</div>
|
|
<div class="line"><a name="l00603"></a><span class="lineno"> 603</span> </div>
|
|
<div class="line"><a name="l00604"></a><span class="lineno"> 604</span>  <span class="comment">// Returns the death test count.</span></div>
|
|
<div class="line"><a name="l00605"></a><span class="lineno"> 605</span>  <span class="keywordtype">int</span> death_test_count()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> death_test_count_; }</div>
|
|
<div class="line"><a name="l00606"></a><span class="lineno"> 606</span> </div>
|
|
<div class="line"><a name="l00607"></a><span class="lineno"> 607</span>  <span class="comment">// Increments the death test count, returning the new count.</span></div>
|
|
<div class="line"><a name="l00608"></a><span class="lineno"> 608</span>  <span class="keywordtype">int</span> increment_death_test_count() { <span class="keywordflow">return</span> ++death_test_count_; }</div>
|
|
<div class="line"><a name="l00609"></a><span class="lineno"> 609</span> </div>
|
|
<div class="line"><a name="l00610"></a><span class="lineno"> 610</span>  <span class="comment">// Clears the test part results.</span></div>
|
|
<div class="line"><a name="l00611"></a><span class="lineno"> 611</span>  <span class="keywordtype">void</span> ClearTestPartResults();</div>
|
|
<div class="line"><a name="l00612"></a><span class="lineno"> 612</span> </div>
|
|
<div class="line"><a name="l00613"></a><span class="lineno"> 613</span>  <span class="comment">// Clears the object.</span></div>
|
|
<div class="line"><a name="l00614"></a><span class="lineno"> 614</span>  <span class="keywordtype">void</span> Clear();</div>
|
|
<div class="line"><a name="l00615"></a><span class="lineno"> 615</span> </div>
|
|
<div class="line"><a name="l00616"></a><span class="lineno"> 616</span>  <span class="comment">// Protects mutable state of the property vector and of owned</span></div>
|
|
<div class="line"><a name="l00617"></a><span class="lineno"> 617</span>  <span class="comment">// properties, whose values may be updated.</span></div>
|
|
<div class="line"><a name="l00618"></a><span class="lineno"> 618</span>  <a class="code" href="classtesting_1_1internal_1_1Mutex.html">internal::Mutex</a> test_properites_mutex_;</div>
|
|
<div class="line"><a name="l00619"></a><span class="lineno"> 619</span> </div>
|
|
<div class="line"><a name="l00620"></a><span class="lineno"> 620</span>  <span class="comment">// The vector of TestPartResults</span></div>
|
|
<div class="line"><a name="l00621"></a><span class="lineno"> 621</span>  std::vector<TestPartResult> test_part_results_;</div>
|
|
<div class="line"><a name="l00622"></a><span class="lineno"> 622</span>  <span class="comment">// The vector of TestProperties</span></div>
|
|
<div class="line"><a name="l00623"></a><span class="lineno"> 623</span>  std::vector<TestProperty> test_properties_;</div>
|
|
<div class="line"><a name="l00624"></a><span class="lineno"> 624</span>  <span class="comment">// Running count of death tests.</span></div>
|
|
<div class="line"><a name="l00625"></a><span class="lineno"> 625</span>  <span class="keywordtype">int</span> death_test_count_;</div>
|
|
<div class="line"><a name="l00626"></a><span class="lineno"> 626</span>  <span class="comment">// The elapsed time, in milliseconds.</span></div>
|
|
<div class="line"><a name="l00627"></a><span class="lineno"> 627</span>  TimeInMillis elapsed_time_;</div>
|
|
<div class="line"><a name="l00628"></a><span class="lineno"> 628</span> </div>
|
|
<div class="line"><a name="l00629"></a><span class="lineno"> 629</span>  <span class="comment">// We disallow copying TestResult.</span></div>
|
|
<div class="line"><a name="l00630"></a><span class="lineno"> 630</span>  GTEST_DISALLOW_COPY_AND_ASSIGN_(<a class="code" href="classtesting_1_1TestResult.html">TestResult</a>);</div>
|
|
<div class="line"><a name="l00631"></a><span class="lineno"> 631</span> }; <span class="comment">// class TestResult</span></div>
|
|
<div class="line"><a name="l00632"></a><span class="lineno"> 632</span> </div>
|
|
<div class="line"><a name="l00633"></a><span class="lineno"> 633</span> <span class="comment">// A TestInfo object stores the following information about a test:</span></div>
|
|
<div class="line"><a name="l00634"></a><span class="lineno"> 634</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00635"></a><span class="lineno"> 635</span> <span class="comment">// Test case name</span></div>
|
|
<div class="line"><a name="l00636"></a><span class="lineno"> 636</span> <span class="comment">// Test name</span></div>
|
|
<div class="line"><a name="l00637"></a><span class="lineno"> 637</span> <span class="comment">// Whether the test should be run</span></div>
|
|
<div class="line"><a name="l00638"></a><span class="lineno"> 638</span> <span class="comment">// A function pointer that creates the test object when invoked</span></div>
|
|
<div class="line"><a name="l00639"></a><span class="lineno"> 639</span> <span class="comment">// Test result</span></div>
|
|
<div class="line"><a name="l00640"></a><span class="lineno"> 640</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00641"></a><span class="lineno"> 641</span> <span class="comment">// The constructor of TestInfo registers itself with the UnitTest</span></div>
|
|
<div class="line"><a name="l00642"></a><span class="lineno"> 642</span> <span class="comment">// singleton such that the RUN_ALL_TESTS() macro knows which tests to</span></div>
|
|
<div class="line"><a name="l00643"></a><span class="lineno"> 643</span> <span class="comment">// run.</span></div>
|
|
<div class="line"><a name="l00644"></a><span class="lineno"><a class="line" href="classtesting_1_1TestInfo.html"> 644</a></span> <span class="keyword">class </span>GTEST_API_ <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a> {</div>
|
|
<div class="line"><a name="l00645"></a><span class="lineno"> 645</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00646"></a><span class="lineno"> 646</span>  <span class="comment">// Destructs a TestInfo object. This function is not virtual, so</span></div>
|
|
<div class="line"><a name="l00647"></a><span class="lineno"> 647</span>  <span class="comment">// don't inherit from TestInfo.</span></div>
|
|
<div class="line"><a name="l00648"></a><span class="lineno"> 648</span>  ~<a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>();</div>
|
|
<div class="line"><a name="l00649"></a><span class="lineno"> 649</span> </div>
|
|
<div class="line"><a name="l00650"></a><span class="lineno"> 650</span>  <span class="comment">// Returns the test case name.</span></div>
|
|
<div class="line"><a name="l00651"></a><span class="lineno"> 651</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* test_case_name()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> test_case_name_.c_str(); }</div>
|
|
<div class="line"><a name="l00652"></a><span class="lineno"> 652</span> </div>
|
|
<div class="line"><a name="l00653"></a><span class="lineno"> 653</span>  <span class="comment">// Returns the test name.</span></div>
|
|
<div class="line"><a name="l00654"></a><span class="lineno"> 654</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* name()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> name_.c_str(); }</div>
|
|
<div class="line"><a name="l00655"></a><span class="lineno"> 655</span> </div>
|
|
<div class="line"><a name="l00656"></a><span class="lineno"> 656</span>  <span class="comment">// Returns the name of the parameter type, or NULL if this is not a typed</span></div>
|
|
<div class="line"><a name="l00657"></a><span class="lineno"> 657</span>  <span class="comment">// or a type-parameterized test.</span></div>
|
|
<div class="line"><a name="l00658"></a><span class="lineno"> 658</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* type_param()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l00659"></a><span class="lineno"> 659</span>  <span class="keywordflow">if</span> (type_param_.get() != NULL)</div>
|
|
<div class="line"><a name="l00660"></a><span class="lineno"> 660</span>  <span class="keywordflow">return</span> type_param_->c_str();</div>
|
|
<div class="line"><a name="l00661"></a><span class="lineno"> 661</span>  <span class="keywordflow">return</span> NULL;</div>
|
|
<div class="line"><a name="l00662"></a><span class="lineno"> 662</span>  }</div>
|
|
<div class="line"><a name="l00663"></a><span class="lineno"> 663</span> </div>
|
|
<div class="line"><a name="l00664"></a><span class="lineno"> 664</span>  <span class="comment">// Returns the text representation of the value parameter, or NULL if this</span></div>
|
|
<div class="line"><a name="l00665"></a><span class="lineno"> 665</span>  <span class="comment">// is not a value-parameterized test.</span></div>
|
|
<div class="line"><a name="l00666"></a><span class="lineno"> 666</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* value_param()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l00667"></a><span class="lineno"> 667</span>  <span class="keywordflow">if</span> (value_param_.get() != NULL)</div>
|
|
<div class="line"><a name="l00668"></a><span class="lineno"> 668</span>  <span class="keywordflow">return</span> value_param_->c_str();</div>
|
|
<div class="line"><a name="l00669"></a><span class="lineno"> 669</span>  <span class="keywordflow">return</span> NULL;</div>
|
|
<div class="line"><a name="l00670"></a><span class="lineno"> 670</span>  }</div>
|
|
<div class="line"><a name="l00671"></a><span class="lineno"> 671</span> </div>
|
|
<div class="line"><a name="l00672"></a><span class="lineno"> 672</span>  <span class="comment">// Returns the file name where this test is defined.</span></div>
|
|
<div class="line"><a name="l00673"></a><span class="lineno"> 673</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* file()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> location_.file.c_str(); }</div>
|
|
<div class="line"><a name="l00674"></a><span class="lineno"> 674</span> </div>
|
|
<div class="line"><a name="l00675"></a><span class="lineno"> 675</span>  <span class="comment">// Returns the line where this test is defined.</span></div>
|
|
<div class="line"><a name="l00676"></a><span class="lineno"> 676</span>  <span class="keywordtype">int</span> line()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> location_.line; }</div>
|
|
<div class="line"><a name="l00677"></a><span class="lineno"> 677</span> </div>
|
|
<div class="line"><a name="l00678"></a><span class="lineno"> 678</span>  <span class="comment">// Returns true if this test should run, that is if the test is not</span></div>
|
|
<div class="line"><a name="l00679"></a><span class="lineno"> 679</span>  <span class="comment">// disabled (or it is disabled but the also_run_disabled_tests flag has</span></div>
|
|
<div class="line"><a name="l00680"></a><span class="lineno"> 680</span>  <span class="comment">// been specified) and its full name matches the user-specified filter.</span></div>
|
|
<div class="line"><a name="l00681"></a><span class="lineno"> 681</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00682"></a><span class="lineno"> 682</span>  <span class="comment">// Google Test allows the user to filter the tests by their full names.</span></div>
|
|
<div class="line"><a name="l00683"></a><span class="lineno"> 683</span>  <span class="comment">// The full name of a test Bar in test case Foo is defined as</span></div>
|
|
<div class="line"><a name="l00684"></a><span class="lineno"> 684</span>  <span class="comment">// "Foo.Bar". Only the tests that match the filter will run.</span></div>
|
|
<div class="line"><a name="l00685"></a><span class="lineno"> 685</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00686"></a><span class="lineno"> 686</span>  <span class="comment">// A filter is a colon-separated list of glob (not regex) patterns,</span></div>
|
|
<div class="line"><a name="l00687"></a><span class="lineno"> 687</span>  <span class="comment">// optionally followed by a '-' and a colon-separated list of</span></div>
|
|
<div class="line"><a name="l00688"></a><span class="lineno"> 688</span>  <span class="comment">// negative patterns (tests to exclude). A test is run if it</span></div>
|
|
<div class="line"><a name="l00689"></a><span class="lineno"> 689</span>  <span class="comment">// matches one of the positive patterns and does not match any of</span></div>
|
|
<div class="line"><a name="l00690"></a><span class="lineno"> 690</span>  <span class="comment">// the negative patterns.</span></div>
|
|
<div class="line"><a name="l00691"></a><span class="lineno"> 691</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00692"></a><span class="lineno"> 692</span>  <span class="comment">// For example, *A*:Foo.* is a filter that matches any string that</span></div>
|
|
<div class="line"><a name="l00693"></a><span class="lineno"> 693</span>  <span class="comment">// contains the character 'A' or starts with "Foo.".</span></div>
|
|
<div class="line"><a name="l00694"></a><span class="lineno"> 694</span>  <span class="keywordtype">bool</span> should_run()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> should_run_; }</div>
|
|
<div class="line"><a name="l00695"></a><span class="lineno"> 695</span> </div>
|
|
<div class="line"><a name="l00696"></a><span class="lineno"> 696</span>  <span class="comment">// Returns true iff this test will appear in the XML report.</span></div>
|
|
<div class="line"><a name="l00697"></a><span class="lineno"> 697</span>  <span class="keywordtype">bool</span> is_reportable()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l00698"></a><span class="lineno"> 698</span>  <span class="comment">// For now, the XML report includes all tests matching the filter.</span></div>
|
|
<div class="line"><a name="l00699"></a><span class="lineno"> 699</span>  <span class="comment">// In the future, we may trim tests that are excluded because of</span></div>
|
|
<div class="line"><a name="l00700"></a><span class="lineno"> 700</span>  <span class="comment">// sharding.</span></div>
|
|
<div class="line"><a name="l00701"></a><span class="lineno"> 701</span>  <span class="keywordflow">return</span> matches_filter_;</div>
|
|
<div class="line"><a name="l00702"></a><span class="lineno"> 702</span>  }</div>
|
|
<div class="line"><a name="l00703"></a><span class="lineno"> 703</span> </div>
|
|
<div class="line"><a name="l00704"></a><span class="lineno"> 704</span>  <span class="comment">// Returns the result of the test.</span></div>
|
|
<div class="line"><a name="l00705"></a><span class="lineno"> 705</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1TestResult.html">TestResult</a>* result()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> &result_; }</div>
|
|
<div class="line"><a name="l00706"></a><span class="lineno"> 706</span> </div>
|
|
<div class="line"><a name="l00707"></a><span class="lineno"> 707</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l00708"></a><span class="lineno"> 708</span> <span class="preprocessor">#if GTEST_HAS_DEATH_TEST</span></div>
|
|
<div class="line"><a name="l00709"></a><span class="lineno"> 709</span> <span class="preprocessor"></span> <span class="keyword">friend</span> <span class="keyword">class </span>internal::DefaultDeathTestFactory;</div>
|
|
<div class="line"><a name="l00710"></a><span class="lineno"> 710</span> <span class="preprocessor">#endif // GTEST_HAS_DEATH_TEST</span></div>
|
|
<div class="line"><a name="l00711"></a><span class="lineno"> 711</span> <span class="preprocessor"></span> <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1Test.html">Test</a>;</div>
|
|
<div class="line"><a name="l00712"></a><span class="lineno"> 712</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1TestCase.html">TestCase</a>;</div>
|
|
<div class="line"><a name="l00713"></a><span class="lineno"> 713</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1UnitTestImpl.html">internal::UnitTestImpl</a>;</div>
|
|
<div class="line"><a name="l00714"></a><span class="lineno"> 714</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::StreamingListenerTest;</div>
|
|
<div class="line"><a name="l00715"></a><span class="lineno"> 715</span>  <span class="keyword">friend</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>* internal::MakeAndRegisterTestInfo(</div>
|
|
<div class="line"><a name="l00716"></a><span class="lineno"> 716</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* test_case_name,</div>
|
|
<div class="line"><a name="l00717"></a><span class="lineno"> 717</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* name,</div>
|
|
<div class="line"><a name="l00718"></a><span class="lineno"> 718</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* type_param,</div>
|
|
<div class="line"><a name="l00719"></a><span class="lineno"> 719</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* value_param,</div>
|
|
<div class="line"><a name="l00720"></a><span class="lineno"> 720</span>  <a class="code" href="structtesting_1_1internal_1_1CodeLocation.html">internal::CodeLocation</a> code_location,</div>
|
|
<div class="line"><a name="l00721"></a><span class="lineno"> 721</span>  internal::TypeId fixture_class_id,</div>
|
|
<div class="line"><a name="l00722"></a><span class="lineno"> 722</span>  Test::SetUpTestCaseFunc set_up_tc,</div>
|
|
<div class="line"><a name="l00723"></a><span class="lineno"> 723</span>  Test::TearDownTestCaseFunc tear_down_tc,</div>
|
|
<div class="line"><a name="l00724"></a><span class="lineno"> 724</span>  <a class="code" href="classtesting_1_1internal_1_1TestFactoryBase.html">internal::TestFactoryBase</a>* factory);</div>
|
|
<div class="line"><a name="l00725"></a><span class="lineno"> 725</span> </div>
|
|
<div class="line"><a name="l00726"></a><span class="lineno"> 726</span>  <span class="comment">// Constructs a TestInfo object. The newly constructed instance assumes</span></div>
|
|
<div class="line"><a name="l00727"></a><span class="lineno"> 727</span>  <span class="comment">// ownership of the factory object.</span></div>
|
|
<div class="line"><a name="l00728"></a><span class="lineno"> 728</span>  <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>(<span class="keyword">const</span> std::string& test_case_name,</div>
|
|
<div class="line"><a name="l00729"></a><span class="lineno"> 729</span>  <span class="keyword">const</span> std::string& name,</div>
|
|
<div class="line"><a name="l00730"></a><span class="lineno"> 730</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* a_type_param, <span class="comment">// NULL if not a type-parameterized test</span></div>
|
|
<div class="line"><a name="l00731"></a><span class="lineno"> 731</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* a_value_param, <span class="comment">// NULL if not a value-parameterized test</span></div>
|
|
<div class="line"><a name="l00732"></a><span class="lineno"> 732</span>  <a class="code" href="structtesting_1_1internal_1_1CodeLocation.html">internal::CodeLocation</a> a_code_location,</div>
|
|
<div class="line"><a name="l00733"></a><span class="lineno"> 733</span>  internal::TypeId fixture_class_id,</div>
|
|
<div class="line"><a name="l00734"></a><span class="lineno"> 734</span>  <a class="code" href="classtesting_1_1internal_1_1TestFactoryBase.html">internal::TestFactoryBase</a>* factory);</div>
|
|
<div class="line"><a name="l00735"></a><span class="lineno"> 735</span> </div>
|
|
<div class="line"><a name="l00736"></a><span class="lineno"> 736</span>  <span class="comment">// Increments the number of death tests encountered in this test so</span></div>
|
|
<div class="line"><a name="l00737"></a><span class="lineno"> 737</span>  <span class="comment">// far.</span></div>
|
|
<div class="line"><a name="l00738"></a><span class="lineno"> 738</span>  <span class="keywordtype">int</span> increment_death_test_count() {</div>
|
|
<div class="line"><a name="l00739"></a><span class="lineno"> 739</span>  <span class="keywordflow">return</span> result_.increment_death_test_count();</div>
|
|
<div class="line"><a name="l00740"></a><span class="lineno"> 740</span>  }</div>
|
|
<div class="line"><a name="l00741"></a><span class="lineno"> 741</span> </div>
|
|
<div class="line"><a name="l00742"></a><span class="lineno"> 742</span>  <span class="comment">// Creates the test object, runs it, records its result, and then</span></div>
|
|
<div class="line"><a name="l00743"></a><span class="lineno"> 743</span>  <span class="comment">// deletes it.</span></div>
|
|
<div class="line"><a name="l00744"></a><span class="lineno"> 744</span>  <span class="keywordtype">void</span> Run();</div>
|
|
<div class="line"><a name="l00745"></a><span class="lineno"> 745</span> </div>
|
|
<div class="line"><a name="l00746"></a><span class="lineno"> 746</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> ClearTestResult(<a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>* test_info) {</div>
|
|
<div class="line"><a name="l00747"></a><span class="lineno"> 747</span>  test_info->result_.Clear();</div>
|
|
<div class="line"><a name="l00748"></a><span class="lineno"> 748</span>  }</div>
|
|
<div class="line"><a name="l00749"></a><span class="lineno"> 749</span> </div>
|
|
<div class="line"><a name="l00750"></a><span class="lineno"> 750</span>  <span class="comment">// These fields are immutable properties of the test.</span></div>
|
|
<div class="line"><a name="l00751"></a><span class="lineno"> 751</span>  <span class="keyword">const</span> std::string test_case_name_; <span class="comment">// Test case name</span></div>
|
|
<div class="line"><a name="l00752"></a><span class="lineno"> 752</span>  <span class="keyword">const</span> std::string name_; <span class="comment">// Test name</span></div>
|
|
<div class="line"><a name="l00753"></a><span class="lineno"> 753</span>  <span class="comment">// Name of the parameter type, or NULL if this is not a typed or a</span></div>
|
|
<div class="line"><a name="l00754"></a><span class="lineno"> 754</span>  <span class="comment">// type-parameterized test.</span></div>
|
|
<div class="line"><a name="l00755"></a><span class="lineno"> 755</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1internal_1_1scoped__ptr.html">internal::scoped_ptr<const ::std::string></a> type_param_;</div>
|
|
<div class="line"><a name="l00756"></a><span class="lineno"> 756</span>  <span class="comment">// Text representation of the value parameter, or NULL if this is not a</span></div>
|
|
<div class="line"><a name="l00757"></a><span class="lineno"> 757</span>  <span class="comment">// value-parameterized test.</span></div>
|
|
<div class="line"><a name="l00758"></a><span class="lineno"> 758</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1internal_1_1scoped__ptr.html">internal::scoped_ptr<const ::std::string></a> value_param_;</div>
|
|
<div class="line"><a name="l00759"></a><span class="lineno"> 759</span>  <a class="code" href="structtesting_1_1internal_1_1CodeLocation.html">internal::CodeLocation</a> location_;</div>
|
|
<div class="line"><a name="l00760"></a><span class="lineno"> 760</span>  <span class="keyword">const</span> internal::TypeId fixture_class_id_; <span class="comment">// ID of the test fixture class</span></div>
|
|
<div class="line"><a name="l00761"></a><span class="lineno"> 761</span>  <span class="keywordtype">bool</span> should_run_; <span class="comment">// True iff this test should run</span></div>
|
|
<div class="line"><a name="l00762"></a><span class="lineno"> 762</span>  <span class="keywordtype">bool</span> is_disabled_; <span class="comment">// True iff this test is disabled</span></div>
|
|
<div class="line"><a name="l00763"></a><span class="lineno"> 763</span>  <span class="keywordtype">bool</span> matches_filter_; <span class="comment">// True if this test matches the</span></div>
|
|
<div class="line"><a name="l00764"></a><span class="lineno"> 764</span>  <span class="comment">// user-specified filter.</span></div>
|
|
<div class="line"><a name="l00765"></a><span class="lineno"> 765</span>  <a class="code" href="classtesting_1_1internal_1_1TestFactoryBase.html">internal::TestFactoryBase</a>* <span class="keyword">const</span> factory_; <span class="comment">// The factory that creates</span></div>
|
|
<div class="line"><a name="l00766"></a><span class="lineno"> 766</span>  <span class="comment">// the test object</span></div>
|
|
<div class="line"><a name="l00767"></a><span class="lineno"> 767</span> </div>
|
|
<div class="line"><a name="l00768"></a><span class="lineno"> 768</span>  <span class="comment">// This field is mutable and needs to be reset before running the</span></div>
|
|
<div class="line"><a name="l00769"></a><span class="lineno"> 769</span>  <span class="comment">// test for the second time.</span></div>
|
|
<div class="line"><a name="l00770"></a><span class="lineno"> 770</span>  <a class="code" href="classtesting_1_1TestResult.html">TestResult</a> result_;</div>
|
|
<div class="line"><a name="l00771"></a><span class="lineno"> 771</span> </div>
|
|
<div class="line"><a name="l00772"></a><span class="lineno"> 772</span>  GTEST_DISALLOW_COPY_AND_ASSIGN_(<a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>);</div>
|
|
<div class="line"><a name="l00773"></a><span class="lineno"> 773</span> };</div>
|
|
<div class="line"><a name="l00774"></a><span class="lineno"> 774</span> </div>
|
|
<div class="line"><a name="l00775"></a><span class="lineno"> 775</span> <span class="comment">// A test case, which consists of a vector of TestInfos.</span></div>
|
|
<div class="line"><a name="l00776"></a><span class="lineno"> 776</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00777"></a><span class="lineno"> 777</span> <span class="comment">// TestCase is not copyable.</span></div>
|
|
<div class="line"><a name="l00778"></a><span class="lineno"><a class="line" href="classtesting_1_1TestCase.html"> 778</a></span> <span class="keyword">class </span>GTEST_API_ <a class="code" href="classtesting_1_1TestCase.html">TestCase</a> {</div>
|
|
<div class="line"><a name="l00779"></a><span class="lineno"> 779</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00780"></a><span class="lineno"> 780</span>  <span class="comment">// Creates a TestCase with the given name.</span></div>
|
|
<div class="line"><a name="l00781"></a><span class="lineno"> 781</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00782"></a><span class="lineno"> 782</span>  <span class="comment">// TestCase does NOT have a default constructor. Always use this</span></div>
|
|
<div class="line"><a name="l00783"></a><span class="lineno"> 783</span>  <span class="comment">// constructor to create a TestCase object.</span></div>
|
|
<div class="line"><a name="l00784"></a><span class="lineno"> 784</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00785"></a><span class="lineno"> 785</span>  <span class="comment">// Arguments:</span></div>
|
|
<div class="line"><a name="l00786"></a><span class="lineno"> 786</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00787"></a><span class="lineno"> 787</span>  <span class="comment">// name: name of the test case</span></div>
|
|
<div class="line"><a name="l00788"></a><span class="lineno"> 788</span>  <span class="comment">// a_type_param: the name of the test's type parameter, or NULL if</span></div>
|
|
<div class="line"><a name="l00789"></a><span class="lineno"> 789</span>  <span class="comment">// this is not a type-parameterized test.</span></div>
|
|
<div class="line"><a name="l00790"></a><span class="lineno"> 790</span>  <span class="comment">// set_up_tc: pointer to the function that sets up the test case</span></div>
|
|
<div class="line"><a name="l00791"></a><span class="lineno"> 791</span>  <span class="comment">// tear_down_tc: pointer to the function that tears down the test case</span></div>
|
|
<div class="line"><a name="l00792"></a><span class="lineno"> 792</span>  <a class="code" href="classtesting_1_1TestCase.html">TestCase</a>(<span class="keyword">const</span> <span class="keywordtype">char</span>* name, <span class="keyword">const</span> <span class="keywordtype">char</span>* a_type_param,</div>
|
|
<div class="line"><a name="l00793"></a><span class="lineno"> 793</span>  Test::SetUpTestCaseFunc set_up_tc,</div>
|
|
<div class="line"><a name="l00794"></a><span class="lineno"> 794</span>  Test::TearDownTestCaseFunc tear_down_tc);</div>
|
|
<div class="line"><a name="l00795"></a><span class="lineno"> 795</span> </div>
|
|
<div class="line"><a name="l00796"></a><span class="lineno"> 796</span>  <span class="comment">// Destructor of TestCase.</span></div>
|
|
<div class="line"><a name="l00797"></a><span class="lineno"> 797</span>  <span class="keyword">virtual</span> ~<a class="code" href="classtesting_1_1TestCase.html">TestCase</a>();</div>
|
|
<div class="line"><a name="l00798"></a><span class="lineno"> 798</span> </div>
|
|
<div class="line"><a name="l00799"></a><span class="lineno"> 799</span>  <span class="comment">// Gets the name of the TestCase.</span></div>
|
|
<div class="line"><a name="l00800"></a><span class="lineno"> 800</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* name()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> name_.c_str(); }</div>
|
|
<div class="line"><a name="l00801"></a><span class="lineno"> 801</span> </div>
|
|
<div class="line"><a name="l00802"></a><span class="lineno"> 802</span>  <span class="comment">// Returns the name of the parameter type, or NULL if this is not a</span></div>
|
|
<div class="line"><a name="l00803"></a><span class="lineno"> 803</span>  <span class="comment">// type-parameterized test case.</span></div>
|
|
<div class="line"><a name="l00804"></a><span class="lineno"> 804</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* type_param()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l00805"></a><span class="lineno"> 805</span>  <span class="keywordflow">if</span> (type_param_.get() != NULL)</div>
|
|
<div class="line"><a name="l00806"></a><span class="lineno"> 806</span>  <span class="keywordflow">return</span> type_param_->c_str();</div>
|
|
<div class="line"><a name="l00807"></a><span class="lineno"> 807</span>  <span class="keywordflow">return</span> NULL;</div>
|
|
<div class="line"><a name="l00808"></a><span class="lineno"> 808</span>  }</div>
|
|
<div class="line"><a name="l00809"></a><span class="lineno"> 809</span> </div>
|
|
<div class="line"><a name="l00810"></a><span class="lineno"> 810</span>  <span class="comment">// Returns true if any test in this test case should run.</span></div>
|
|
<div class="line"><a name="l00811"></a><span class="lineno"> 811</span>  <span class="keywordtype">bool</span> should_run()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> should_run_; }</div>
|
|
<div class="line"><a name="l00812"></a><span class="lineno"> 812</span> </div>
|
|
<div class="line"><a name="l00813"></a><span class="lineno"> 813</span>  <span class="comment">// Gets the number of successful tests in this test case.</span></div>
|
|
<div class="line"><a name="l00814"></a><span class="lineno"> 814</span>  <span class="keywordtype">int</span> successful_test_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00815"></a><span class="lineno"> 815</span> </div>
|
|
<div class="line"><a name="l00816"></a><span class="lineno"> 816</span>  <span class="comment">// Gets the number of failed tests in this test case.</span></div>
|
|
<div class="line"><a name="l00817"></a><span class="lineno"> 817</span>  <span class="keywordtype">int</span> failed_test_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00818"></a><span class="lineno"> 818</span> </div>
|
|
<div class="line"><a name="l00819"></a><span class="lineno"> 819</span>  <span class="comment">// Gets the number of disabled tests that will be reported in the XML report.</span></div>
|
|
<div class="line"><a name="l00820"></a><span class="lineno"> 820</span>  <span class="keywordtype">int</span> reportable_disabled_test_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00821"></a><span class="lineno"> 821</span> </div>
|
|
<div class="line"><a name="l00822"></a><span class="lineno"> 822</span>  <span class="comment">// Gets the number of disabled tests in this test case.</span></div>
|
|
<div class="line"><a name="l00823"></a><span class="lineno"> 823</span>  <span class="keywordtype">int</span> disabled_test_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00824"></a><span class="lineno"> 824</span> </div>
|
|
<div class="line"><a name="l00825"></a><span class="lineno"> 825</span>  <span class="comment">// Gets the number of tests to be printed in the XML report.</span></div>
|
|
<div class="line"><a name="l00826"></a><span class="lineno"> 826</span>  <span class="keywordtype">int</span> reportable_test_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00827"></a><span class="lineno"> 827</span> </div>
|
|
<div class="line"><a name="l00828"></a><span class="lineno"> 828</span>  <span class="comment">// Get the number of tests in this test case that should run.</span></div>
|
|
<div class="line"><a name="l00829"></a><span class="lineno"> 829</span>  <span class="keywordtype">int</span> test_to_run_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00830"></a><span class="lineno"> 830</span> </div>
|
|
<div class="line"><a name="l00831"></a><span class="lineno"> 831</span>  <span class="comment">// Gets the number of all tests in this test case.</span></div>
|
|
<div class="line"><a name="l00832"></a><span class="lineno"> 832</span>  <span class="keywordtype">int</span> total_test_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00833"></a><span class="lineno"> 833</span> </div>
|
|
<div class="line"><a name="l00834"></a><span class="lineno"> 834</span>  <span class="comment">// Returns true iff the test case passed.</span></div>
|
|
<div class="line"><a name="l00835"></a><span class="lineno"> 835</span>  <span class="keywordtype">bool</span> Passed()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> !Failed(); }</div>
|
|
<div class="line"><a name="l00836"></a><span class="lineno"> 836</span> </div>
|
|
<div class="line"><a name="l00837"></a><span class="lineno"> 837</span>  <span class="comment">// Returns true iff the test case failed.</span></div>
|
|
<div class="line"><a name="l00838"></a><span class="lineno"> 838</span>  <span class="keywordtype">bool</span> Failed()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> failed_test_count() > 0; }</div>
|
|
<div class="line"><a name="l00839"></a><span class="lineno"> 839</span> </div>
|
|
<div class="line"><a name="l00840"></a><span class="lineno"> 840</span>  <span class="comment">// Returns the elapsed time, in milliseconds.</span></div>
|
|
<div class="line"><a name="l00841"></a><span class="lineno"> 841</span>  TimeInMillis elapsed_time()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> elapsed_time_; }</div>
|
|
<div class="line"><a name="l00842"></a><span class="lineno"> 842</span> </div>
|
|
<div class="line"><a name="l00843"></a><span class="lineno"> 843</span>  <span class="comment">// Returns the i-th test among all the tests. i can range from 0 to</span></div>
|
|
<div class="line"><a name="l00844"></a><span class="lineno"> 844</span>  <span class="comment">// total_test_count() - 1. If i is not in that range, returns NULL.</span></div>
|
|
<div class="line"><a name="l00845"></a><span class="lineno"> 845</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>* GetTestInfo(<span class="keywordtype">int</span> i) <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l00846"></a><span class="lineno"> 846</span> </div>
|
|
<div class="line"><a name="l00847"></a><span class="lineno"> 847</span>  <span class="comment">// Returns the TestResult that holds test properties recorded during</span></div>
|
|
<div class="line"><a name="l00848"></a><span class="lineno"> 848</span>  <span class="comment">// execution of SetUpTestCase and TearDownTestCase.</span></div>
|
|
<div class="line"><a name="l00849"></a><span class="lineno"> 849</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1TestResult.html">TestResult</a>& ad_hoc_test_result()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> ad_hoc_test_result_; }</div>
|
|
<div class="line"><a name="l00850"></a><span class="lineno"> 850</span> </div>
|
|
<div class="line"><a name="l00851"></a><span class="lineno"> 851</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l00852"></a><span class="lineno"> 852</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1Test.html">Test</a>;</div>
|
|
<div class="line"><a name="l00853"></a><span class="lineno"> 853</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1UnitTestImpl.html">internal::UnitTestImpl</a>;</div>
|
|
<div class="line"><a name="l00854"></a><span class="lineno"> 854</span> </div>
|
|
<div class="line"><a name="l00855"></a><span class="lineno"> 855</span>  <span class="comment">// Gets the (mutable) vector of TestInfos in this TestCase.</span></div>
|
|
<div class="line"><a name="l00856"></a><span class="lineno"> 856</span>  std::vector<TestInfo*>& test_info_list() { <span class="keywordflow">return</span> test_info_list_; }</div>
|
|
<div class="line"><a name="l00857"></a><span class="lineno"> 857</span> </div>
|
|
<div class="line"><a name="l00858"></a><span class="lineno"> 858</span>  <span class="comment">// Gets the (immutable) vector of TestInfos in this TestCase.</span></div>
|
|
<div class="line"><a name="l00859"></a><span class="lineno"> 859</span>  <span class="keyword">const</span> std::vector<TestInfo*>& test_info_list()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l00860"></a><span class="lineno"> 860</span>  <span class="keywordflow">return</span> test_info_list_;</div>
|
|
<div class="line"><a name="l00861"></a><span class="lineno"> 861</span>  }</div>
|
|
<div class="line"><a name="l00862"></a><span class="lineno"> 862</span> </div>
|
|
<div class="line"><a name="l00863"></a><span class="lineno"> 863</span>  <span class="comment">// Returns the i-th test among all the tests. i can range from 0 to</span></div>
|
|
<div class="line"><a name="l00864"></a><span class="lineno"> 864</span>  <span class="comment">// total_test_count() - 1. If i is not in that range, returns NULL.</span></div>
|
|
<div class="line"><a name="l00865"></a><span class="lineno"> 865</span>  <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>* GetMutableTestInfo(<span class="keywordtype">int</span> i);</div>
|
|
<div class="line"><a name="l00866"></a><span class="lineno"> 866</span> </div>
|
|
<div class="line"><a name="l00867"></a><span class="lineno"> 867</span>  <span class="comment">// Sets the should_run member.</span></div>
|
|
<div class="line"><a name="l00868"></a><span class="lineno"> 868</span>  <span class="keywordtype">void</span> set_should_run(<span class="keywordtype">bool</span> should) { should_run_ = should; }</div>
|
|
<div class="line"><a name="l00869"></a><span class="lineno"> 869</span> </div>
|
|
<div class="line"><a name="l00870"></a><span class="lineno"> 870</span>  <span class="comment">// Adds a TestInfo to this test case. Will delete the TestInfo upon</span></div>
|
|
<div class="line"><a name="l00871"></a><span class="lineno"> 871</span>  <span class="comment">// destruction of the TestCase object.</span></div>
|
|
<div class="line"><a name="l00872"></a><span class="lineno"> 872</span>  <span class="keywordtype">void</span> AddTestInfo(<a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a> * test_info);</div>
|
|
<div class="line"><a name="l00873"></a><span class="lineno"> 873</span> </div>
|
|
<div class="line"><a name="l00874"></a><span class="lineno"> 874</span>  <span class="comment">// Clears the results of all tests in this test case.</span></div>
|
|
<div class="line"><a name="l00875"></a><span class="lineno"> 875</span>  <span class="keywordtype">void</span> ClearResult();</div>
|
|
<div class="line"><a name="l00876"></a><span class="lineno"> 876</span> </div>
|
|
<div class="line"><a name="l00877"></a><span class="lineno"> 877</span>  <span class="comment">// Clears the results of all tests in the given test case.</span></div>
|
|
<div class="line"><a name="l00878"></a><span class="lineno"> 878</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> ClearTestCaseResult(<a class="code" href="classtesting_1_1TestCase.html">TestCase</a>* test_case) {</div>
|
|
<div class="line"><a name="l00879"></a><span class="lineno"> 879</span>  test_case->ClearResult();</div>
|
|
<div class="line"><a name="l00880"></a><span class="lineno"> 880</span>  }</div>
|
|
<div class="line"><a name="l00881"></a><span class="lineno"> 881</span> </div>
|
|
<div class="line"><a name="l00882"></a><span class="lineno"> 882</span>  <span class="comment">// Runs every test in this TestCase.</span></div>
|
|
<div class="line"><a name="l00883"></a><span class="lineno"> 883</span>  <span class="keywordtype">void</span> Run();</div>
|
|
<div class="line"><a name="l00884"></a><span class="lineno"> 884</span> </div>
|
|
<div class="line"><a name="l00885"></a><span class="lineno"> 885</span>  <span class="comment">// Runs SetUpTestCase() for this TestCase. This wrapper is needed</span></div>
|
|
<div class="line"><a name="l00886"></a><span class="lineno"> 886</span>  <span class="comment">// for catching exceptions thrown from SetUpTestCase().</span></div>
|
|
<div class="line"><a name="l00887"></a><span class="lineno"> 887</span>  <span class="keywordtype">void</span> RunSetUpTestCase() { (*set_up_tc_)(); }</div>
|
|
<div class="line"><a name="l00888"></a><span class="lineno"> 888</span> </div>
|
|
<div class="line"><a name="l00889"></a><span class="lineno"> 889</span>  <span class="comment">// Runs TearDownTestCase() for this TestCase. This wrapper is</span></div>
|
|
<div class="line"><a name="l00890"></a><span class="lineno"> 890</span>  <span class="comment">// needed for catching exceptions thrown from TearDownTestCase().</span></div>
|
|
<div class="line"><a name="l00891"></a><span class="lineno"> 891</span>  <span class="keywordtype">void</span> RunTearDownTestCase() { (*tear_down_tc_)(); }</div>
|
|
<div class="line"><a name="l00892"></a><span class="lineno"> 892</span> </div>
|
|
<div class="line"><a name="l00893"></a><span class="lineno"> 893</span>  <span class="comment">// Returns true iff test passed.</span></div>
|
|
<div class="line"><a name="l00894"></a><span class="lineno"> 894</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> TestPassed(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>* test_info) {</div>
|
|
<div class="line"><a name="l00895"></a><span class="lineno"> 895</span>  <span class="keywordflow">return</span> test_info->should_run() && test_info->result()->Passed();</div>
|
|
<div class="line"><a name="l00896"></a><span class="lineno"> 896</span>  }</div>
|
|
<div class="line"><a name="l00897"></a><span class="lineno"> 897</span> </div>
|
|
<div class="line"><a name="l00898"></a><span class="lineno"> 898</span>  <span class="comment">// Returns true iff test failed.</span></div>
|
|
<div class="line"><a name="l00899"></a><span class="lineno"> 899</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> TestFailed(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>* test_info) {</div>
|
|
<div class="line"><a name="l00900"></a><span class="lineno"> 900</span>  <span class="keywordflow">return</span> test_info->should_run() && test_info->result()->Failed();</div>
|
|
<div class="line"><a name="l00901"></a><span class="lineno"> 901</span>  }</div>
|
|
<div class="line"><a name="l00902"></a><span class="lineno"> 902</span> </div>
|
|
<div class="line"><a name="l00903"></a><span class="lineno"> 903</span>  <span class="comment">// Returns true iff the test is disabled and will be reported in the XML</span></div>
|
|
<div class="line"><a name="l00904"></a><span class="lineno"> 904</span>  <span class="comment">// report.</span></div>
|
|
<div class="line"><a name="l00905"></a><span class="lineno"> 905</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> TestReportableDisabled(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>* test_info) {</div>
|
|
<div class="line"><a name="l00906"></a><span class="lineno"> 906</span>  <span class="keywordflow">return</span> test_info->is_reportable() && test_info->is_disabled_;</div>
|
|
<div class="line"><a name="l00907"></a><span class="lineno"> 907</span>  }</div>
|
|
<div class="line"><a name="l00908"></a><span class="lineno"> 908</span> </div>
|
|
<div class="line"><a name="l00909"></a><span class="lineno"> 909</span>  <span class="comment">// Returns true iff test is disabled.</span></div>
|
|
<div class="line"><a name="l00910"></a><span class="lineno"> 910</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> TestDisabled(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>* test_info) {</div>
|
|
<div class="line"><a name="l00911"></a><span class="lineno"> 911</span>  <span class="keywordflow">return</span> test_info->is_disabled_;</div>
|
|
<div class="line"><a name="l00912"></a><span class="lineno"> 912</span>  }</div>
|
|
<div class="line"><a name="l00913"></a><span class="lineno"> 913</span> </div>
|
|
<div class="line"><a name="l00914"></a><span class="lineno"> 914</span>  <span class="comment">// Returns true iff this test will appear in the XML report.</span></div>
|
|
<div class="line"><a name="l00915"></a><span class="lineno"> 915</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> TestReportable(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>* test_info) {</div>
|
|
<div class="line"><a name="l00916"></a><span class="lineno"> 916</span>  <span class="keywordflow">return</span> test_info->is_reportable();</div>
|
|
<div class="line"><a name="l00917"></a><span class="lineno"> 917</span>  }</div>
|
|
<div class="line"><a name="l00918"></a><span class="lineno"> 918</span> </div>
|
|
<div class="line"><a name="l00919"></a><span class="lineno"> 919</span>  <span class="comment">// Returns true if the given test should run.</span></div>
|
|
<div class="line"><a name="l00920"></a><span class="lineno"> 920</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> ShouldRunTest(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>* test_info) {</div>
|
|
<div class="line"><a name="l00921"></a><span class="lineno"> 921</span>  <span class="keywordflow">return</span> test_info->should_run();</div>
|
|
<div class="line"><a name="l00922"></a><span class="lineno"> 922</span>  }</div>
|
|
<div class="line"><a name="l00923"></a><span class="lineno"> 923</span> </div>
|
|
<div class="line"><a name="l00924"></a><span class="lineno"> 924</span>  <span class="comment">// Shuffles the tests in this test case.</span></div>
|
|
<div class="line"><a name="l00925"></a><span class="lineno"> 925</span>  <span class="keywordtype">void</span> ShuffleTests(<a class="code" href="classtesting_1_1internal_1_1Random.html">internal::Random</a>* random);</div>
|
|
<div class="line"><a name="l00926"></a><span class="lineno"> 926</span> </div>
|
|
<div class="line"><a name="l00927"></a><span class="lineno"> 927</span>  <span class="comment">// Restores the test order to before the first shuffle.</span></div>
|
|
<div class="line"><a name="l00928"></a><span class="lineno"> 928</span>  <span class="keywordtype">void</span> UnshuffleTests();</div>
|
|
<div class="line"><a name="l00929"></a><span class="lineno"> 929</span> </div>
|
|
<div class="line"><a name="l00930"></a><span class="lineno"> 930</span>  <span class="comment">// Name of the test case.</span></div>
|
|
<div class="line"><a name="l00931"></a><span class="lineno"> 931</span>  std::string name_;</div>
|
|
<div class="line"><a name="l00932"></a><span class="lineno"> 932</span>  <span class="comment">// Name of the parameter type, or NULL if this is not a typed or a</span></div>
|
|
<div class="line"><a name="l00933"></a><span class="lineno"> 933</span>  <span class="comment">// type-parameterized test.</span></div>
|
|
<div class="line"><a name="l00934"></a><span class="lineno"> 934</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1internal_1_1scoped__ptr.html">internal::scoped_ptr<const ::std::string></a> type_param_;</div>
|
|
<div class="line"><a name="l00935"></a><span class="lineno"> 935</span>  <span class="comment">// The vector of TestInfos in their original order. It owns the</span></div>
|
|
<div class="line"><a name="l00936"></a><span class="lineno"> 936</span>  <span class="comment">// elements in the vector.</span></div>
|
|
<div class="line"><a name="l00937"></a><span class="lineno"> 937</span>  std::vector<TestInfo*> test_info_list_;</div>
|
|
<div class="line"><a name="l00938"></a><span class="lineno"> 938</span>  <span class="comment">// Provides a level of indirection for the test list to allow easy</span></div>
|
|
<div class="line"><a name="l00939"></a><span class="lineno"> 939</span>  <span class="comment">// shuffling and restoring the test order. The i-th element in this</span></div>
|
|
<div class="line"><a name="l00940"></a><span class="lineno"> 940</span>  <span class="comment">// vector is the index of the i-th test in the shuffled test list.</span></div>
|
|
<div class="line"><a name="l00941"></a><span class="lineno"> 941</span>  std::vector<int> test_indices_;</div>
|
|
<div class="line"><a name="l00942"></a><span class="lineno"> 942</span>  <span class="comment">// Pointer to the function that sets up the test case.</span></div>
|
|
<div class="line"><a name="l00943"></a><span class="lineno"> 943</span>  Test::SetUpTestCaseFunc set_up_tc_;</div>
|
|
<div class="line"><a name="l00944"></a><span class="lineno"> 944</span>  <span class="comment">// Pointer to the function that tears down the test case.</span></div>
|
|
<div class="line"><a name="l00945"></a><span class="lineno"> 945</span>  Test::TearDownTestCaseFunc tear_down_tc_;</div>
|
|
<div class="line"><a name="l00946"></a><span class="lineno"> 946</span>  <span class="comment">// True iff any test in this test case should run.</span></div>
|
|
<div class="line"><a name="l00947"></a><span class="lineno"> 947</span>  <span class="keywordtype">bool</span> should_run_;</div>
|
|
<div class="line"><a name="l00948"></a><span class="lineno"> 948</span>  <span class="comment">// Elapsed time, in milliseconds.</span></div>
|
|
<div class="line"><a name="l00949"></a><span class="lineno"> 949</span>  TimeInMillis elapsed_time_;</div>
|
|
<div class="line"><a name="l00950"></a><span class="lineno"> 950</span>  <span class="comment">// Holds test properties recorded during execution of SetUpTestCase and</span></div>
|
|
<div class="line"><a name="l00951"></a><span class="lineno"> 951</span>  <span class="comment">// TearDownTestCase.</span></div>
|
|
<div class="line"><a name="l00952"></a><span class="lineno"> 952</span>  <a class="code" href="classtesting_1_1TestResult.html">TestResult</a> ad_hoc_test_result_;</div>
|
|
<div class="line"><a name="l00953"></a><span class="lineno"> 953</span> </div>
|
|
<div class="line"><a name="l00954"></a><span class="lineno"> 954</span>  <span class="comment">// We disallow copying TestCases.</span></div>
|
|
<div class="line"><a name="l00955"></a><span class="lineno"> 955</span>  GTEST_DISALLOW_COPY_AND_ASSIGN_(<a class="code" href="classtesting_1_1TestCase.html">TestCase</a>);</div>
|
|
<div class="line"><a name="l00956"></a><span class="lineno"> 956</span> };</div>
|
|
<div class="line"><a name="l00957"></a><span class="lineno"> 957</span> </div>
|
|
<div class="line"><a name="l00958"></a><span class="lineno"> 958</span> <span class="comment">// An Environment object is capable of setting up and tearing down an</span></div>
|
|
<div class="line"><a name="l00959"></a><span class="lineno"> 959</span> <span class="comment">// environment. You should subclass this to define your own</span></div>
|
|
<div class="line"><a name="l00960"></a><span class="lineno"> 960</span> <span class="comment">// environment(s).</span></div>
|
|
<div class="line"><a name="l00961"></a><span class="lineno"> 961</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00962"></a><span class="lineno"> 962</span> <span class="comment">// An Environment object does the set-up and tear-down in virtual</span></div>
|
|
<div class="line"><a name="l00963"></a><span class="lineno"> 963</span> <span class="comment">// methods SetUp() and TearDown() instead of the constructor and the</span></div>
|
|
<div class="line"><a name="l00964"></a><span class="lineno"> 964</span> <span class="comment">// destructor, as:</span></div>
|
|
<div class="line"><a name="l00965"></a><span class="lineno"> 965</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l00966"></a><span class="lineno"> 966</span> <span class="comment">// 1. You cannot safely throw from a destructor. This is a problem</span></div>
|
|
<div class="line"><a name="l00967"></a><span class="lineno"> 967</span> <span class="comment">// as in some cases Google Test is used where exceptions are enabled, and</span></div>
|
|
<div class="line"><a name="l00968"></a><span class="lineno"> 968</span> <span class="comment">// we may want to implement ASSERT_* using exceptions where they are</span></div>
|
|
<div class="line"><a name="l00969"></a><span class="lineno"> 969</span> <span class="comment">// available.</span></div>
|
|
<div class="line"><a name="l00970"></a><span class="lineno"> 970</span> <span class="comment">// 2. You cannot use ASSERT_* directly in a constructor or</span></div>
|
|
<div class="line"><a name="l00971"></a><span class="lineno"> 971</span> <span class="comment">// destructor.</span></div>
|
|
<div class="line"><a name="l00972"></a><span class="lineno"><a class="line" href="classtesting_1_1Environment.html"> 972</a></span> <span class="keyword">class </span><a class="code" href="classtesting_1_1Environment.html">Environment</a> {</div>
|
|
<div class="line"><a name="l00973"></a><span class="lineno"> 973</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00974"></a><span class="lineno"> 974</span>  <span class="comment">// The d'tor is virtual as we need to subclass Environment.</span></div>
|
|
<div class="line"><a name="l00975"></a><span class="lineno"> 975</span>  <span class="keyword">virtual</span> ~<a class="code" href="classtesting_1_1Environment.html">Environment</a>() {}</div>
|
|
<div class="line"><a name="l00976"></a><span class="lineno"> 976</span> </div>
|
|
<div class="line"><a name="l00977"></a><span class="lineno"> 977</span>  <span class="comment">// Override this to define how to set up the environment.</span></div>
|
|
<div class="line"><a name="l00978"></a><span class="lineno"> 978</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> SetUp() {}</div>
|
|
<div class="line"><a name="l00979"></a><span class="lineno"> 979</span> </div>
|
|
<div class="line"><a name="l00980"></a><span class="lineno"> 980</span>  <span class="comment">// Override this to define how to tear down the environment.</span></div>
|
|
<div class="line"><a name="l00981"></a><span class="lineno"> 981</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> TearDown() {}</div>
|
|
<div class="line"><a name="l00982"></a><span class="lineno"> 982</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l00983"></a><span class="lineno"> 983</span>  <span class="comment">// If you see an error about overriding the following function or</span></div>
|
|
<div class="line"><a name="l00984"></a><span class="lineno"> 984</span>  <span class="comment">// about it being private, you have mis-spelled SetUp() as Setup().</span></div>
|
|
<div class="line"><a name="l00985"></a><span class="lineno"> 985</span>  <span class="keyword">struct </span>Setup_should_be_spelled_SetUp {};</div>
|
|
<div class="line"><a name="l00986"></a><span class="lineno"> 986</span>  <span class="keyword">virtual</span> Setup_should_be_spelled_SetUp* Setup() { <span class="keywordflow">return</span> NULL; }</div>
|
|
<div class="line"><a name="l00987"></a><span class="lineno"> 987</span> };</div>
|
|
<div class="line"><a name="l00988"></a><span class="lineno"> 988</span> </div>
|
|
<div class="line"><a name="l00989"></a><span class="lineno"> 989</span> <span class="comment">// The interface for tracing execution of tests. The methods are organized in</span></div>
|
|
<div class="line"><a name="l00990"></a><span class="lineno"> 990</span> <span class="comment">// the order the corresponding events are fired.</span></div>
|
|
<div class="line"><a name="l00991"></a><span class="lineno"><a class="line" href="classtesting_1_1TestEventListener.html"> 991</a></span> <span class="keyword">class </span><a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a> {</div>
|
|
<div class="line"><a name="l00992"></a><span class="lineno"> 992</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l00993"></a><span class="lineno"> 993</span>  <span class="keyword">virtual</span> ~<a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a>() {}</div>
|
|
<div class="line"><a name="l00994"></a><span class="lineno"> 994</span> </div>
|
|
<div class="line"><a name="l00995"></a><span class="lineno"> 995</span>  <span class="comment">// Fired before any test activity starts.</span></div>
|
|
<div class="line"><a name="l00996"></a><span class="lineno"> 996</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestProgramStart(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& unit_test) = 0;</div>
|
|
<div class="line"><a name="l00997"></a><span class="lineno"> 997</span> </div>
|
|
<div class="line"><a name="l00998"></a><span class="lineno"> 998</span>  <span class="comment">// Fired before each iteration of tests starts. There may be more than</span></div>
|
|
<div class="line"><a name="l00999"></a><span class="lineno"> 999</span>  <span class="comment">// one iteration if GTEST_FLAG(repeat) is set. iteration is the iteration</span></div>
|
|
<div class="line"><a name="l01000"></a><span class="lineno"> 1000</span>  <span class="comment">// index, starting from 0.</span></div>
|
|
<div class="line"><a name="l01001"></a><span class="lineno"> 1001</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestIterationStart(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& unit_test,</div>
|
|
<div class="line"><a name="l01002"></a><span class="lineno"> 1002</span>  <span class="keywordtype">int</span> iteration) = 0;</div>
|
|
<div class="line"><a name="l01003"></a><span class="lineno"> 1003</span> </div>
|
|
<div class="line"><a name="l01004"></a><span class="lineno"> 1004</span>  <span class="comment">// Fired before environment set-up for each iteration of tests starts.</span></div>
|
|
<div class="line"><a name="l01005"></a><span class="lineno"> 1005</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnEnvironmentsSetUpStart(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& unit_test) = 0;</div>
|
|
<div class="line"><a name="l01006"></a><span class="lineno"> 1006</span> </div>
|
|
<div class="line"><a name="l01007"></a><span class="lineno"> 1007</span>  <span class="comment">// Fired after environment set-up for each iteration of tests ends.</span></div>
|
|
<div class="line"><a name="l01008"></a><span class="lineno"> 1008</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnEnvironmentsSetUpEnd(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& unit_test) = 0;</div>
|
|
<div class="line"><a name="l01009"></a><span class="lineno"> 1009</span> </div>
|
|
<div class="line"><a name="l01010"></a><span class="lineno"> 1010</span>  <span class="comment">// Fired before the test case starts.</span></div>
|
|
<div class="line"><a name="l01011"></a><span class="lineno"> 1011</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestCaseStart(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestCase.html">TestCase</a>& test_case) = 0;</div>
|
|
<div class="line"><a name="l01012"></a><span class="lineno"> 1012</span> </div>
|
|
<div class="line"><a name="l01013"></a><span class="lineno"> 1013</span>  <span class="comment">// Fired before the test starts.</span></div>
|
|
<div class="line"><a name="l01014"></a><span class="lineno"> 1014</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestStart(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>& test_info) = 0;</div>
|
|
<div class="line"><a name="l01015"></a><span class="lineno"> 1015</span> </div>
|
|
<div class="line"><a name="l01016"></a><span class="lineno"> 1016</span>  <span class="comment">// Fired after a failed assertion or a SUCCEED() invocation.</span></div>
|
|
<div class="line"><a name="l01017"></a><span class="lineno"> 1017</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestPartResult(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestPartResult.html">TestPartResult</a>& test_part_result) = 0;</div>
|
|
<div class="line"><a name="l01018"></a><span class="lineno"> 1018</span> </div>
|
|
<div class="line"><a name="l01019"></a><span class="lineno"> 1019</span>  <span class="comment">// Fired after the test ends.</span></div>
|
|
<div class="line"><a name="l01020"></a><span class="lineno"> 1020</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestEnd(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>& test_info) = 0;</div>
|
|
<div class="line"><a name="l01021"></a><span class="lineno"> 1021</span> </div>
|
|
<div class="line"><a name="l01022"></a><span class="lineno"> 1022</span>  <span class="comment">// Fired after the test case ends.</span></div>
|
|
<div class="line"><a name="l01023"></a><span class="lineno"> 1023</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestCaseEnd(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestCase.html">TestCase</a>& test_case) = 0;</div>
|
|
<div class="line"><a name="l01024"></a><span class="lineno"> 1024</span> </div>
|
|
<div class="line"><a name="l01025"></a><span class="lineno"> 1025</span>  <span class="comment">// Fired before environment tear-down for each iteration of tests starts.</span></div>
|
|
<div class="line"><a name="l01026"></a><span class="lineno"> 1026</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnEnvironmentsTearDownStart(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& unit_test) = 0;</div>
|
|
<div class="line"><a name="l01027"></a><span class="lineno"> 1027</span> </div>
|
|
<div class="line"><a name="l01028"></a><span class="lineno"> 1028</span>  <span class="comment">// Fired after environment tear-down for each iteration of tests ends.</span></div>
|
|
<div class="line"><a name="l01029"></a><span class="lineno"> 1029</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnEnvironmentsTearDownEnd(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& unit_test) = 0;</div>
|
|
<div class="line"><a name="l01030"></a><span class="lineno"> 1030</span> </div>
|
|
<div class="line"><a name="l01031"></a><span class="lineno"> 1031</span>  <span class="comment">// Fired after each iteration of tests finishes.</span></div>
|
|
<div class="line"><a name="l01032"></a><span class="lineno"> 1032</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestIterationEnd(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& unit_test,</div>
|
|
<div class="line"><a name="l01033"></a><span class="lineno"> 1033</span>  <span class="keywordtype">int</span> iteration) = 0;</div>
|
|
<div class="line"><a name="l01034"></a><span class="lineno"> 1034</span> </div>
|
|
<div class="line"><a name="l01035"></a><span class="lineno"> 1035</span>  <span class="comment">// Fired after all test activities have ended.</span></div>
|
|
<div class="line"><a name="l01036"></a><span class="lineno"> 1036</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestProgramEnd(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& unit_test) = 0;</div>
|
|
<div class="line"><a name="l01037"></a><span class="lineno"> 1037</span> };</div>
|
|
<div class="line"><a name="l01038"></a><span class="lineno"> 1038</span> </div>
|
|
<div class="line"><a name="l01039"></a><span class="lineno"> 1039</span> <span class="comment">// The convenience class for users who need to override just one or two</span></div>
|
|
<div class="line"><a name="l01040"></a><span class="lineno"> 1040</span> <span class="comment">// methods and are not concerned that a possible change to a signature of</span></div>
|
|
<div class="line"><a name="l01041"></a><span class="lineno"> 1041</span> <span class="comment">// the methods they override will not be caught during the build. For</span></div>
|
|
<div class="line"><a name="l01042"></a><span class="lineno"> 1042</span> <span class="comment">// comments about each method please see the definition of TestEventListener</span></div>
|
|
<div class="line"><a name="l01043"></a><span class="lineno"> 1043</span> <span class="comment">// above.</span></div>
|
|
<div class="line"><a name="l01044"></a><span class="lineno"><a class="line" href="classtesting_1_1EmptyTestEventListener.html"> 1044</a></span> <span class="keyword">class </span><a class="code" href="classtesting_1_1EmptyTestEventListener.html">EmptyTestEventListener</a> : <span class="keyword">public</span> <a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a> {</div>
|
|
<div class="line"><a name="l01045"></a><span class="lineno"> 1045</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l01046"></a><span class="lineno"> 1046</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestProgramStart(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& <span class="comment">/*unit_test*/</span>) {}</div>
|
|
<div class="line"><a name="l01047"></a><span class="lineno"> 1047</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestIterationStart(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& <span class="comment">/*unit_test*/</span>,</div>
|
|
<div class="line"><a name="l01048"></a><span class="lineno"> 1048</span>  <span class="keywordtype">int</span> <span class="comment">/*iteration*/</span>) {}</div>
|
|
<div class="line"><a name="l01049"></a><span class="lineno"> 1049</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnEnvironmentsSetUpStart(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& <span class="comment">/*unit_test*/</span>) {}</div>
|
|
<div class="line"><a name="l01050"></a><span class="lineno"> 1050</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnEnvironmentsSetUpEnd(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& <span class="comment">/*unit_test*/</span>) {}</div>
|
|
<div class="line"><a name="l01051"></a><span class="lineno"> 1051</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestCaseStart(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestCase.html">TestCase</a>& <span class="comment">/*test_case*/</span>) {}</div>
|
|
<div class="line"><a name="l01052"></a><span class="lineno"> 1052</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestStart(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>& <span class="comment">/*test_info*/</span>) {}</div>
|
|
<div class="line"><a name="l01053"></a><span class="lineno"> 1053</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestPartResult(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestPartResult.html">TestPartResult</a>& <span class="comment">/*test_part_result*/</span>) {}</div>
|
|
<div class="line"><a name="l01054"></a><span class="lineno"> 1054</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestEnd(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>& <span class="comment">/*test_info*/</span>) {}</div>
|
|
<div class="line"><a name="l01055"></a><span class="lineno"> 1055</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestCaseEnd(<span class="keyword">const</span> <a class="code" href="classtesting_1_1TestCase.html">TestCase</a>& <span class="comment">/*test_case*/</span>) {}</div>
|
|
<div class="line"><a name="l01056"></a><span class="lineno"> 1056</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnEnvironmentsTearDownStart(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& <span class="comment">/*unit_test*/</span>) {}</div>
|
|
<div class="line"><a name="l01057"></a><span class="lineno"> 1057</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnEnvironmentsTearDownEnd(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& <span class="comment">/*unit_test*/</span>) {}</div>
|
|
<div class="line"><a name="l01058"></a><span class="lineno"> 1058</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestIterationEnd(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& <span class="comment">/*unit_test*/</span>,</div>
|
|
<div class="line"><a name="l01059"></a><span class="lineno"> 1059</span>  <span class="keywordtype">int</span> <span class="comment">/*iteration*/</span>) {}</div>
|
|
<div class="line"><a name="l01060"></a><span class="lineno"> 1060</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestProgramEnd(<span class="keyword">const</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>& <span class="comment">/*unit_test*/</span>) {}</div>
|
|
<div class="line"><a name="l01061"></a><span class="lineno"> 1061</span> };</div>
|
|
<div class="line"><a name="l01062"></a><span class="lineno"> 1062</span> </div>
|
|
<div class="line"><a name="l01063"></a><span class="lineno"> 1063</span> <span class="comment">// TestEventListeners lets users add listeners to track events in Google Test.</span></div>
|
|
<div class="line"><a name="l01064"></a><span class="lineno"><a class="line" href="classtesting_1_1TestEventListeners.html"> 1064</a></span> <span class="keyword">class </span>GTEST_API_ <a class="code" href="classtesting_1_1TestEventListeners.html">TestEventListeners</a> {</div>
|
|
<div class="line"><a name="l01065"></a><span class="lineno"> 1065</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l01066"></a><span class="lineno"> 1066</span>  <a class="code" href="classtesting_1_1TestEventListeners.html">TestEventListeners</a>();</div>
|
|
<div class="line"><a name="l01067"></a><span class="lineno"> 1067</span>  ~<a class="code" href="classtesting_1_1TestEventListeners.html">TestEventListeners</a>();</div>
|
|
<div class="line"><a name="l01068"></a><span class="lineno"> 1068</span> </div>
|
|
<div class="line"><a name="l01069"></a><span class="lineno"> 1069</span>  <span class="comment">// Appends an event listener to the end of the list. Google Test assumes</span></div>
|
|
<div class="line"><a name="l01070"></a><span class="lineno"> 1070</span>  <span class="comment">// the ownership of the listener (i.e. it will delete the listener when</span></div>
|
|
<div class="line"><a name="l01071"></a><span class="lineno"> 1071</span>  <span class="comment">// the test program finishes).</span></div>
|
|
<div class="line"><a name="l01072"></a><span class="lineno"> 1072</span>  <span class="keywordtype">void</span> Append(<a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a>* listener);</div>
|
|
<div class="line"><a name="l01073"></a><span class="lineno"> 1073</span> </div>
|
|
<div class="line"><a name="l01074"></a><span class="lineno"> 1074</span>  <span class="comment">// Removes the given event listener from the list and returns it. It then</span></div>
|
|
<div class="line"><a name="l01075"></a><span class="lineno"> 1075</span>  <span class="comment">// becomes the caller's responsibility to delete the listener. Returns</span></div>
|
|
<div class="line"><a name="l01076"></a><span class="lineno"> 1076</span>  <span class="comment">// NULL if the listener is not found in the list.</span></div>
|
|
<div class="line"><a name="l01077"></a><span class="lineno"> 1077</span>  <a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a>* Release(<a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a>* listener);</div>
|
|
<div class="line"><a name="l01078"></a><span class="lineno"> 1078</span> </div>
|
|
<div class="line"><a name="l01079"></a><span class="lineno"> 1079</span>  <span class="comment">// Returns the standard listener responsible for the default console</span></div>
|
|
<div class="line"><a name="l01080"></a><span class="lineno"> 1080</span>  <span class="comment">// output. Can be removed from the listeners list to shut down default</span></div>
|
|
<div class="line"><a name="l01081"></a><span class="lineno"> 1081</span>  <span class="comment">// console output. Note that removing this object from the listener list</span></div>
|
|
<div class="line"><a name="l01082"></a><span class="lineno"> 1082</span>  <span class="comment">// with Release transfers its ownership to the caller and makes this</span></div>
|
|
<div class="line"><a name="l01083"></a><span class="lineno"> 1083</span>  <span class="comment">// function return NULL the next time.</span></div>
|
|
<div class="line"><a name="l01084"></a><span class="lineno"> 1084</span>  <a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a>* default_result_printer()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l01085"></a><span class="lineno"> 1085</span>  <span class="keywordflow">return</span> default_result_printer_;</div>
|
|
<div class="line"><a name="l01086"></a><span class="lineno"> 1086</span>  }</div>
|
|
<div class="line"><a name="l01087"></a><span class="lineno"> 1087</span> </div>
|
|
<div class="line"><a name="l01088"></a><span class="lineno"> 1088</span>  <span class="comment">// Returns the standard listener responsible for the default XML output</span></div>
|
|
<div class="line"><a name="l01089"></a><span class="lineno"> 1089</span>  <span class="comment">// controlled by the --gtest_output=xml flag. Can be removed from the</span></div>
|
|
<div class="line"><a name="l01090"></a><span class="lineno"> 1090</span>  <span class="comment">// listeners list by users who want to shut down the default XML output</span></div>
|
|
<div class="line"><a name="l01091"></a><span class="lineno"> 1091</span>  <span class="comment">// controlled by this flag and substitute it with custom one. Note that</span></div>
|
|
<div class="line"><a name="l01092"></a><span class="lineno"> 1092</span>  <span class="comment">// removing this object from the listener list with Release transfers its</span></div>
|
|
<div class="line"><a name="l01093"></a><span class="lineno"> 1093</span>  <span class="comment">// ownership to the caller and makes this function return NULL the next</span></div>
|
|
<div class="line"><a name="l01094"></a><span class="lineno"> 1094</span>  <span class="comment">// time.</span></div>
|
|
<div class="line"><a name="l01095"></a><span class="lineno"> 1095</span>  <a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a>* default_xml_generator()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l01096"></a><span class="lineno"> 1096</span>  <span class="keywordflow">return</span> default_xml_generator_;</div>
|
|
<div class="line"><a name="l01097"></a><span class="lineno"> 1097</span>  }</div>
|
|
<div class="line"><a name="l01098"></a><span class="lineno"> 1098</span> </div>
|
|
<div class="line"><a name="l01099"></a><span class="lineno"> 1099</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l01100"></a><span class="lineno"> 1100</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1TestCase.html">TestCase</a>;</div>
|
|
<div class="line"><a name="l01101"></a><span class="lineno"> 1101</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>;</div>
|
|
<div class="line"><a name="l01102"></a><span class="lineno"> 1102</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1DefaultGlobalTestPartResultReporter.html">internal::DefaultGlobalTestPartResultReporter</a>;</div>
|
|
<div class="line"><a name="l01103"></a><span class="lineno"> 1103</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::NoExecDeathTest;</div>
|
|
<div class="line"><a name="l01104"></a><span class="lineno"> 1104</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::TestEventListenersAccessor;</div>
|
|
<div class="line"><a name="l01105"></a><span class="lineno"> 1105</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1UnitTestImpl.html">internal::UnitTestImpl</a>;</div>
|
|
<div class="line"><a name="l01106"></a><span class="lineno"> 1106</span> </div>
|
|
<div class="line"><a name="l01107"></a><span class="lineno"> 1107</span>  <span class="comment">// Returns repeater that broadcasts the TestEventListener events to all</span></div>
|
|
<div class="line"><a name="l01108"></a><span class="lineno"> 1108</span>  <span class="comment">// subscribers.</span></div>
|
|
<div class="line"><a name="l01109"></a><span class="lineno"> 1109</span>  <a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a>* repeater();</div>
|
|
<div class="line"><a name="l01110"></a><span class="lineno"> 1110</span> </div>
|
|
<div class="line"><a name="l01111"></a><span class="lineno"> 1111</span>  <span class="comment">// Sets the default_result_printer attribute to the provided listener.</span></div>
|
|
<div class="line"><a name="l01112"></a><span class="lineno"> 1112</span>  <span class="comment">// The listener is also added to the listener list and previous</span></div>
|
|
<div class="line"><a name="l01113"></a><span class="lineno"> 1113</span>  <span class="comment">// default_result_printer is removed from it and deleted. The listener can</span></div>
|
|
<div class="line"><a name="l01114"></a><span class="lineno"> 1114</span>  <span class="comment">// also be NULL in which case it will not be added to the list. Does</span></div>
|
|
<div class="line"><a name="l01115"></a><span class="lineno"> 1115</span>  <span class="comment">// nothing if the previous and the current listener objects are the same.</span></div>
|
|
<div class="line"><a name="l01116"></a><span class="lineno"> 1116</span>  <span class="keywordtype">void</span> SetDefaultResultPrinter(<a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a>* listener);</div>
|
|
<div class="line"><a name="l01117"></a><span class="lineno"> 1117</span> </div>
|
|
<div class="line"><a name="l01118"></a><span class="lineno"> 1118</span>  <span class="comment">// Sets the default_xml_generator attribute to the provided listener. The</span></div>
|
|
<div class="line"><a name="l01119"></a><span class="lineno"> 1119</span>  <span class="comment">// listener is also added to the listener list and previous</span></div>
|
|
<div class="line"><a name="l01120"></a><span class="lineno"> 1120</span>  <span class="comment">// default_xml_generator is removed from it and deleted. The listener can</span></div>
|
|
<div class="line"><a name="l01121"></a><span class="lineno"> 1121</span>  <span class="comment">// also be NULL in which case it will not be added to the list. Does</span></div>
|
|
<div class="line"><a name="l01122"></a><span class="lineno"> 1122</span>  <span class="comment">// nothing if the previous and the current listener objects are the same.</span></div>
|
|
<div class="line"><a name="l01123"></a><span class="lineno"> 1123</span>  <span class="keywordtype">void</span> SetDefaultXmlGenerator(<a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a>* listener);</div>
|
|
<div class="line"><a name="l01124"></a><span class="lineno"> 1124</span> </div>
|
|
<div class="line"><a name="l01125"></a><span class="lineno"> 1125</span>  <span class="comment">// Controls whether events will be forwarded by the repeater to the</span></div>
|
|
<div class="line"><a name="l01126"></a><span class="lineno"> 1126</span>  <span class="comment">// listeners in the list.</span></div>
|
|
<div class="line"><a name="l01127"></a><span class="lineno"> 1127</span>  <span class="keywordtype">bool</span> EventForwardingEnabled() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01128"></a><span class="lineno"> 1128</span>  <span class="keywordtype">void</span> SuppressEventForwarding();</div>
|
|
<div class="line"><a name="l01129"></a><span class="lineno"> 1129</span> </div>
|
|
<div class="line"><a name="l01130"></a><span class="lineno"> 1130</span>  <span class="comment">// The actual list of listeners.</span></div>
|
|
<div class="line"><a name="l01131"></a><span class="lineno"> 1131</span>  internal::TestEventRepeater* repeater_;</div>
|
|
<div class="line"><a name="l01132"></a><span class="lineno"> 1132</span>  <span class="comment">// Listener responsible for the standard result output.</span></div>
|
|
<div class="line"><a name="l01133"></a><span class="lineno"> 1133</span>  <a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a>* default_result_printer_;</div>
|
|
<div class="line"><a name="l01134"></a><span class="lineno"> 1134</span>  <span class="comment">// Listener responsible for the creation of the XML output file.</span></div>
|
|
<div class="line"><a name="l01135"></a><span class="lineno"> 1135</span>  <a class="code" href="classtesting_1_1TestEventListener.html">TestEventListener</a>* default_xml_generator_;</div>
|
|
<div class="line"><a name="l01136"></a><span class="lineno"> 1136</span> </div>
|
|
<div class="line"><a name="l01137"></a><span class="lineno"> 1137</span>  <span class="comment">// We disallow copying TestEventListeners.</span></div>
|
|
<div class="line"><a name="l01138"></a><span class="lineno"> 1138</span>  GTEST_DISALLOW_COPY_AND_ASSIGN_(<a class="code" href="classtesting_1_1TestEventListeners.html">TestEventListeners</a>);</div>
|
|
<div class="line"><a name="l01139"></a><span class="lineno"> 1139</span> };</div>
|
|
<div class="line"><a name="l01140"></a><span class="lineno"> 1140</span> </div>
|
|
<div class="line"><a name="l01141"></a><span class="lineno"> 1141</span> <span class="comment">// A UnitTest consists of a vector of TestCases.</span></div>
|
|
<div class="line"><a name="l01142"></a><span class="lineno"> 1142</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01143"></a><span class="lineno"> 1143</span> <span class="comment">// This is a singleton class. The only instance of UnitTest is</span></div>
|
|
<div class="line"><a name="l01144"></a><span class="lineno"> 1144</span> <span class="comment">// created when UnitTest::GetInstance() is first called. This</span></div>
|
|
<div class="line"><a name="l01145"></a><span class="lineno"> 1145</span> <span class="comment">// instance is never deleted.</span></div>
|
|
<div class="line"><a name="l01146"></a><span class="lineno"> 1146</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01147"></a><span class="lineno"> 1147</span> <span class="comment">// UnitTest is not copyable.</span></div>
|
|
<div class="line"><a name="l01148"></a><span class="lineno"> 1148</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01149"></a><span class="lineno"> 1149</span> <span class="comment">// This class is thread-safe as long as the methods are called</span></div>
|
|
<div class="line"><a name="l01150"></a><span class="lineno"> 1150</span> <span class="comment">// according to their specification.</span></div>
|
|
<div class="line"><a name="l01151"></a><span class="lineno"><a class="line" href="classtesting_1_1UnitTest.html"> 1151</a></span> <span class="keyword">class </span>GTEST_API_ <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a> {</div>
|
|
<div class="line"><a name="l01152"></a><span class="lineno"> 1152</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l01153"></a><span class="lineno"> 1153</span>  <span class="comment">// Gets the singleton UnitTest object. The first time this method</span></div>
|
|
<div class="line"><a name="l01154"></a><span class="lineno"> 1154</span>  <span class="comment">// is called, a UnitTest object is constructed and returned.</span></div>
|
|
<div class="line"><a name="l01155"></a><span class="lineno"> 1155</span>  <span class="comment">// Consecutive calls will return the same object.</span></div>
|
|
<div class="line"><a name="l01156"></a><span class="lineno"> 1156</span>  <span class="keyword">static</span> <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>* GetInstance();</div>
|
|
<div class="line"><a name="l01157"></a><span class="lineno"> 1157</span> </div>
|
|
<div class="line"><a name="l01158"></a><span class="lineno"> 1158</span>  <span class="comment">// Runs all tests in this UnitTest object and prints the result.</span></div>
|
|
<div class="line"><a name="l01159"></a><span class="lineno"> 1159</span>  <span class="comment">// Returns 0 if successful, or 1 otherwise.</span></div>
|
|
<div class="line"><a name="l01160"></a><span class="lineno"> 1160</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01161"></a><span class="lineno"> 1161</span>  <span class="comment">// This method can only be called from the main thread.</span></div>
|
|
<div class="line"><a name="l01162"></a><span class="lineno"> 1162</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01163"></a><span class="lineno"> 1163</span>  <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l01164"></a><span class="lineno"> 1164</span>  <span class="keywordtype">int</span> Run() GTEST_MUST_USE_RESULT_;</div>
|
|
<div class="line"><a name="l01165"></a><span class="lineno"> 1165</span> </div>
|
|
<div class="line"><a name="l01166"></a><span class="lineno"> 1166</span>  <span class="comment">// Returns the working directory when the first TEST() or TEST_F()</span></div>
|
|
<div class="line"><a name="l01167"></a><span class="lineno"> 1167</span>  <span class="comment">// was executed. The UnitTest object owns the string.</span></div>
|
|
<div class="line"><a name="l01168"></a><span class="lineno"> 1168</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* original_working_dir() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01169"></a><span class="lineno"> 1169</span> </div>
|
|
<div class="line"><a name="l01170"></a><span class="lineno"> 1170</span>  <span class="comment">// Returns the TestCase object for the test that's currently running,</span></div>
|
|
<div class="line"><a name="l01171"></a><span class="lineno"> 1171</span>  <span class="comment">// or NULL if no test is running.</span></div>
|
|
<div class="line"><a name="l01172"></a><span class="lineno"> 1172</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1TestCase.html">TestCase</a>* current_test_case() <span class="keyword">const</span></div>
|
|
<div class="line"><a name="l01173"></a><span class="lineno"> 1173</span>  GTEST_LOCK_EXCLUDED_(mutex_);</div>
|
|
<div class="line"><a name="l01174"></a><span class="lineno"> 1174</span> </div>
|
|
<div class="line"><a name="l01175"></a><span class="lineno"> 1175</span>  <span class="comment">// Returns the TestInfo object for the test that's currently running,</span></div>
|
|
<div class="line"><a name="l01176"></a><span class="lineno"> 1176</span>  <span class="comment">// or NULL if no test is running.</span></div>
|
|
<div class="line"><a name="l01177"></a><span class="lineno"> 1177</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1TestInfo.html">TestInfo</a>* current_test_info() <span class="keyword">const</span></div>
|
|
<div class="line"><a name="l01178"></a><span class="lineno"> 1178</span>  GTEST_LOCK_EXCLUDED_(mutex_);</div>
|
|
<div class="line"><a name="l01179"></a><span class="lineno"> 1179</span> </div>
|
|
<div class="line"><a name="l01180"></a><span class="lineno"> 1180</span>  <span class="comment">// Returns the random seed used at the start of the current test run.</span></div>
|
|
<div class="line"><a name="l01181"></a><span class="lineno"> 1181</span>  <span class="keywordtype">int</span> random_seed() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01182"></a><span class="lineno"> 1182</span> </div>
|
|
<div class="line"><a name="l01183"></a><span class="lineno"> 1183</span> <span class="preprocessor">#if GTEST_HAS_PARAM_TEST</span></div>
|
|
<div class="line"><a name="l01184"></a><span class="lineno"> 1184</span> <span class="preprocessor"></span> <span class="comment">// Returns the ParameterizedTestCaseRegistry object used to keep track of</span></div>
|
|
<div class="line"><a name="l01185"></a><span class="lineno"> 1185</span>  <span class="comment">// value-parameterized tests and instantiate and register them.</span></div>
|
|
<div class="line"><a name="l01186"></a><span class="lineno"> 1186</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01187"></a><span class="lineno"> 1187</span>  <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l01188"></a><span class="lineno"> 1188</span>  internal::ParameterizedTestCaseRegistry& parameterized_test_registry()</div>
|
|
<div class="line"><a name="l01189"></a><span class="lineno"> 1189</span>  GTEST_LOCK_EXCLUDED_(mutex_);</div>
|
|
<div class="line"><a name="l01190"></a><span class="lineno"> 1190</span> <span class="preprocessor">#endif // GTEST_HAS_PARAM_TEST</span></div>
|
|
<div class="line"><a name="l01191"></a><span class="lineno"> 1191</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01192"></a><span class="lineno"> 1192</span>  <span class="comment">// Gets the number of successful test cases.</span></div>
|
|
<div class="line"><a name="l01193"></a><span class="lineno"> 1193</span>  <span class="keywordtype">int</span> successful_test_case_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01194"></a><span class="lineno"> 1194</span> </div>
|
|
<div class="line"><a name="l01195"></a><span class="lineno"> 1195</span>  <span class="comment">// Gets the number of failed test cases.</span></div>
|
|
<div class="line"><a name="l01196"></a><span class="lineno"> 1196</span>  <span class="keywordtype">int</span> failed_test_case_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01197"></a><span class="lineno"> 1197</span> </div>
|
|
<div class="line"><a name="l01198"></a><span class="lineno"> 1198</span>  <span class="comment">// Gets the number of all test cases.</span></div>
|
|
<div class="line"><a name="l01199"></a><span class="lineno"> 1199</span>  <span class="keywordtype">int</span> total_test_case_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01200"></a><span class="lineno"> 1200</span> </div>
|
|
<div class="line"><a name="l01201"></a><span class="lineno"> 1201</span>  <span class="comment">// Gets the number of all test cases that contain at least one test</span></div>
|
|
<div class="line"><a name="l01202"></a><span class="lineno"> 1202</span>  <span class="comment">// that should run.</span></div>
|
|
<div class="line"><a name="l01203"></a><span class="lineno"> 1203</span>  <span class="keywordtype">int</span> test_case_to_run_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01204"></a><span class="lineno"> 1204</span> </div>
|
|
<div class="line"><a name="l01205"></a><span class="lineno"> 1205</span>  <span class="comment">// Gets the number of successful tests.</span></div>
|
|
<div class="line"><a name="l01206"></a><span class="lineno"> 1206</span>  <span class="keywordtype">int</span> successful_test_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01207"></a><span class="lineno"> 1207</span> </div>
|
|
<div class="line"><a name="l01208"></a><span class="lineno"> 1208</span>  <span class="comment">// Gets the number of failed tests.</span></div>
|
|
<div class="line"><a name="l01209"></a><span class="lineno"> 1209</span>  <span class="keywordtype">int</span> failed_test_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01210"></a><span class="lineno"> 1210</span> </div>
|
|
<div class="line"><a name="l01211"></a><span class="lineno"> 1211</span>  <span class="comment">// Gets the number of disabled tests that will be reported in the XML report.</span></div>
|
|
<div class="line"><a name="l01212"></a><span class="lineno"> 1212</span>  <span class="keywordtype">int</span> reportable_disabled_test_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01213"></a><span class="lineno"> 1213</span> </div>
|
|
<div class="line"><a name="l01214"></a><span class="lineno"> 1214</span>  <span class="comment">// Gets the number of disabled tests.</span></div>
|
|
<div class="line"><a name="l01215"></a><span class="lineno"> 1215</span>  <span class="keywordtype">int</span> disabled_test_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01216"></a><span class="lineno"> 1216</span> </div>
|
|
<div class="line"><a name="l01217"></a><span class="lineno"> 1217</span>  <span class="comment">// Gets the number of tests to be printed in the XML report.</span></div>
|
|
<div class="line"><a name="l01218"></a><span class="lineno"> 1218</span>  <span class="keywordtype">int</span> reportable_test_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01219"></a><span class="lineno"> 1219</span> </div>
|
|
<div class="line"><a name="l01220"></a><span class="lineno"> 1220</span>  <span class="comment">// Gets the number of all tests.</span></div>
|
|
<div class="line"><a name="l01221"></a><span class="lineno"> 1221</span>  <span class="keywordtype">int</span> total_test_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01222"></a><span class="lineno"> 1222</span> </div>
|
|
<div class="line"><a name="l01223"></a><span class="lineno"> 1223</span>  <span class="comment">// Gets the number of tests that should run.</span></div>
|
|
<div class="line"><a name="l01224"></a><span class="lineno"> 1224</span>  <span class="keywordtype">int</span> test_to_run_count() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01225"></a><span class="lineno"> 1225</span> </div>
|
|
<div class="line"><a name="l01226"></a><span class="lineno"> 1226</span>  <span class="comment">// Gets the time of the test program start, in ms from the start of the</span></div>
|
|
<div class="line"><a name="l01227"></a><span class="lineno"> 1227</span>  <span class="comment">// UNIX epoch.</span></div>
|
|
<div class="line"><a name="l01228"></a><span class="lineno"> 1228</span>  TimeInMillis start_timestamp() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01229"></a><span class="lineno"> 1229</span> </div>
|
|
<div class="line"><a name="l01230"></a><span class="lineno"> 1230</span>  <span class="comment">// Gets the elapsed time, in milliseconds.</span></div>
|
|
<div class="line"><a name="l01231"></a><span class="lineno"> 1231</span>  TimeInMillis elapsed_time() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01232"></a><span class="lineno"> 1232</span> </div>
|
|
<div class="line"><a name="l01233"></a><span class="lineno"> 1233</span>  <span class="comment">// Returns true iff the unit test passed (i.e. all test cases passed).</span></div>
|
|
<div class="line"><a name="l01234"></a><span class="lineno"> 1234</span>  <span class="keywordtype">bool</span> Passed() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01235"></a><span class="lineno"> 1235</span> </div>
|
|
<div class="line"><a name="l01236"></a><span class="lineno"> 1236</span>  <span class="comment">// Returns true iff the unit test failed (i.e. some test case failed</span></div>
|
|
<div class="line"><a name="l01237"></a><span class="lineno"> 1237</span>  <span class="comment">// or something outside of all tests failed).</span></div>
|
|
<div class="line"><a name="l01238"></a><span class="lineno"> 1238</span>  <span class="keywordtype">bool</span> Failed() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01239"></a><span class="lineno"> 1239</span> </div>
|
|
<div class="line"><a name="l01240"></a><span class="lineno"> 1240</span>  <span class="comment">// Gets the i-th test case among all the test cases. i can range from 0 to</span></div>
|
|
<div class="line"><a name="l01241"></a><span class="lineno"> 1241</span>  <span class="comment">// total_test_case_count() - 1. If i is not in that range, returns NULL.</span></div>
|
|
<div class="line"><a name="l01242"></a><span class="lineno"> 1242</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1TestCase.html">TestCase</a>* GetTestCase(<span class="keywordtype">int</span> i) <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01243"></a><span class="lineno"> 1243</span> </div>
|
|
<div class="line"><a name="l01244"></a><span class="lineno"> 1244</span>  <span class="comment">// Returns the TestResult containing information on test failures and</span></div>
|
|
<div class="line"><a name="l01245"></a><span class="lineno"> 1245</span>  <span class="comment">// properties logged outside of individual test cases.</span></div>
|
|
<div class="line"><a name="l01246"></a><span class="lineno"> 1246</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1TestResult.html">TestResult</a>& ad_hoc_test_result() <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01247"></a><span class="lineno"> 1247</span> </div>
|
|
<div class="line"><a name="l01248"></a><span class="lineno"> 1248</span>  <span class="comment">// Returns the list of event listeners that can be used to track events</span></div>
|
|
<div class="line"><a name="l01249"></a><span class="lineno"> 1249</span>  <span class="comment">// inside Google Test.</span></div>
|
|
<div class="line"><a name="l01250"></a><span class="lineno"> 1250</span>  <a class="code" href="classtesting_1_1TestEventListeners.html">TestEventListeners</a>& listeners();</div>
|
|
<div class="line"><a name="l01251"></a><span class="lineno"> 1251</span> </div>
|
|
<div class="line"><a name="l01252"></a><span class="lineno"> 1252</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l01253"></a><span class="lineno"> 1253</span>  <span class="comment">// Registers and returns a global test environment. When a test</span></div>
|
|
<div class="line"><a name="l01254"></a><span class="lineno"> 1254</span>  <span class="comment">// program is run, all global test environments will be set-up in</span></div>
|
|
<div class="line"><a name="l01255"></a><span class="lineno"> 1255</span>  <span class="comment">// the order they were registered. After all tests in the program</span></div>
|
|
<div class="line"><a name="l01256"></a><span class="lineno"> 1256</span>  <span class="comment">// have finished, all global test environments will be torn-down in</span></div>
|
|
<div class="line"><a name="l01257"></a><span class="lineno"> 1257</span>  <span class="comment">// the *reverse* order they were registered.</span></div>
|
|
<div class="line"><a name="l01258"></a><span class="lineno"> 1258</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01259"></a><span class="lineno"> 1259</span>  <span class="comment">// The UnitTest object takes ownership of the given environment.</span></div>
|
|
<div class="line"><a name="l01260"></a><span class="lineno"> 1260</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01261"></a><span class="lineno"> 1261</span>  <span class="comment">// This method can only be called from the main thread.</span></div>
|
|
<div class="line"><a name="l01262"></a><span class="lineno"> 1262</span>  <a class="code" href="classtesting_1_1Environment.html">Environment</a>* AddEnvironment(<a class="code" href="classtesting_1_1Environment.html">Environment</a>* env);</div>
|
|
<div class="line"><a name="l01263"></a><span class="lineno"> 1263</span> </div>
|
|
<div class="line"><a name="l01264"></a><span class="lineno"> 1264</span>  <span class="comment">// Adds a TestPartResult to the current TestResult object. All</span></div>
|
|
<div class="line"><a name="l01265"></a><span class="lineno"> 1265</span>  <span class="comment">// Google Test assertion macros (e.g. ASSERT_TRUE, EXPECT_EQ, etc)</span></div>
|
|
<div class="line"><a name="l01266"></a><span class="lineno"> 1266</span>  <span class="comment">// eventually call this to report their results. The user code</span></div>
|
|
<div class="line"><a name="l01267"></a><span class="lineno"> 1267</span>  <span class="comment">// should use the assertion macros instead of calling this directly.</span></div>
|
|
<div class="line"><a name="l01268"></a><span class="lineno"> 1268</span>  <span class="keywordtype">void</span> AddTestPartResult(TestPartResult::Type result_type,</div>
|
|
<div class="line"><a name="l01269"></a><span class="lineno"> 1269</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* file_name,</div>
|
|
<div class="line"><a name="l01270"></a><span class="lineno"> 1270</span>  <span class="keywordtype">int</span> line_number,</div>
|
|
<div class="line"><a name="l01271"></a><span class="lineno"> 1271</span>  <span class="keyword">const</span> std::string& message,</div>
|
|
<div class="line"><a name="l01272"></a><span class="lineno"> 1272</span>  <span class="keyword">const</span> std::string& os_stack_trace)</div>
|
|
<div class="line"><a name="l01273"></a><span class="lineno"> 1273</span>  GTEST_LOCK_EXCLUDED_(mutex_);</div>
|
|
<div class="line"><a name="l01274"></a><span class="lineno"> 1274</span> </div>
|
|
<div class="line"><a name="l01275"></a><span class="lineno"> 1275</span>  <span class="comment">// Adds a TestProperty to the current TestResult object when invoked from</span></div>
|
|
<div class="line"><a name="l01276"></a><span class="lineno"> 1276</span>  <span class="comment">// inside a test, to current TestCase's ad_hoc_test_result_ when invoked</span></div>
|
|
<div class="line"><a name="l01277"></a><span class="lineno"> 1277</span>  <span class="comment">// from SetUpTestCase or TearDownTestCase, or to the global property set</span></div>
|
|
<div class="line"><a name="l01278"></a><span class="lineno"> 1278</span>  <span class="comment">// when invoked elsewhere. If the result already contains a property with</span></div>
|
|
<div class="line"><a name="l01279"></a><span class="lineno"> 1279</span>  <span class="comment">// the same key, the value will be updated.</span></div>
|
|
<div class="line"><a name="l01280"></a><span class="lineno"> 1280</span>  <span class="keywordtype">void</span> RecordProperty(<span class="keyword">const</span> std::string& key, <span class="keyword">const</span> std::string& value);</div>
|
|
<div class="line"><a name="l01281"></a><span class="lineno"> 1281</span> </div>
|
|
<div class="line"><a name="l01282"></a><span class="lineno"> 1282</span>  <span class="comment">// Gets the i-th test case among all the test cases. i can range from 0 to</span></div>
|
|
<div class="line"><a name="l01283"></a><span class="lineno"> 1283</span>  <span class="comment">// total_test_case_count() - 1. If i is not in that range, returns NULL.</span></div>
|
|
<div class="line"><a name="l01284"></a><span class="lineno"> 1284</span>  <a class="code" href="classtesting_1_1TestCase.html">TestCase</a>* GetMutableTestCase(<span class="keywordtype">int</span> i);</div>
|
|
<div class="line"><a name="l01285"></a><span class="lineno"> 1285</span> </div>
|
|
<div class="line"><a name="l01286"></a><span class="lineno"> 1286</span>  <span class="comment">// Accessors for the implementation object.</span></div>
|
|
<div class="line"><a name="l01287"></a><span class="lineno"> 1287</span>  <a class="code" href="classtesting_1_1internal_1_1UnitTestImpl.html">internal::UnitTestImpl</a>* impl() { <span class="keywordflow">return</span> impl_; }</div>
|
|
<div class="line"><a name="l01288"></a><span class="lineno"> 1288</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1internal_1_1UnitTestImpl.html">internal::UnitTestImpl</a>* impl()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> impl_; }</div>
|
|
<div class="line"><a name="l01289"></a><span class="lineno"> 1289</span> </div>
|
|
<div class="line"><a name="l01290"></a><span class="lineno"> 1290</span>  <span class="comment">// These classes and funcions are friends as they need to access private</span></div>
|
|
<div class="line"><a name="l01291"></a><span class="lineno"> 1291</span>  <span class="comment">// members of UnitTest.</span></div>
|
|
<div class="line"><a name="l01292"></a><span class="lineno"> 1292</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1Test.html">Test</a>;</div>
|
|
<div class="line"><a name="l01293"></a><span class="lineno"> 1293</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1AssertHelper.html">internal::AssertHelper</a>;</div>
|
|
<div class="line"><a name="l01294"></a><span class="lineno"> 1294</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1ScopedTrace.html">internal::ScopedTrace</a>;</div>
|
|
<div class="line"><a name="l01295"></a><span class="lineno"> 1295</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::StreamingListenerTest;</div>
|
|
<div class="line"><a name="l01296"></a><span class="lineno"> 1296</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::UnitTestRecordPropertyTestHelper;</div>
|
|
<div class="line"><a name="l01297"></a><span class="lineno"> 1297</span>  <span class="keyword">friend</span> <a class="code" href="classtesting_1_1Environment.html">Environment</a>* AddGlobalTestEnvironment(<a class="code" href="classtesting_1_1Environment.html">Environment</a>* env);</div>
|
|
<div class="line"><a name="l01298"></a><span class="lineno"> 1298</span>  <span class="keyword">friend</span> <a class="code" href="classtesting_1_1internal_1_1UnitTestImpl.html">internal::UnitTestImpl</a>* internal::GetUnitTestImpl();</div>
|
|
<div class="line"><a name="l01299"></a><span class="lineno"> 1299</span>  <span class="keyword">friend</span> <span class="keywordtype">void</span> internal::ReportFailureInUnknownLocation(</div>
|
|
<div class="line"><a name="l01300"></a><span class="lineno"> 1300</span>  TestPartResult::Type result_type,</div>
|
|
<div class="line"><a name="l01301"></a><span class="lineno"> 1301</span>  <span class="keyword">const</span> std::string& message);</div>
|
|
<div class="line"><a name="l01302"></a><span class="lineno"> 1302</span> </div>
|
|
<div class="line"><a name="l01303"></a><span class="lineno"> 1303</span>  <span class="comment">// Creates an empty UnitTest.</span></div>
|
|
<div class="line"><a name="l01304"></a><span class="lineno"> 1304</span>  <a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>();</div>
|
|
<div class="line"><a name="l01305"></a><span class="lineno"> 1305</span> </div>
|
|
<div class="line"><a name="l01306"></a><span class="lineno"> 1306</span>  <span class="comment">// D'tor</span></div>
|
|
<div class="line"><a name="l01307"></a><span class="lineno"> 1307</span>  <span class="keyword">virtual</span> ~<a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>();</div>
|
|
<div class="line"><a name="l01308"></a><span class="lineno"> 1308</span> </div>
|
|
<div class="line"><a name="l01309"></a><span class="lineno"> 1309</span>  <span class="comment">// Pushes a trace defined by SCOPED_TRACE() on to the per-thread</span></div>
|
|
<div class="line"><a name="l01310"></a><span class="lineno"> 1310</span>  <span class="comment">// Google Test trace stack.</span></div>
|
|
<div class="line"><a name="l01311"></a><span class="lineno"> 1311</span>  <span class="keywordtype">void</span> PushGTestTrace(<span class="keyword">const</span> <a class="code" href="structtesting_1_1internal_1_1TraceInfo.html">internal::TraceInfo</a>& trace)</div>
|
|
<div class="line"><a name="l01312"></a><span class="lineno"> 1312</span>  GTEST_LOCK_EXCLUDED_(mutex_);</div>
|
|
<div class="line"><a name="l01313"></a><span class="lineno"> 1313</span> </div>
|
|
<div class="line"><a name="l01314"></a><span class="lineno"> 1314</span>  <span class="comment">// Pops a trace from the per-thread Google Test trace stack.</span></div>
|
|
<div class="line"><a name="l01315"></a><span class="lineno"> 1315</span>  <span class="keywordtype">void</span> PopGTestTrace()</div>
|
|
<div class="line"><a name="l01316"></a><span class="lineno"> 1316</span>  GTEST_LOCK_EXCLUDED_(mutex_);</div>
|
|
<div class="line"><a name="l01317"></a><span class="lineno"> 1317</span> </div>
|
|
<div class="line"><a name="l01318"></a><span class="lineno"> 1318</span>  <span class="comment">// Protects mutable state in *impl_. This is mutable as some const</span></div>
|
|
<div class="line"><a name="l01319"></a><span class="lineno"> 1319</span>  <span class="comment">// methods need to lock it too.</span></div>
|
|
<div class="line"><a name="l01320"></a><span class="lineno"> 1320</span>  <span class="keyword">mutable</span> <a class="code" href="classtesting_1_1internal_1_1Mutex.html">internal::Mutex</a> mutex_;</div>
|
|
<div class="line"><a name="l01321"></a><span class="lineno"> 1321</span> </div>
|
|
<div class="line"><a name="l01322"></a><span class="lineno"> 1322</span>  <span class="comment">// Opaque implementation object. This field is never changed once</span></div>
|
|
<div class="line"><a name="l01323"></a><span class="lineno"> 1323</span>  <span class="comment">// the object is constructed. We don't mark it as const here, as</span></div>
|
|
<div class="line"><a name="l01324"></a><span class="lineno"> 1324</span>  <span class="comment">// doing so will cause a warning in the constructor of UnitTest.</span></div>
|
|
<div class="line"><a name="l01325"></a><span class="lineno"> 1325</span>  <span class="comment">// Mutable state in *impl_ is protected by mutex_.</span></div>
|
|
<div class="line"><a name="l01326"></a><span class="lineno"> 1326</span>  <a class="code" href="classtesting_1_1internal_1_1UnitTestImpl.html">internal::UnitTestImpl</a>* impl_;</div>
|
|
<div class="line"><a name="l01327"></a><span class="lineno"> 1327</span> </div>
|
|
<div class="line"><a name="l01328"></a><span class="lineno"> 1328</span>  <span class="comment">// We disallow copying UnitTest.</span></div>
|
|
<div class="line"><a name="l01329"></a><span class="lineno"> 1329</span>  GTEST_DISALLOW_COPY_AND_ASSIGN_(<a class="code" href="classtesting_1_1UnitTest.html">UnitTest</a>);</div>
|
|
<div class="line"><a name="l01330"></a><span class="lineno"> 1330</span> };</div>
|
|
<div class="line"><a name="l01331"></a><span class="lineno"> 1331</span> </div>
|
|
<div class="line"><a name="l01332"></a><span class="lineno"> 1332</span> <span class="comment">// A convenient wrapper for adding an environment for the test</span></div>
|
|
<div class="line"><a name="l01333"></a><span class="lineno"> 1333</span> <span class="comment">// program.</span></div>
|
|
<div class="line"><a name="l01334"></a><span class="lineno"> 1334</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01335"></a><span class="lineno"> 1335</span> <span class="comment">// You should call this before RUN_ALL_TESTS() is called, probably in</span></div>
|
|
<div class="line"><a name="l01336"></a><span class="lineno"> 1336</span> <span class="comment">// main(). If you use gtest_main, you need to call this before main()</span></div>
|
|
<div class="line"><a name="l01337"></a><span class="lineno"> 1337</span> <span class="comment">// starts for it to take effect. For example, you can define a global</span></div>
|
|
<div class="line"><a name="l01338"></a><span class="lineno"> 1338</span> <span class="comment">// variable like this:</span></div>
|
|
<div class="line"><a name="l01339"></a><span class="lineno"> 1339</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01340"></a><span class="lineno"> 1340</span> <span class="comment">// testing::Environment* const foo_env =</span></div>
|
|
<div class="line"><a name="l01341"></a><span class="lineno"> 1341</span> <span class="comment">// testing::AddGlobalTestEnvironment(new FooEnvironment);</span></div>
|
|
<div class="line"><a name="l01342"></a><span class="lineno"> 1342</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01343"></a><span class="lineno"> 1343</span> <span class="comment">// However, we strongly recommend you to write your own main() and</span></div>
|
|
<div class="line"><a name="l01344"></a><span class="lineno"> 1344</span> <span class="comment">// call AddGlobalTestEnvironment() there, as relying on initialization</span></div>
|
|
<div class="line"><a name="l01345"></a><span class="lineno"> 1345</span> <span class="comment">// of global variables makes the code harder to read and may cause</span></div>
|
|
<div class="line"><a name="l01346"></a><span class="lineno"> 1346</span> <span class="comment">// problems when you register multiple environments from different</span></div>
|
|
<div class="line"><a name="l01347"></a><span class="lineno"> 1347</span> <span class="comment">// translation units and the environments have dependencies among them</span></div>
|
|
<div class="line"><a name="l01348"></a><span class="lineno"> 1348</span> <span class="comment">// (remember that the compiler doesn't guarantee the order in which</span></div>
|
|
<div class="line"><a name="l01349"></a><span class="lineno"> 1349</span> <span class="comment">// global variables from different translation units are initialized).</span></div>
|
|
<div class="line"><a name="l01350"></a><span class="lineno"> 1350</span> <span class="keyword">inline</span> <a class="code" href="classtesting_1_1Environment.html">Environment</a>* AddGlobalTestEnvironment(<a class="code" href="classtesting_1_1Environment.html">Environment</a>* env) {</div>
|
|
<div class="line"><a name="l01351"></a><span class="lineno"> 1351</span>  <span class="keywordflow">return</span> UnitTest::GetInstance()->AddEnvironment(env);</div>
|
|
<div class="line"><a name="l01352"></a><span class="lineno"> 1352</span> }</div>
|
|
<div class="line"><a name="l01353"></a><span class="lineno"> 1353</span> </div>
|
|
<div class="line"><a name="l01354"></a><span class="lineno"> 1354</span> <span class="comment">// Initializes Google Test. This must be called before calling</span></div>
|
|
<div class="line"><a name="l01355"></a><span class="lineno"> 1355</span> <span class="comment">// RUN_ALL_TESTS(). In particular, it parses a command line for the</span></div>
|
|
<div class="line"><a name="l01356"></a><span class="lineno"> 1356</span> <span class="comment">// flags that Google Test recognizes. Whenever a Google Test flag is</span></div>
|
|
<div class="line"><a name="l01357"></a><span class="lineno"> 1357</span> <span class="comment">// seen, it is removed from argv, and *argc is decremented.</span></div>
|
|
<div class="line"><a name="l01358"></a><span class="lineno"> 1358</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01359"></a><span class="lineno"> 1359</span> <span class="comment">// No value is returned. Instead, the Google Test flag variables are</span></div>
|
|
<div class="line"><a name="l01360"></a><span class="lineno"> 1360</span> <span class="comment">// updated.</span></div>
|
|
<div class="line"><a name="l01361"></a><span class="lineno"> 1361</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01362"></a><span class="lineno"> 1362</span> <span class="comment">// Calling the function for the second time has no user-visible effect.</span></div>
|
|
<div class="line"><a name="l01363"></a><span class="lineno"> 1363</span> GTEST_API_ <span class="keywordtype">void</span> InitGoogleTest(<span class="keywordtype">int</span>* argc, <span class="keywordtype">char</span>** argv);</div>
|
|
<div class="line"><a name="l01364"></a><span class="lineno"> 1364</span> </div>
|
|
<div class="line"><a name="l01365"></a><span class="lineno"> 1365</span> <span class="comment">// This overloaded version can be used in Windows programs compiled in</span></div>
|
|
<div class="line"><a name="l01366"></a><span class="lineno"> 1366</span> <span class="comment">// UNICODE mode.</span></div>
|
|
<div class="line"><a name="l01367"></a><span class="lineno"> 1367</span> GTEST_API_ <span class="keywordtype">void</span> InitGoogleTest(<span class="keywordtype">int</span>* argc, <span class="keywordtype">wchar_t</span>** argv);</div>
|
|
<div class="line"><a name="l01368"></a><span class="lineno"> 1368</span> </div>
|
|
<div class="line"><a name="l01369"></a><span class="lineno"> 1369</span> <span class="keyword">namespace </span>internal {</div>
|
|
<div class="line"><a name="l01370"></a><span class="lineno"> 1370</span> </div>
|
|
<div class="line"><a name="l01371"></a><span class="lineno"> 1371</span> <span class="comment">// Separate the error generating code from the code path to reduce the stack</span></div>
|
|
<div class="line"><a name="l01372"></a><span class="lineno"> 1372</span> <span class="comment">// frame size of CmpHelperEQ. This helps reduce the overhead of some sanitizers</span></div>
|
|
<div class="line"><a name="l01373"></a><span class="lineno"> 1373</span> <span class="comment">// when calling EXPECT_* in a tight loop.</span></div>
|
|
<div class="line"><a name="l01374"></a><span class="lineno"> 1374</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T1, <span class="keyword">typename</span> T2></div>
|
|
<div class="line"><a name="l01375"></a><span class="lineno"> 1375</span> AssertionResult CmpHelperEQFailure(<span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression,</div>
|
|
<div class="line"><a name="l01376"></a><span class="lineno"> 1376</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression,</div>
|
|
<div class="line"><a name="l01377"></a><span class="lineno"> 1377</span>  <span class="keyword">const</span> T1& lhs, <span class="keyword">const</span> T2& rhs) {</div>
|
|
<div class="line"><a name="l01378"></a><span class="lineno"> 1378</span>  <span class="keywordflow">return</span> EqFailure(lhs_expression,</div>
|
|
<div class="line"><a name="l01379"></a><span class="lineno"> 1379</span>  rhs_expression,</div>
|
|
<div class="line"><a name="l01380"></a><span class="lineno"> 1380</span>  FormatForComparisonFailureMessage(lhs, rhs),</div>
|
|
<div class="line"><a name="l01381"></a><span class="lineno"> 1381</span>  FormatForComparisonFailureMessage(rhs, lhs),</div>
|
|
<div class="line"><a name="l01382"></a><span class="lineno"> 1382</span>  <span class="keyword">false</span>);</div>
|
|
<div class="line"><a name="l01383"></a><span class="lineno"> 1383</span> }</div>
|
|
<div class="line"><a name="l01384"></a><span class="lineno"> 1384</span> </div>
|
|
<div class="line"><a name="l01385"></a><span class="lineno"> 1385</span> <span class="comment">// The helper function for {ASSERT|EXPECT}_EQ.</span></div>
|
|
<div class="line"><a name="l01386"></a><span class="lineno"> 1386</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T1, <span class="keyword">typename</span> T2></div>
|
|
<div class="line"><a name="l01387"></a><span class="lineno"> 1387</span> AssertionResult CmpHelperEQ(<span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression,</div>
|
|
<div class="line"><a name="l01388"></a><span class="lineno"> 1388</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression,</div>
|
|
<div class="line"><a name="l01389"></a><span class="lineno"> 1389</span>  <span class="keyword">const</span> T1& lhs,</div>
|
|
<div class="line"><a name="l01390"></a><span class="lineno"> 1390</span>  <span class="keyword">const</span> T2& rhs) {</div>
|
|
<div class="line"><a name="l01391"></a><span class="lineno"> 1391</span> GTEST_DISABLE_MSC_WARNINGS_PUSH_(4389 <span class="comment">/* signed/unsigned mismatch */</span>)</div>
|
|
<div class="line"><a name="l01392"></a><span class="lineno"> 1392</span>  if (lhs == rhs) {</div>
|
|
<div class="line"><a name="l01393"></a><span class="lineno"> 1393</span>  <span class="keywordflow">return</span> AssertionSuccess();</div>
|
|
<div class="line"><a name="l01394"></a><span class="lineno"> 1394</span>  }</div>
|
|
<div class="line"><a name="l01395"></a><span class="lineno"> 1395</span> GTEST_DISABLE_MSC_WARNINGS_POP_()</div>
|
|
<div class="line"><a name="l01396"></a><span class="lineno"> 1396</span> </div>
|
|
<div class="line"><a name="l01397"></a><span class="lineno"> 1397</span>  return CmpHelperEQFailure(lhs_expression, rhs_expression, lhs, rhs);</div>
|
|
<div class="line"><a name="l01398"></a><span class="lineno"> 1398</span> }</div>
|
|
<div class="line"><a name="l01399"></a><span class="lineno"> 1399</span> </div>
|
|
<div class="line"><a name="l01400"></a><span class="lineno"> 1400</span> <span class="comment">// With this overloaded version, we allow anonymous enums to be used</span></div>
|
|
<div class="line"><a name="l01401"></a><span class="lineno"> 1401</span> <span class="comment">// in {ASSERT|EXPECT}_EQ when compiled with gcc 4, as anonymous enums</span></div>
|
|
<div class="line"><a name="l01402"></a><span class="lineno"> 1402</span> <span class="comment">// can be implicitly cast to BiggestInt.</span></div>
|
|
<div class="line"><a name="l01403"></a><span class="lineno"> 1403</span> GTEST_API_ AssertionResult CmpHelperEQ(const <span class="keywordtype">char</span>* lhs_expression,</div>
|
|
<div class="line"><a name="l01404"></a><span class="lineno"> 1404</span>  const <span class="keywordtype">char</span>* rhs_expression,</div>
|
|
<div class="line"><a name="l01405"></a><span class="lineno"> 1405</span>  BiggestInt lhs,</div>
|
|
<div class="line"><a name="l01406"></a><span class="lineno"> 1406</span>  BiggestInt rhs);</div>
|
|
<div class="line"><a name="l01407"></a><span class="lineno"> 1407</span> </div>
|
|
<div class="line"><a name="l01408"></a><span class="lineno"> 1408</span> <span class="comment">// The helper class for {ASSERT|EXPECT}_EQ. The template argument</span></div>
|
|
<div class="line"><a name="l01409"></a><span class="lineno"> 1409</span> <span class="comment">// lhs_is_null_literal is true iff the first argument to ASSERT_EQ()</span></div>
|
|
<div class="line"><a name="l01410"></a><span class="lineno"> 1410</span> <span class="comment">// is a null pointer literal. The following default implementation is</span></div>
|
|
<div class="line"><a name="l01411"></a><span class="lineno"> 1411</span> <span class="comment">// for lhs_is_null_literal being false.</span></div>
|
|
<div class="line"><a name="l01412"></a><span class="lineno"> 1412</span> template <<span class="keywordtype">bool</span> lhs_is_null_literal></div>
|
|
<div class="line"><a name="l01413"></a><span class="lineno"><a class="line" href="classtesting_1_1internal_1_1EqHelper.html"> 1413</a></span> class <a class="code" href="classtesting_1_1internal_1_1EqHelper.html">EqHelper</a> {</div>
|
|
<div class="line"><a name="l01414"></a><span class="lineno"> 1414</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l01415"></a><span class="lineno"> 1415</span>  <span class="comment">// This templatized version is for the general case.</span></div>
|
|
<div class="line"><a name="l01416"></a><span class="lineno"> 1416</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T1, <span class="keyword">typename</span> T2></div>
|
|
<div class="line"><a name="l01417"></a><span class="lineno"> 1417</span>  <span class="keyword">static</span> <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> Compare(<span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression,</div>
|
|
<div class="line"><a name="l01418"></a><span class="lineno"> 1418</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression,</div>
|
|
<div class="line"><a name="l01419"></a><span class="lineno"> 1419</span>  <span class="keyword">const</span> T1& lhs,</div>
|
|
<div class="line"><a name="l01420"></a><span class="lineno"> 1420</span>  <span class="keyword">const</span> T2& rhs) {</div>
|
|
<div class="line"><a name="l01421"></a><span class="lineno"> 1421</span>  <span class="keywordflow">return</span> CmpHelperEQ(lhs_expression, rhs_expression, lhs, rhs);</div>
|
|
<div class="line"><a name="l01422"></a><span class="lineno"> 1422</span>  }</div>
|
|
<div class="line"><a name="l01423"></a><span class="lineno"> 1423</span> </div>
|
|
<div class="line"><a name="l01424"></a><span class="lineno"> 1424</span>  <span class="comment">// With this overloaded version, we allow anonymous enums to be used</span></div>
|
|
<div class="line"><a name="l01425"></a><span class="lineno"> 1425</span>  <span class="comment">// in {ASSERT|EXPECT}_EQ when compiled with gcc 4, as anonymous</span></div>
|
|
<div class="line"><a name="l01426"></a><span class="lineno"> 1426</span>  <span class="comment">// enums can be implicitly cast to BiggestInt.</span></div>
|
|
<div class="line"><a name="l01427"></a><span class="lineno"> 1427</span>  <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01428"></a><span class="lineno"> 1428</span>  <span class="comment">// Even though its body looks the same as the above version, we</span></div>
|
|
<div class="line"><a name="l01429"></a><span class="lineno"> 1429</span>  <span class="comment">// cannot merge the two, as it will make anonymous enums unhappy.</span></div>
|
|
<div class="line"><a name="l01430"></a><span class="lineno"> 1430</span>  <span class="keyword">static</span> <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> Compare(<span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression,</div>
|
|
<div class="line"><a name="l01431"></a><span class="lineno"> 1431</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression,</div>
|
|
<div class="line"><a name="l01432"></a><span class="lineno"> 1432</span>  BiggestInt lhs,</div>
|
|
<div class="line"><a name="l01433"></a><span class="lineno"> 1433</span>  BiggestInt rhs) {</div>
|
|
<div class="line"><a name="l01434"></a><span class="lineno"> 1434</span>  <span class="keywordflow">return</span> CmpHelperEQ(lhs_expression, rhs_expression, lhs, rhs);</div>
|
|
<div class="line"><a name="l01435"></a><span class="lineno"> 1435</span>  }</div>
|
|
<div class="line"><a name="l01436"></a><span class="lineno"> 1436</span> };</div>
|
|
<div class="line"><a name="l01437"></a><span class="lineno"> 1437</span> </div>
|
|
<div class="line"><a name="l01438"></a><span class="lineno"> 1438</span> <span class="comment">// This specialization is used when the first argument to ASSERT_EQ()</span></div>
|
|
<div class="line"><a name="l01439"></a><span class="lineno"> 1439</span> <span class="comment">// is a null pointer literal, like NULL, false, or 0.</span></div>
|
|
<div class="line"><a name="l01440"></a><span class="lineno"> 1440</span> <span class="keyword">template</span> <></div>
|
|
<div class="line"><a name="l01441"></a><span class="lineno"><a class="line" href="classtesting_1_1internal_1_1EqHelper_3_01true_01_4.html"> 1441</a></span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1EqHelper.html">EqHelper</a><true> {</div>
|
|
<div class="line"><a name="l01442"></a><span class="lineno"> 1442</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l01443"></a><span class="lineno"> 1443</span>  <span class="comment">// We define two overloaded versions of Compare(). The first</span></div>
|
|
<div class="line"><a name="l01444"></a><span class="lineno"> 1444</span>  <span class="comment">// version will be picked when the second argument to ASSERT_EQ() is</span></div>
|
|
<div class="line"><a name="l01445"></a><span class="lineno"> 1445</span>  <span class="comment">// NOT a pointer, e.g. ASSERT_EQ(0, AnIntFunction()) or</span></div>
|
|
<div class="line"><a name="l01446"></a><span class="lineno"> 1446</span>  <span class="comment">// EXPECT_EQ(false, a_bool).</span></div>
|
|
<div class="line"><a name="l01447"></a><span class="lineno"> 1447</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T1, <span class="keyword">typename</span> T2></div>
|
|
<div class="line"><a name="l01448"></a><span class="lineno"> 1448</span>  <span class="keyword">static</span> <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> Compare(</div>
|
|
<div class="line"><a name="l01449"></a><span class="lineno"> 1449</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression,</div>
|
|
<div class="line"><a name="l01450"></a><span class="lineno"> 1450</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression,</div>
|
|
<div class="line"><a name="l01451"></a><span class="lineno"> 1451</span>  <span class="keyword">const</span> T1& lhs,</div>
|
|
<div class="line"><a name="l01452"></a><span class="lineno"> 1452</span>  <span class="keyword">const</span> T2& rhs,</div>
|
|
<div class="line"><a name="l01453"></a><span class="lineno"> 1453</span>  <span class="comment">// The following line prevents this overload from being considered if T2</span></div>
|
|
<div class="line"><a name="l01454"></a><span class="lineno"> 1454</span>  <span class="comment">// is not a pointer type. We need this because ASSERT_EQ(NULL, my_ptr)</span></div>
|
|
<div class="line"><a name="l01455"></a><span class="lineno"> 1455</span>  <span class="comment">// expands to Compare("", "", NULL, my_ptr), which requires a conversion</span></div>
|
|
<div class="line"><a name="l01456"></a><span class="lineno"> 1456</span>  <span class="comment">// to match the Secret* in the other overload, which would otherwise make</span></div>
|
|
<div class="line"><a name="l01457"></a><span class="lineno"> 1457</span>  <span class="comment">// this template match better.</span></div>
|
|
<div class="line"><a name="l01458"></a><span class="lineno"> 1458</span>  <span class="keyword">typename</span> <a class="code" href="structtesting_1_1internal_1_1EnableIf.html">EnableIf</a><!<a class="code" href="structtesting_1_1internal_1_1is__pointer.html">is_pointer<T2>::value</a>>::type* = 0) {</div>
|
|
<div class="line"><a name="l01459"></a><span class="lineno"> 1459</span>  <span class="keywordflow">return</span> CmpHelperEQ(lhs_expression, rhs_expression, lhs, rhs);</div>
|
|
<div class="line"><a name="l01460"></a><span class="lineno"> 1460</span>  }</div>
|
|
<div class="line"><a name="l01461"></a><span class="lineno"> 1461</span> </div>
|
|
<div class="line"><a name="l01462"></a><span class="lineno"> 1462</span>  <span class="comment">// This version will be picked when the second argument to ASSERT_EQ() is a</span></div>
|
|
<div class="line"><a name="l01463"></a><span class="lineno"> 1463</span>  <span class="comment">// pointer, e.g. ASSERT_EQ(NULL, a_pointer).</span></div>
|
|
<div class="line"><a name="l01464"></a><span class="lineno"> 1464</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
|
|
<div class="line"><a name="l01465"></a><span class="lineno"> 1465</span>  <span class="keyword">static</span> <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> Compare(</div>
|
|
<div class="line"><a name="l01466"></a><span class="lineno"> 1466</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression,</div>
|
|
<div class="line"><a name="l01467"></a><span class="lineno"> 1467</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression,</div>
|
|
<div class="line"><a name="l01468"></a><span class="lineno"> 1468</span>  <span class="comment">// We used to have a second template parameter instead of Secret*. That</span></div>
|
|
<div class="line"><a name="l01469"></a><span class="lineno"> 1469</span>  <span class="comment">// template parameter would deduce to 'long', making this a better match</span></div>
|
|
<div class="line"><a name="l01470"></a><span class="lineno"> 1470</span>  <span class="comment">// than the first overload even without the first overload's EnableIf.</span></div>
|
|
<div class="line"><a name="l01471"></a><span class="lineno"> 1471</span>  <span class="comment">// Unfortunately, gcc with -Wconversion-null warns when "passing NULL to</span></div>
|
|
<div class="line"><a name="l01472"></a><span class="lineno"> 1472</span>  <span class="comment">// non-pointer argument" (even a deduced integral argument), so the old</span></div>
|
|
<div class="line"><a name="l01473"></a><span class="lineno"> 1473</span>  <span class="comment">// implementation caused warnings in user code.</span></div>
|
|
<div class="line"><a name="l01474"></a><span class="lineno"> 1474</span>  Secret* <span class="comment">/* lhs (NULL) */</span>,</div>
|
|
<div class="line"><a name="l01475"></a><span class="lineno"> 1475</span>  T* rhs) {</div>
|
|
<div class="line"><a name="l01476"></a><span class="lineno"> 1476</span>  <span class="comment">// We already know that 'lhs' is a null pointer.</span></div>
|
|
<div class="line"><a name="l01477"></a><span class="lineno"> 1477</span>  <span class="keywordflow">return</span> CmpHelperEQ(lhs_expression, rhs_expression,</div>
|
|
<div class="line"><a name="l01478"></a><span class="lineno"> 1478</span>  static_cast<T*>(NULL), rhs);</div>
|
|
<div class="line"><a name="l01479"></a><span class="lineno"> 1479</span>  }</div>
|
|
<div class="line"><a name="l01480"></a><span class="lineno"> 1480</span> };</div>
|
|
<div class="line"><a name="l01481"></a><span class="lineno"> 1481</span> </div>
|
|
<div class="line"><a name="l01482"></a><span class="lineno"> 1482</span> <span class="comment">// Separate the error generating code from the code path to reduce the stack</span></div>
|
|
<div class="line"><a name="l01483"></a><span class="lineno"> 1483</span> <span class="comment">// frame size of CmpHelperOP. This helps reduce the overhead of some sanitizers</span></div>
|
|
<div class="line"><a name="l01484"></a><span class="lineno"> 1484</span> <span class="comment">// when calling EXPECT_OP in a tight loop.</span></div>
|
|
<div class="line"><a name="l01485"></a><span class="lineno"> 1485</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T1, <span class="keyword">typename</span> T2></div>
|
|
<div class="line"><a name="l01486"></a><span class="lineno"> 1486</span> <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> CmpHelperOpFailure(<span class="keyword">const</span> <span class="keywordtype">char</span>* expr1, <span class="keyword">const</span> <span class="keywordtype">char</span>* expr2,</div>
|
|
<div class="line"><a name="l01487"></a><span class="lineno"> 1487</span>  <span class="keyword">const</span> T1& val1, <span class="keyword">const</span> T2& val2,</div>
|
|
<div class="line"><a name="l01488"></a><span class="lineno"> 1488</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* op) {</div>
|
|
<div class="line"><a name="l01489"></a><span class="lineno"> 1489</span>  <span class="keywordflow">return</span> AssertionFailure()</div>
|
|
<div class="line"><a name="l01490"></a><span class="lineno"> 1490</span>  << <span class="stringliteral">"Expected: ("</span> << expr1 << <span class="stringliteral">") "</span> << op << <span class="stringliteral">" ("</span> << expr2</div>
|
|
<div class="line"><a name="l01491"></a><span class="lineno"> 1491</span>  << <span class="stringliteral">"), actual: "</span> << FormatForComparisonFailureMessage(val1, val2)</div>
|
|
<div class="line"><a name="l01492"></a><span class="lineno"> 1492</span>  << <span class="stringliteral">" vs "</span> << FormatForComparisonFailureMessage(val2, val1);</div>
|
|
<div class="line"><a name="l01493"></a><span class="lineno"> 1493</span> }</div>
|
|
<div class="line"><a name="l01494"></a><span class="lineno"> 1494</span> </div>
|
|
<div class="line"><a name="l01495"></a><span class="lineno"> 1495</span> <span class="comment">// A macro for implementing the helper functions needed to implement</span></div>
|
|
<div class="line"><a name="l01496"></a><span class="lineno"> 1496</span> <span class="comment">// ASSERT_?? and EXPECT_??. It is here just to avoid copy-and-paste</span></div>
|
|
<div class="line"><a name="l01497"></a><span class="lineno"> 1497</span> <span class="comment">// of similar code.</span></div>
|
|
<div class="line"><a name="l01498"></a><span class="lineno"> 1498</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01499"></a><span class="lineno"> 1499</span> <span class="comment">// For each templatized helper function, we also define an overloaded</span></div>
|
|
<div class="line"><a name="l01500"></a><span class="lineno"> 1500</span> <span class="comment">// version for BiggestInt in order to reduce code bloat and allow</span></div>
|
|
<div class="line"><a name="l01501"></a><span class="lineno"> 1501</span> <span class="comment">// anonymous enums to be used with {ASSERT|EXPECT}_?? when compiled</span></div>
|
|
<div class="line"><a name="l01502"></a><span class="lineno"> 1502</span> <span class="comment">// with gcc 4.</span></div>
|
|
<div class="line"><a name="l01503"></a><span class="lineno"> 1503</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01504"></a><span class="lineno"> 1504</span> <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l01505"></a><span class="lineno"> 1505</span> </div>
|
|
<div class="line"><a name="l01506"></a><span class="lineno"> 1506</span> <span class="preprocessor">#define GTEST_IMPL_CMP_HELPER_(op_name, op)\</span></div>
|
|
<div class="line"><a name="l01507"></a><span class="lineno"> 1507</span> <span class="preprocessor">template <typename T1, typename T2>\</span></div>
|
|
<div class="line"><a name="l01508"></a><span class="lineno"> 1508</span> <span class="preprocessor">AssertionResult CmpHelper##op_name(const char* expr1, const char* expr2, \</span></div>
|
|
<div class="line"><a name="l01509"></a><span class="lineno"> 1509</span> <span class="preprocessor"> const T1& val1, const T2& val2) {\</span></div>
|
|
<div class="line"><a name="l01510"></a><span class="lineno"> 1510</span> <span class="preprocessor"> if (val1 op val2) {\</span></div>
|
|
<div class="line"><a name="l01511"></a><span class="lineno"> 1511</span> <span class="preprocessor"> return AssertionSuccess();\</span></div>
|
|
<div class="line"><a name="l01512"></a><span class="lineno"> 1512</span> <span class="preprocessor"> } else {\</span></div>
|
|
<div class="line"><a name="l01513"></a><span class="lineno"> 1513</span> <span class="preprocessor"> return CmpHelperOpFailure(expr1, expr2, val1, val2, #op);\</span></div>
|
|
<div class="line"><a name="l01514"></a><span class="lineno"> 1514</span> <span class="preprocessor"> }\</span></div>
|
|
<div class="line"><a name="l01515"></a><span class="lineno"> 1515</span> <span class="preprocessor">}\</span></div>
|
|
<div class="line"><a name="l01516"></a><span class="lineno"> 1516</span> <span class="preprocessor">GTEST_API_ AssertionResult CmpHelper##op_name(\</span></div>
|
|
<div class="line"><a name="l01517"></a><span class="lineno"> 1517</span> <span class="preprocessor"> const char* expr1, const char* expr2, BiggestInt val1, BiggestInt val2)</span></div>
|
|
<div class="line"><a name="l01518"></a><span class="lineno"> 1518</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01519"></a><span class="lineno"> 1519</span> <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l01520"></a><span class="lineno"> 1520</span> </div>
|
|
<div class="line"><a name="l01521"></a><span class="lineno"> 1521</span> <span class="comment">// Implements the helper function for {ASSERT|EXPECT}_NE</span></div>
|
|
<div class="line"><a name="l01522"></a><span class="lineno"> 1522</span> GTEST_IMPL_CMP_HELPER_(NE, !=);</div>
|
|
<div class="line"><a name="l01523"></a><span class="lineno"> 1523</span> <span class="comment">// Implements the helper function for {ASSERT|EXPECT}_LE</span></div>
|
|
<div class="line"><a name="l01524"></a><span class="lineno"> 1524</span> GTEST_IMPL_CMP_HELPER_(LE, <=);</div>
|
|
<div class="line"><a name="l01525"></a><span class="lineno"> 1525</span> <span class="comment">// Implements the helper function for {ASSERT|EXPECT}_LT</span></div>
|
|
<div class="line"><a name="l01526"></a><span class="lineno"> 1526</span> GTEST_IMPL_CMP_HELPER_(LT, <);</div>
|
|
<div class="line"><a name="l01527"></a><span class="lineno"> 1527</span> <span class="comment">// Implements the helper function for {ASSERT|EXPECT}_GE</span></div>
|
|
<div class="line"><a name="l01528"></a><span class="lineno"> 1528</span> GTEST_IMPL_CMP_HELPER_(GE, >=);</div>
|
|
<div class="line"><a name="l01529"></a><span class="lineno"> 1529</span> <span class="comment">// Implements the helper function for {ASSERT|EXPECT}_GT</span></div>
|
|
<div class="line"><a name="l01530"></a><span class="lineno"> 1530</span> GTEST_IMPL_CMP_HELPER_(GT, >);</div>
|
|
<div class="line"><a name="l01531"></a><span class="lineno"> 1531</span> </div>
|
|
<div class="line"><a name="l01532"></a><span class="lineno"> 1532</span> <span class="preprocessor">#undef GTEST_IMPL_CMP_HELPER_</span></div>
|
|
<div class="line"><a name="l01533"></a><span class="lineno"> 1533</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01534"></a><span class="lineno"> 1534</span> <span class="comment">// The helper function for {ASSERT|EXPECT}_STREQ.</span></div>
|
|
<div class="line"><a name="l01535"></a><span class="lineno"> 1535</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01536"></a><span class="lineno"> 1536</span> <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l01537"></a><span class="lineno"> 1537</span> GTEST_API_ <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> CmpHelperSTREQ(<span class="keyword">const</span> <span class="keywordtype">char</span>* s1_expression,</div>
|
|
<div class="line"><a name="l01538"></a><span class="lineno"> 1538</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s2_expression,</div>
|
|
<div class="line"><a name="l01539"></a><span class="lineno"> 1539</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s1,</div>
|
|
<div class="line"><a name="l01540"></a><span class="lineno"> 1540</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s2);</div>
|
|
<div class="line"><a name="l01541"></a><span class="lineno"> 1541</span> </div>
|
|
<div class="line"><a name="l01542"></a><span class="lineno"> 1542</span> <span class="comment">// The helper function for {ASSERT|EXPECT}_STRCASEEQ.</span></div>
|
|
<div class="line"><a name="l01543"></a><span class="lineno"> 1543</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01544"></a><span class="lineno"> 1544</span> <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l01545"></a><span class="lineno"> 1545</span> GTEST_API_ <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> CmpHelperSTRCASEEQ(<span class="keyword">const</span> <span class="keywordtype">char</span>* s1_expression,</div>
|
|
<div class="line"><a name="l01546"></a><span class="lineno"> 1546</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s2_expression,</div>
|
|
<div class="line"><a name="l01547"></a><span class="lineno"> 1547</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s1,</div>
|
|
<div class="line"><a name="l01548"></a><span class="lineno"> 1548</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s2);</div>
|
|
<div class="line"><a name="l01549"></a><span class="lineno"> 1549</span> </div>
|
|
<div class="line"><a name="l01550"></a><span class="lineno"> 1550</span> <span class="comment">// The helper function for {ASSERT|EXPECT}_STRNE.</span></div>
|
|
<div class="line"><a name="l01551"></a><span class="lineno"> 1551</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01552"></a><span class="lineno"> 1552</span> <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l01553"></a><span class="lineno"> 1553</span> GTEST_API_ <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> CmpHelperSTRNE(<span class="keyword">const</span> <span class="keywordtype">char</span>* s1_expression,</div>
|
|
<div class="line"><a name="l01554"></a><span class="lineno"> 1554</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s2_expression,</div>
|
|
<div class="line"><a name="l01555"></a><span class="lineno"> 1555</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s1,</div>
|
|
<div class="line"><a name="l01556"></a><span class="lineno"> 1556</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s2);</div>
|
|
<div class="line"><a name="l01557"></a><span class="lineno"> 1557</span> </div>
|
|
<div class="line"><a name="l01558"></a><span class="lineno"> 1558</span> <span class="comment">// The helper function for {ASSERT|EXPECT}_STRCASENE.</span></div>
|
|
<div class="line"><a name="l01559"></a><span class="lineno"> 1559</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01560"></a><span class="lineno"> 1560</span> <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l01561"></a><span class="lineno"> 1561</span> GTEST_API_ <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> CmpHelperSTRCASENE(<span class="keyword">const</span> <span class="keywordtype">char</span>* s1_expression,</div>
|
|
<div class="line"><a name="l01562"></a><span class="lineno"> 1562</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s2_expression,</div>
|
|
<div class="line"><a name="l01563"></a><span class="lineno"> 1563</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s1,</div>
|
|
<div class="line"><a name="l01564"></a><span class="lineno"> 1564</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s2);</div>
|
|
<div class="line"><a name="l01565"></a><span class="lineno"> 1565</span> </div>
|
|
<div class="line"><a name="l01566"></a><span class="lineno"> 1566</span> </div>
|
|
<div class="line"><a name="l01567"></a><span class="lineno"> 1567</span> <span class="comment">// Helper function for *_STREQ on wide strings.</span></div>
|
|
<div class="line"><a name="l01568"></a><span class="lineno"> 1568</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01569"></a><span class="lineno"> 1569</span> <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l01570"></a><span class="lineno"> 1570</span> GTEST_API_ <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> CmpHelperSTREQ(<span class="keyword">const</span> <span class="keywordtype">char</span>* s1_expression,</div>
|
|
<div class="line"><a name="l01571"></a><span class="lineno"> 1571</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s2_expression,</div>
|
|
<div class="line"><a name="l01572"></a><span class="lineno"> 1572</span>  <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* s1,</div>
|
|
<div class="line"><a name="l01573"></a><span class="lineno"> 1573</span>  <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* s2);</div>
|
|
<div class="line"><a name="l01574"></a><span class="lineno"> 1574</span> </div>
|
|
<div class="line"><a name="l01575"></a><span class="lineno"> 1575</span> <span class="comment">// Helper function for *_STRNE on wide strings.</span></div>
|
|
<div class="line"><a name="l01576"></a><span class="lineno"> 1576</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01577"></a><span class="lineno"> 1577</span> <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l01578"></a><span class="lineno"> 1578</span> GTEST_API_ <a class="code" href="classtesting_1_1AssertionResult.html">AssertionResult</a> CmpHelperSTRNE(<span class="keyword">const</span> <span class="keywordtype">char</span>* s1_expression,</div>
|
|
<div class="line"><a name="l01579"></a><span class="lineno"> 1579</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* s2_expression,</div>
|
|
<div class="line"><a name="l01580"></a><span class="lineno"> 1580</span>  <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* s1,</div>
|
|
<div class="line"><a name="l01581"></a><span class="lineno"> 1581</span>  <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* s2);</div>
|
|
<div class="line"><a name="l01582"></a><span class="lineno"> 1582</span> </div>
|
|
<div class="line"><a name="l01583"></a><span class="lineno"> 1583</span> } <span class="comment">// namespace internal</span></div>
|
|
<div class="line"><a name="l01584"></a><span class="lineno"> 1584</span> </div>
|
|
<div class="line"><a name="l01585"></a><span class="lineno"> 1585</span> <span class="comment">// IsSubstring() and IsNotSubstring() are intended to be used as the</span></div>
|
|
<div class="line"><a name="l01586"></a><span class="lineno"> 1586</span> <span class="comment">// first argument to {EXPECT,ASSERT}_PRED_FORMAT2(), not by</span></div>
|
|
<div class="line"><a name="l01587"></a><span class="lineno"> 1587</span> <span class="comment">// themselves. They check whether needle is a substring of haystack</span></div>
|
|
<div class="line"><a name="l01588"></a><span class="lineno"> 1588</span> <span class="comment">// (NULL is considered a substring of itself only), and return an</span></div>
|
|
<div class="line"><a name="l01589"></a><span class="lineno"> 1589</span> <span class="comment">// appropriate error message when they fail.</span></div>
|
|
<div class="line"><a name="l01590"></a><span class="lineno"> 1590</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01591"></a><span class="lineno"> 1591</span> <span class="comment">// The {needle,haystack}_expr arguments are the stringified</span></div>
|
|
<div class="line"><a name="l01592"></a><span class="lineno"> 1592</span> <span class="comment">// expressions that generated the two real arguments.</span></div>
|
|
<div class="line"><a name="l01593"></a><span class="lineno"> 1593</span> GTEST_API_ AssertionResult IsSubstring(</div>
|
|
<div class="line"><a name="l01594"></a><span class="lineno"> 1594</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr, <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
|
|
<div class="line"><a name="l01595"></a><span class="lineno"> 1595</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* needle, <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack);</div>
|
|
<div class="line"><a name="l01596"></a><span class="lineno"> 1596</span> GTEST_API_ AssertionResult IsSubstring(</div>
|
|
<div class="line"><a name="l01597"></a><span class="lineno"> 1597</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr, <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
|
|
<div class="line"><a name="l01598"></a><span class="lineno"> 1598</span>  <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* needle, <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* haystack);</div>
|
|
<div class="line"><a name="l01599"></a><span class="lineno"> 1599</span> GTEST_API_ AssertionResult IsNotSubstring(</div>
|
|
<div class="line"><a name="l01600"></a><span class="lineno"> 1600</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr, <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
|
|
<div class="line"><a name="l01601"></a><span class="lineno"> 1601</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* needle, <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack);</div>
|
|
<div class="line"><a name="l01602"></a><span class="lineno"> 1602</span> GTEST_API_ AssertionResult IsNotSubstring(</div>
|
|
<div class="line"><a name="l01603"></a><span class="lineno"> 1603</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr, <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
|
|
<div class="line"><a name="l01604"></a><span class="lineno"> 1604</span>  <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* needle, <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* haystack);</div>
|
|
<div class="line"><a name="l01605"></a><span class="lineno"> 1605</span> GTEST_API_ AssertionResult IsSubstring(</div>
|
|
<div class="line"><a name="l01606"></a><span class="lineno"> 1606</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr, <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
|
|
<div class="line"><a name="l01607"></a><span class="lineno"> 1607</span>  const ::std::string& needle, const ::std::string& haystack);</div>
|
|
<div class="line"><a name="l01608"></a><span class="lineno"> 1608</span> GTEST_API_ AssertionResult IsNotSubstring(</div>
|
|
<div class="line"><a name="l01609"></a><span class="lineno"> 1609</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr, <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
|
|
<div class="line"><a name="l01610"></a><span class="lineno"> 1610</span>  const ::std::string& needle, const ::std::string& haystack);</div>
|
|
<div class="line"><a name="l01611"></a><span class="lineno"> 1611</span> </div>
|
|
<div class="line"><a name="l01612"></a><span class="lineno"> 1612</span> <span class="preprocessor">#if GTEST_HAS_STD_WSTRING</span></div>
|
|
<div class="line"><a name="l01613"></a><span class="lineno"> 1613</span> <span class="preprocessor"></span>GTEST_API_ AssertionResult IsSubstring(</div>
|
|
<div class="line"><a name="l01614"></a><span class="lineno"> 1614</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr, <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
|
|
<div class="line"><a name="l01615"></a><span class="lineno"> 1615</span>  const ::std::wstring& needle, const ::std::wstring& haystack);</div>
|
|
<div class="line"><a name="l01616"></a><span class="lineno"> 1616</span> GTEST_API_ AssertionResult IsNotSubstring(</div>
|
|
<div class="line"><a name="l01617"></a><span class="lineno"> 1617</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr, <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
|
|
<div class="line"><a name="l01618"></a><span class="lineno"> 1618</span>  const ::std::wstring& needle, const ::std::wstring& haystack);</div>
|
|
<div class="line"><a name="l01619"></a><span class="lineno"> 1619</span> <span class="preprocessor">#endif // GTEST_HAS_STD_WSTRING</span></div>
|
|
<div class="line"><a name="l01620"></a><span class="lineno"> 1620</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01621"></a><span class="lineno"> 1621</span> <span class="keyword">namespace </span>internal {</div>
|
|
<div class="line"><a name="l01622"></a><span class="lineno"> 1622</span> </div>
|
|
<div class="line"><a name="l01623"></a><span class="lineno"> 1623</span> <span class="comment">// Helper template function for comparing floating-points.</span></div>
|
|
<div class="line"><a name="l01624"></a><span class="lineno"> 1624</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01625"></a><span class="lineno"> 1625</span> <span class="comment">// Template parameter:</span></div>
|
|
<div class="line"><a name="l01626"></a><span class="lineno"> 1626</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01627"></a><span class="lineno"> 1627</span> <span class="comment">// RawType: the raw floating-point type (either float or double)</span></div>
|
|
<div class="line"><a name="l01628"></a><span class="lineno"> 1628</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01629"></a><span class="lineno"> 1629</span> <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l01630"></a><span class="lineno"> 1630</span> <span class="keyword">template</span> <<span class="keyword">typename</span> RawType></div>
|
|
<div class="line"><a name="l01631"></a><span class="lineno"> 1631</span> AssertionResult CmpHelperFloatingPointEQ(<span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression,</div>
|
|
<div class="line"><a name="l01632"></a><span class="lineno"> 1632</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression,</div>
|
|
<div class="line"><a name="l01633"></a><span class="lineno"> 1633</span>  RawType lhs_value,</div>
|
|
<div class="line"><a name="l01634"></a><span class="lineno"> 1634</span>  RawType rhs_value) {</div>
|
|
<div class="line"><a name="l01635"></a><span class="lineno"> 1635</span>  <span class="keyword">const</span> FloatingPoint<RawType> lhs(lhs_value), rhs(rhs_value);</div>
|
|
<div class="line"><a name="l01636"></a><span class="lineno"> 1636</span> </div>
|
|
<div class="line"><a name="l01637"></a><span class="lineno"> 1637</span>  <span class="keywordflow">if</span> (lhs.AlmostEquals(rhs)) {</div>
|
|
<div class="line"><a name="l01638"></a><span class="lineno"> 1638</span>  <span class="keywordflow">return</span> AssertionSuccess();</div>
|
|
<div class="line"><a name="l01639"></a><span class="lineno"> 1639</span>  }</div>
|
|
<div class="line"><a name="l01640"></a><span class="lineno"> 1640</span> </div>
|
|
<div class="line"><a name="l01641"></a><span class="lineno"> 1641</span>  ::std::stringstream lhs_ss;</div>
|
|
<div class="line"><a name="l01642"></a><span class="lineno"> 1642</span>  lhs_ss << std::setprecision(std::numeric_limits<RawType>::digits10 + 2)</div>
|
|
<div class="line"><a name="l01643"></a><span class="lineno"> 1643</span>  << lhs_value;</div>
|
|
<div class="line"><a name="l01644"></a><span class="lineno"> 1644</span> </div>
|
|
<div class="line"><a name="l01645"></a><span class="lineno"> 1645</span>  ::std::stringstream rhs_ss;</div>
|
|
<div class="line"><a name="l01646"></a><span class="lineno"> 1646</span>  rhs_ss << std::setprecision(std::numeric_limits<RawType>::digits10 + 2)</div>
|
|
<div class="line"><a name="l01647"></a><span class="lineno"> 1647</span>  << rhs_value;</div>
|
|
<div class="line"><a name="l01648"></a><span class="lineno"> 1648</span> </div>
|
|
<div class="line"><a name="l01649"></a><span class="lineno"> 1649</span>  <span class="keywordflow">return</span> EqFailure(lhs_expression,</div>
|
|
<div class="line"><a name="l01650"></a><span class="lineno"> 1650</span>  rhs_expression,</div>
|
|
<div class="line"><a name="l01651"></a><span class="lineno"> 1651</span>  StringStreamToString(&lhs_ss),</div>
|
|
<div class="line"><a name="l01652"></a><span class="lineno"> 1652</span>  StringStreamToString(&rhs_ss),</div>
|
|
<div class="line"><a name="l01653"></a><span class="lineno"> 1653</span>  <span class="keyword">false</span>);</div>
|
|
<div class="line"><a name="l01654"></a><span class="lineno"> 1654</span> }</div>
|
|
<div class="line"><a name="l01655"></a><span class="lineno"> 1655</span> </div>
|
|
<div class="line"><a name="l01656"></a><span class="lineno"> 1656</span> <span class="comment">// Helper function for implementing ASSERT_NEAR.</span></div>
|
|
<div class="line"><a name="l01657"></a><span class="lineno"> 1657</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01658"></a><span class="lineno"> 1658</span> <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
|
|
<div class="line"><a name="l01659"></a><span class="lineno"> 1659</span> GTEST_API_ AssertionResult DoubleNearPredFormat(<span class="keyword">const</span> <span class="keywordtype">char</span>* expr1,</div>
|
|
<div class="line"><a name="l01660"></a><span class="lineno"> 1660</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* expr2,</div>
|
|
<div class="line"><a name="l01661"></a><span class="lineno"> 1661</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* abs_error_expr,</div>
|
|
<div class="line"><a name="l01662"></a><span class="lineno"> 1662</span>  <span class="keywordtype">double</span> val1,</div>
|
|
<div class="line"><a name="l01663"></a><span class="lineno"> 1663</span>  <span class="keywordtype">double</span> val2,</div>
|
|
<div class="line"><a name="l01664"></a><span class="lineno"> 1664</span>  <span class="keywordtype">double</span> abs_error);</div>
|
|
<div class="line"><a name="l01665"></a><span class="lineno"> 1665</span> </div>
|
|
<div class="line"><a name="l01666"></a><span class="lineno"> 1666</span> <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN USER CODE.</span></div>
|
|
<div class="line"><a name="l01667"></a><span class="lineno"> 1667</span> <span class="comment">// A class that enables one to stream messages to assertion macros</span></div>
|
|
<div class="line"><a name="l01668"></a><span class="lineno"><a class="line" href="classtesting_1_1internal_1_1AssertHelper.html"> 1668</a></span> <span class="keyword">class </span>GTEST_API_ <a class="code" href="classtesting_1_1internal_1_1AssertHelper.html">AssertHelper</a> {</div>
|
|
<div class="line"><a name="l01669"></a><span class="lineno"> 1669</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l01670"></a><span class="lineno"> 1670</span>  <span class="comment">// Constructor.</span></div>
|
|
<div class="line"><a name="l01671"></a><span class="lineno"> 1671</span>  <a class="code" href="classtesting_1_1internal_1_1AssertHelper.html">AssertHelper</a>(TestPartResult::Type type,</div>
|
|
<div class="line"><a name="l01672"></a><span class="lineno"> 1672</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* file,</div>
|
|
<div class="line"><a name="l01673"></a><span class="lineno"> 1673</span>  <span class="keywordtype">int</span> line,</div>
|
|
<div class="line"><a name="l01674"></a><span class="lineno"> 1674</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* message);</div>
|
|
<div class="line"><a name="l01675"></a><span class="lineno"> 1675</span>  ~<a class="code" href="classtesting_1_1internal_1_1AssertHelper.html">AssertHelper</a>();</div>
|
|
<div class="line"><a name="l01676"></a><span class="lineno"> 1676</span> </div>
|
|
<div class="line"><a name="l01677"></a><span class="lineno"> 1677</span>  <span class="comment">// Message assignment is a semantic trick to enable assertion</span></div>
|
|
<div class="line"><a name="l01678"></a><span class="lineno"> 1678</span>  <span class="comment">// streaming; see the GTEST_MESSAGE_ macro below.</span></div>
|
|
<div class="line"><a name="l01679"></a><span class="lineno"> 1679</span>  <span class="keywordtype">void</span> operator=(<span class="keyword">const</span> <a class="code" href="classtesting_1_1Message.html">Message</a>& message) <span class="keyword">const</span>;</div>
|
|
<div class="line"><a name="l01680"></a><span class="lineno"> 1680</span> </div>
|
|
<div class="line"><a name="l01681"></a><span class="lineno"> 1681</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l01682"></a><span class="lineno"> 1682</span>  <span class="comment">// We put our data in a struct so that the size of the AssertHelper class can</span></div>
|
|
<div class="line"><a name="l01683"></a><span class="lineno"> 1683</span>  <span class="comment">// be as small as possible. This is important because gcc is incapable of</span></div>
|
|
<div class="line"><a name="l01684"></a><span class="lineno"> 1684</span>  <span class="comment">// re-using stack space even for temporary variables, so every EXPECT_EQ</span></div>
|
|
<div class="line"><a name="l01685"></a><span class="lineno"> 1685</span>  <span class="comment">// reserves stack space for another AssertHelper.</span></div>
|
|
<div class="line"><a name="l01686"></a><span class="lineno"> 1686</span>  <span class="keyword">struct </span>AssertHelperData {</div>
|
|
<div class="line"><a name="l01687"></a><span class="lineno"> 1687</span>  AssertHelperData(TestPartResult::Type t,</div>
|
|
<div class="line"><a name="l01688"></a><span class="lineno"> 1688</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* srcfile,</div>
|
|
<div class="line"><a name="l01689"></a><span class="lineno"> 1689</span>  <span class="keywordtype">int</span> line_num,</div>
|
|
<div class="line"><a name="l01690"></a><span class="lineno"> 1690</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* msg)</div>
|
|
<div class="line"><a name="l01691"></a><span class="lineno"> 1691</span>  : type(t), file(srcfile), line(line_num), message(msg) { }</div>
|
|
<div class="line"><a name="l01692"></a><span class="lineno"> 1692</span> </div>
|
|
<div class="line"><a name="l01693"></a><span class="lineno"> 1693</span>  TestPartResult::Type <span class="keyword">const</span> type;</div>
|
|
<div class="line"><a name="l01694"></a><span class="lineno"> 1694</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* <span class="keyword">const</span> file;</div>
|
|
<div class="line"><a name="l01695"></a><span class="lineno"> 1695</span>  <span class="keywordtype">int</span> <span class="keyword">const</span> line;</div>
|
|
<div class="line"><a name="l01696"></a><span class="lineno"> 1696</span>  std::string <span class="keyword">const</span> message;</div>
|
|
<div class="line"><a name="l01697"></a><span class="lineno"> 1697</span> </div>
|
|
<div class="line"><a name="l01698"></a><span class="lineno"> 1698</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l01699"></a><span class="lineno"> 1699</span>  GTEST_DISALLOW_COPY_AND_ASSIGN_(AssertHelperData);</div>
|
|
<div class="line"><a name="l01700"></a><span class="lineno"> 1700</span>  };</div>
|
|
<div class="line"><a name="l01701"></a><span class="lineno"> 1701</span> </div>
|
|
<div class="line"><a name="l01702"></a><span class="lineno"> 1702</span>  AssertHelperData* <span class="keyword">const</span> data_;</div>
|
|
<div class="line"><a name="l01703"></a><span class="lineno"> 1703</span> </div>
|
|
<div class="line"><a name="l01704"></a><span class="lineno"> 1704</span>  GTEST_DISALLOW_COPY_AND_ASSIGN_(<a class="code" href="classtesting_1_1internal_1_1AssertHelper.html">AssertHelper</a>);</div>
|
|
<div class="line"><a name="l01705"></a><span class="lineno"> 1705</span> };</div>
|
|
<div class="line"><a name="l01706"></a><span class="lineno"> 1706</span> </div>
|
|
<div class="line"><a name="l01707"></a><span class="lineno"> 1707</span> } <span class="comment">// namespace internal</span></div>
|
|
<div class="line"><a name="l01708"></a><span class="lineno"> 1708</span> </div>
|
|
<div class="line"><a name="l01709"></a><span class="lineno"> 1709</span> <span class="preprocessor">#if GTEST_HAS_PARAM_TEST</span></div>
|
|
<div class="line"><a name="l01710"></a><span class="lineno"> 1710</span> <span class="preprocessor"></span><span class="comment">// The pure interface class that all value-parameterized tests inherit from.</span></div>
|
|
<div class="line"><a name="l01711"></a><span class="lineno"> 1711</span> <span class="comment">// A value-parameterized class must inherit from both ::testing::Test and</span></div>
|
|
<div class="line"><a name="l01712"></a><span class="lineno"> 1712</span> <span class="comment">// ::testing::WithParamInterface. In most cases that just means inheriting</span></div>
|
|
<div class="line"><a name="l01713"></a><span class="lineno"> 1713</span> <span class="comment">// from ::testing::TestWithParam, but more complicated test hierarchies</span></div>
|
|
<div class="line"><a name="l01714"></a><span class="lineno"> 1714</span> <span class="comment">// may need to inherit from Test and WithParamInterface at different levels.</span></div>
|
|
<div class="line"><a name="l01715"></a><span class="lineno"> 1715</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01716"></a><span class="lineno"> 1716</span> <span class="comment">// This interface has support for accessing the test parameter value via</span></div>
|
|
<div class="line"><a name="l01717"></a><span class="lineno"> 1717</span> <span class="comment">// the GetParam() method.</span></div>
|
|
<div class="line"><a name="l01718"></a><span class="lineno"> 1718</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01719"></a><span class="lineno"> 1719</span> <span class="comment">// Use it with one of the parameter generator defining functions, like Range(),</span></div>
|
|
<div class="line"><a name="l01720"></a><span class="lineno"> 1720</span> <span class="comment">// Values(), ValuesIn(), Bool(), and Combine().</span></div>
|
|
<div class="line"><a name="l01721"></a><span class="lineno"> 1721</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01722"></a><span class="lineno"> 1722</span> <span class="comment">// class FooTest : public ::testing::TestWithParam<int> {</span></div>
|
|
<div class="line"><a name="l01723"></a><span class="lineno"> 1723</span> <span class="comment">// protected:</span></div>
|
|
<div class="line"><a name="l01724"></a><span class="lineno"> 1724</span> <span class="comment">// FooTest() {</span></div>
|
|
<div class="line"><a name="l01725"></a><span class="lineno"> 1725</span> <span class="comment">// // Can use GetParam() here.</span></div>
|
|
<div class="line"><a name="l01726"></a><span class="lineno"> 1726</span> <span class="comment">// }</span></div>
|
|
<div class="line"><a name="l01727"></a><span class="lineno"> 1727</span> <span class="comment">// virtual ~FooTest() {</span></div>
|
|
<div class="line"><a name="l01728"></a><span class="lineno"> 1728</span> <span class="comment">// // Can use GetParam() here.</span></div>
|
|
<div class="line"><a name="l01729"></a><span class="lineno"> 1729</span> <span class="comment">// }</span></div>
|
|
<div class="line"><a name="l01730"></a><span class="lineno"> 1730</span> <span class="comment">// virtual void SetUp() {</span></div>
|
|
<div class="line"><a name="l01731"></a><span class="lineno"> 1731</span> <span class="comment">// // Can use GetParam() here.</span></div>
|
|
<div class="line"><a name="l01732"></a><span class="lineno"> 1732</span> <span class="comment">// }</span></div>
|
|
<div class="line"><a name="l01733"></a><span class="lineno"> 1733</span> <span class="comment">// virtual void TearDown {</span></div>
|
|
<div class="line"><a name="l01734"></a><span class="lineno"> 1734</span> <span class="comment">// // Can use GetParam() here.</span></div>
|
|
<div class="line"><a name="l01735"></a><span class="lineno"> 1735</span> <span class="comment">// }</span></div>
|
|
<div class="line"><a name="l01736"></a><span class="lineno"> 1736</span> <span class="comment">// };</span></div>
|
|
<div class="line"><a name="l01737"></a><span class="lineno"> 1737</span> <span class="comment">// TEST_P(FooTest, DoesBar) {</span></div>
|
|
<div class="line"><a name="l01738"></a><span class="lineno"> 1738</span> <span class="comment">// // Can use GetParam() method here.</span></div>
|
|
<div class="line"><a name="l01739"></a><span class="lineno"> 1739</span> <span class="comment">// Foo foo;</span></div>
|
|
<div class="line"><a name="l01740"></a><span class="lineno"> 1740</span> <span class="comment">// ASSERT_TRUE(foo.DoesBar(GetParam()));</span></div>
|
|
<div class="line"><a name="l01741"></a><span class="lineno"> 1741</span> <span class="comment">// }</span></div>
|
|
<div class="line"><a name="l01742"></a><span class="lineno"> 1742</span> <span class="comment">// INSTANTIATE_TEST_CASE_P(OneToTenRange, FooTest, ::testing::Range(1, 10));</span></div>
|
|
<div class="line"><a name="l01743"></a><span class="lineno"> 1743</span> </div>
|
|
<div class="line"><a name="l01744"></a><span class="lineno"> 1744</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
|
|
<div class="line"><a name="l01745"></a><span class="lineno"> 1745</span> <span class="keyword">class </span>WithParamInterface {</div>
|
|
<div class="line"><a name="l01746"></a><span class="lineno"> 1746</span>  <span class="keyword">public</span>:</div>
|
|
<div class="line"><a name="l01747"></a><span class="lineno"> 1747</span>  <span class="keyword">typedef</span> T ParamType;</div>
|
|
<div class="line"><a name="l01748"></a><span class="lineno"> 1748</span>  <span class="keyword">virtual</span> ~WithParamInterface() {}</div>
|
|
<div class="line"><a name="l01749"></a><span class="lineno"> 1749</span> </div>
|
|
<div class="line"><a name="l01750"></a><span class="lineno"> 1750</span>  <span class="comment">// The current parameter value. Is also available in the test fixture's</span></div>
|
|
<div class="line"><a name="l01751"></a><span class="lineno"> 1751</span>  <span class="comment">// constructor. This member function is non-static, even though it only</span></div>
|
|
<div class="line"><a name="l01752"></a><span class="lineno"> 1752</span>  <span class="comment">// references static data, to reduce the opportunity for incorrect uses</span></div>
|
|
<div class="line"><a name="l01753"></a><span class="lineno"> 1753</span>  <span class="comment">// like writing 'WithParamInterface<bool>::GetParam()' for a test that</span></div>
|
|
<div class="line"><a name="l01754"></a><span class="lineno"> 1754</span>  <span class="comment">// uses a fixture whose parameter type is int.</span></div>
|
|
<div class="line"><a name="l01755"></a><span class="lineno"> 1755</span>  <span class="keyword">const</span> ParamType& GetParam()<span class="keyword"> const </span>{</div>
|
|
<div class="line"><a name="l01756"></a><span class="lineno"> 1756</span>  GTEST_CHECK_(parameter_ != NULL)</div>
|
|
<div class="line"><a name="l01757"></a><span class="lineno"> 1757</span>  << <span class="stringliteral">"GetParam() can only be called inside a value-parameterized test "</span></div>
|
|
<div class="line"><a name="l01758"></a><span class="lineno"> 1758</span>  << <span class="stringliteral">"-- did you intend to write TEST_P instead of TEST_F?"</span>;</div>
|
|
<div class="line"><a name="l01759"></a><span class="lineno"> 1759</span>  <span class="keywordflow">return</span> *parameter_;</div>
|
|
<div class="line"><a name="l01760"></a><span class="lineno"> 1760</span>  }</div>
|
|
<div class="line"><a name="l01761"></a><span class="lineno"> 1761</span> </div>
|
|
<div class="line"><a name="l01762"></a><span class="lineno"> 1762</span>  <span class="keyword">private</span>:</div>
|
|
<div class="line"><a name="l01763"></a><span class="lineno"> 1763</span>  <span class="comment">// Sets parameter value. The caller is responsible for making sure the value</span></div>
|
|
<div class="line"><a name="l01764"></a><span class="lineno"> 1764</span>  <span class="comment">// remains alive and unchanged throughout the current test.</span></div>
|
|
<div class="line"><a name="l01765"></a><span class="lineno"> 1765</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> SetParam(<span class="keyword">const</span> ParamType* parameter) {</div>
|
|
<div class="line"><a name="l01766"></a><span class="lineno"> 1766</span>  parameter_ = parameter;</div>
|
|
<div class="line"><a name="l01767"></a><span class="lineno"> 1767</span>  }</div>
|
|
<div class="line"><a name="l01768"></a><span class="lineno"> 1768</span> </div>
|
|
<div class="line"><a name="l01769"></a><span class="lineno"> 1769</span>  <span class="comment">// Static value used for accessing parameter during a test lifetime.</span></div>
|
|
<div class="line"><a name="l01770"></a><span class="lineno"> 1770</span>  <span class="keyword">static</span> <span class="keyword">const</span> ParamType* parameter_;</div>
|
|
<div class="line"><a name="l01771"></a><span class="lineno"> 1771</span> </div>
|
|
<div class="line"><a name="l01772"></a><span class="lineno"> 1772</span>  <span class="comment">// TestClass must be a subclass of WithParamInterface<T> and Test.</span></div>
|
|
<div class="line"><a name="l01773"></a><span class="lineno"> 1773</span>  <span class="keyword">template</span> <<span class="keyword">class</span> TestClass> <span class="keyword">friend</span> <span class="keyword">class </span>internal::ParameterizedTestFactory;</div>
|
|
<div class="line"><a name="l01774"></a><span class="lineno"> 1774</span> };</div>
|
|
<div class="line"><a name="l01775"></a><span class="lineno"> 1775</span> </div>
|
|
<div class="line"><a name="l01776"></a><span class="lineno"> 1776</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
|
|
<div class="line"><a name="l01777"></a><span class="lineno"> 1777</span> <span class="keyword">const</span> T* WithParamInterface<T>::parameter_ = NULL;</div>
|
|
<div class="line"><a name="l01778"></a><span class="lineno"> 1778</span> </div>
|
|
<div class="line"><a name="l01779"></a><span class="lineno"> 1779</span> <span class="comment">// Most value-parameterized classes can ignore the existence of</span></div>
|
|
<div class="line"><a name="l01780"></a><span class="lineno"> 1780</span> <span class="comment">// WithParamInterface, and can just inherit from ::testing::TestWithParam.</span></div>
|
|
<div class="line"><a name="l01781"></a><span class="lineno"> 1781</span> </div>
|
|
<div class="line"><a name="l01782"></a><span class="lineno"> 1782</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
|
|
<div class="line"><a name="l01783"></a><span class="lineno"> 1783</span> <span class="keyword">class </span>TestWithParam : <span class="keyword">public</span> Test, <span class="keyword">public</span> WithParamInterface<T> {</div>
|
|
<div class="line"><a name="l01784"></a><span class="lineno"> 1784</span> };</div>
|
|
<div class="line"><a name="l01785"></a><span class="lineno"> 1785</span> </div>
|
|
<div class="line"><a name="l01786"></a><span class="lineno"> 1786</span> <span class="preprocessor">#endif // GTEST_HAS_PARAM_TEST</span></div>
|
|
<div class="line"><a name="l01787"></a><span class="lineno"> 1787</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01788"></a><span class="lineno"> 1788</span> <span class="comment">// Macros for indicating success/failure in test code.</span></div>
|
|
<div class="line"><a name="l01789"></a><span class="lineno"> 1789</span> </div>
|
|
<div class="line"><a name="l01790"></a><span class="lineno"> 1790</span> <span class="comment">// ADD_FAILURE unconditionally adds a failure to the current test.</span></div>
|
|
<div class="line"><a name="l01791"></a><span class="lineno"> 1791</span> <span class="comment">// SUCCEED generates a success - it doesn't automatically make the</span></div>
|
|
<div class="line"><a name="l01792"></a><span class="lineno"> 1792</span> <span class="comment">// current test successful, as a test is only successful when it has</span></div>
|
|
<div class="line"><a name="l01793"></a><span class="lineno"> 1793</span> <span class="comment">// no failure.</span></div>
|
|
<div class="line"><a name="l01794"></a><span class="lineno"> 1794</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01795"></a><span class="lineno"> 1795</span> <span class="comment">// EXPECT_* verifies that a certain condition is satisfied. If not,</span></div>
|
|
<div class="line"><a name="l01796"></a><span class="lineno"> 1796</span> <span class="comment">// it behaves like ADD_FAILURE. In particular:</span></div>
|
|
<div class="line"><a name="l01797"></a><span class="lineno"> 1797</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01798"></a><span class="lineno"> 1798</span> <span class="comment">// EXPECT_TRUE verifies that a Boolean condition is true.</span></div>
|
|
<div class="line"><a name="l01799"></a><span class="lineno"> 1799</span> <span class="comment">// EXPECT_FALSE verifies that a Boolean condition is false.</span></div>
|
|
<div class="line"><a name="l01800"></a><span class="lineno"> 1800</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01801"></a><span class="lineno"> 1801</span> <span class="comment">// FAIL and ASSERT_* are similar to ADD_FAILURE and EXPECT_*, except</span></div>
|
|
<div class="line"><a name="l01802"></a><span class="lineno"> 1802</span> <span class="comment">// that they will also abort the current function on failure. People</span></div>
|
|
<div class="line"><a name="l01803"></a><span class="lineno"> 1803</span> <span class="comment">// usually want the fail-fast behavior of FAIL and ASSERT_*, but those</span></div>
|
|
<div class="line"><a name="l01804"></a><span class="lineno"> 1804</span> <span class="comment">// writing data-driven tests often find themselves using ADD_FAILURE</span></div>
|
|
<div class="line"><a name="l01805"></a><span class="lineno"> 1805</span> <span class="comment">// and EXPECT_* more.</span></div>
|
|
<div class="line"><a name="l01806"></a><span class="lineno"> 1806</span> </div>
|
|
<div class="line"><a name="l01807"></a><span class="lineno"> 1807</span> <span class="comment">// Generates a nonfatal failure with a generic message.</span></div>
|
|
<div class="line"><a name="l01808"></a><span class="lineno"> 1808</span> <span class="preprocessor">#define ADD_FAILURE() GTEST_NONFATAL_FAILURE_("Failed")</span></div>
|
|
<div class="line"><a name="l01809"></a><span class="lineno"> 1809</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01810"></a><span class="lineno"> 1810</span> <span class="comment">// Generates a nonfatal failure at the given source file location with</span></div>
|
|
<div class="line"><a name="l01811"></a><span class="lineno"> 1811</span> <span class="comment">// a generic message.</span></div>
|
|
<div class="line"><a name="l01812"></a><span class="lineno"> 1812</span> <span class="preprocessor">#define ADD_FAILURE_AT(file, line) \</span></div>
|
|
<div class="line"><a name="l01813"></a><span class="lineno"> 1813</span> <span class="preprocessor"> GTEST_MESSAGE_AT_(file, line, "Failed", \</span></div>
|
|
<div class="line"><a name="l01814"></a><span class="lineno"> 1814</span> <span class="preprocessor"> ::testing::TestPartResult::kNonFatalFailure)</span></div>
|
|
<div class="line"><a name="l01815"></a><span class="lineno"> 1815</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01816"></a><span class="lineno"> 1816</span> <span class="comment">// Generates a fatal failure with a generic message.</span></div>
|
|
<div class="line"><a name="l01817"></a><span class="lineno"> 1817</span> <span class="preprocessor">#define GTEST_FAIL() GTEST_FATAL_FAILURE_("Failed")</span></div>
|
|
<div class="line"><a name="l01818"></a><span class="lineno"> 1818</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01819"></a><span class="lineno"> 1819</span> <span class="comment">// Define this macro to 1 to omit the definition of FAIL(), which is a</span></div>
|
|
<div class="line"><a name="l01820"></a><span class="lineno"> 1820</span> <span class="comment">// generic name and clashes with some other libraries.</span></div>
|
|
<div class="line"><a name="l01821"></a><span class="lineno"> 1821</span> <span class="preprocessor">#if !GTEST_DONT_DEFINE_FAIL</span></div>
|
|
<div class="line"><a name="l01822"></a><span class="lineno"> 1822</span> <span class="preprocessor"></span><span class="preprocessor"># define FAIL() GTEST_FAIL()</span></div>
|
|
<div class="line"><a name="l01823"></a><span class="lineno"> 1823</span> <span class="preprocessor"></span><span class="preprocessor">#endif</span></div>
|
|
<div class="line"><a name="l01824"></a><span class="lineno"> 1824</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01825"></a><span class="lineno"> 1825</span> <span class="comment">// Generates a success with a generic message.</span></div>
|
|
<div class="line"><a name="l01826"></a><span class="lineno"> 1826</span> <span class="preprocessor">#define GTEST_SUCCEED() GTEST_SUCCESS_("Succeeded")</span></div>
|
|
<div class="line"><a name="l01827"></a><span class="lineno"> 1827</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01828"></a><span class="lineno"> 1828</span> <span class="comment">// Define this macro to 1 to omit the definition of SUCCEED(), which</span></div>
|
|
<div class="line"><a name="l01829"></a><span class="lineno"> 1829</span> <span class="comment">// is a generic name and clashes with some other libraries.</span></div>
|
|
<div class="line"><a name="l01830"></a><span class="lineno"> 1830</span> <span class="preprocessor">#if !GTEST_DONT_DEFINE_SUCCEED</span></div>
|
|
<div class="line"><a name="l01831"></a><span class="lineno"> 1831</span> <span class="preprocessor"></span><span class="preprocessor"># define SUCCEED() GTEST_SUCCEED()</span></div>
|
|
<div class="line"><a name="l01832"></a><span class="lineno"> 1832</span> <span class="preprocessor"></span><span class="preprocessor">#endif</span></div>
|
|
<div class="line"><a name="l01833"></a><span class="lineno"> 1833</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01834"></a><span class="lineno"> 1834</span> <span class="comment">// Macros for testing exceptions.</span></div>
|
|
<div class="line"><a name="l01835"></a><span class="lineno"> 1835</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01836"></a><span class="lineno"> 1836</span> <span class="comment">// * {ASSERT|EXPECT}_THROW(statement, expected_exception):</span></div>
|
|
<div class="line"><a name="l01837"></a><span class="lineno"> 1837</span> <span class="comment">// Tests that the statement throws the expected exception.</span></div>
|
|
<div class="line"><a name="l01838"></a><span class="lineno"> 1838</span> <span class="comment">// * {ASSERT|EXPECT}_NO_THROW(statement):</span></div>
|
|
<div class="line"><a name="l01839"></a><span class="lineno"> 1839</span> <span class="comment">// Tests that the statement doesn't throw any exception.</span></div>
|
|
<div class="line"><a name="l01840"></a><span class="lineno"> 1840</span> <span class="comment">// * {ASSERT|EXPECT}_ANY_THROW(statement):</span></div>
|
|
<div class="line"><a name="l01841"></a><span class="lineno"> 1841</span> <span class="comment">// Tests that the statement throws an exception.</span></div>
|
|
<div class="line"><a name="l01842"></a><span class="lineno"> 1842</span> </div>
|
|
<div class="line"><a name="l01843"></a><span class="lineno"> 1843</span> <span class="preprocessor">#define EXPECT_THROW(statement, expected_exception) \</span></div>
|
|
<div class="line"><a name="l01844"></a><span class="lineno"> 1844</span> <span class="preprocessor"> GTEST_TEST_THROW_(statement, expected_exception, GTEST_NONFATAL_FAILURE_)</span></div>
|
|
<div class="line"><a name="l01845"></a><span class="lineno"> 1845</span> <span class="preprocessor"></span><span class="preprocessor">#define EXPECT_NO_THROW(statement) \</span></div>
|
|
<div class="line"><a name="l01846"></a><span class="lineno"> 1846</span> <span class="preprocessor"> GTEST_TEST_NO_THROW_(statement, GTEST_NONFATAL_FAILURE_)</span></div>
|
|
<div class="line"><a name="l01847"></a><span class="lineno"> 1847</span> <span class="preprocessor"></span><span class="preprocessor">#define EXPECT_ANY_THROW(statement) \</span></div>
|
|
<div class="line"><a name="l01848"></a><span class="lineno"> 1848</span> <span class="preprocessor"> GTEST_TEST_ANY_THROW_(statement, GTEST_NONFATAL_FAILURE_)</span></div>
|
|
<div class="line"><a name="l01849"></a><span class="lineno"> 1849</span> <span class="preprocessor"></span><span class="preprocessor">#define ASSERT_THROW(statement, expected_exception) \</span></div>
|
|
<div class="line"><a name="l01850"></a><span class="lineno"> 1850</span> <span class="preprocessor"> GTEST_TEST_THROW_(statement, expected_exception, GTEST_FATAL_FAILURE_)</span></div>
|
|
<div class="line"><a name="l01851"></a><span class="lineno"> 1851</span> <span class="preprocessor"></span><span class="preprocessor">#define ASSERT_NO_THROW(statement) \</span></div>
|
|
<div class="line"><a name="l01852"></a><span class="lineno"> 1852</span> <span class="preprocessor"> GTEST_TEST_NO_THROW_(statement, GTEST_FATAL_FAILURE_)</span></div>
|
|
<div class="line"><a name="l01853"></a><span class="lineno"> 1853</span> <span class="preprocessor"></span><span class="preprocessor">#define ASSERT_ANY_THROW(statement) \</span></div>
|
|
<div class="line"><a name="l01854"></a><span class="lineno"> 1854</span> <span class="preprocessor"> GTEST_TEST_ANY_THROW_(statement, GTEST_FATAL_FAILURE_)</span></div>
|
|
<div class="line"><a name="l01855"></a><span class="lineno"> 1855</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01856"></a><span class="lineno"> 1856</span> <span class="comment">// Boolean assertions. Condition can be either a Boolean expression or an</span></div>
|
|
<div class="line"><a name="l01857"></a><span class="lineno"> 1857</span> <span class="comment">// AssertionResult. For more information on how to use AssertionResult with</span></div>
|
|
<div class="line"><a name="l01858"></a><span class="lineno"> 1858</span> <span class="comment">// these macros see comments on that class.</span></div>
|
|
<div class="line"><a name="l01859"></a><span class="lineno"> 1859</span> <span class="preprocessor">#define EXPECT_TRUE(condition) \</span></div>
|
|
<div class="line"><a name="l01860"></a><span class="lineno"> 1860</span> <span class="preprocessor"> GTEST_TEST_BOOLEAN_((condition), #condition, false, true, \</span></div>
|
|
<div class="line"><a name="l01861"></a><span class="lineno"> 1861</span> <span class="preprocessor"> GTEST_NONFATAL_FAILURE_)</span></div>
|
|
<div class="line"><a name="l01862"></a><span class="lineno"> 1862</span> <span class="preprocessor"></span><span class="preprocessor">#define EXPECT_FALSE(condition) \</span></div>
|
|
<div class="line"><a name="l01863"></a><span class="lineno"> 1863</span> <span class="preprocessor"> GTEST_TEST_BOOLEAN_(!(condition), #condition, true, false, \</span></div>
|
|
<div class="line"><a name="l01864"></a><span class="lineno"> 1864</span> <span class="preprocessor"> GTEST_NONFATAL_FAILURE_)</span></div>
|
|
<div class="line"><a name="l01865"></a><span class="lineno"> 1865</span> <span class="preprocessor"></span><span class="preprocessor">#define ASSERT_TRUE(condition) \</span></div>
|
|
<div class="line"><a name="l01866"></a><span class="lineno"> 1866</span> <span class="preprocessor"> GTEST_TEST_BOOLEAN_((condition), #condition, false, true, \</span></div>
|
|
<div class="line"><a name="l01867"></a><span class="lineno"> 1867</span> <span class="preprocessor"> GTEST_FATAL_FAILURE_)</span></div>
|
|
<div class="line"><a name="l01868"></a><span class="lineno"> 1868</span> <span class="preprocessor"></span><span class="preprocessor">#define ASSERT_FALSE(condition) \</span></div>
|
|
<div class="line"><a name="l01869"></a><span class="lineno"> 1869</span> <span class="preprocessor"> GTEST_TEST_BOOLEAN_(!(condition), #condition, true, false, \</span></div>
|
|
<div class="line"><a name="l01870"></a><span class="lineno"> 1870</span> <span class="preprocessor"> GTEST_FATAL_FAILURE_)</span></div>
|
|
<div class="line"><a name="l01871"></a><span class="lineno"> 1871</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01872"></a><span class="lineno"> 1872</span> <span class="comment">// Includes the auto-generated header that implements a family of</span></div>
|
|
<div class="line"><a name="l01873"></a><span class="lineno"> 1873</span> <span class="comment">// generic predicate assertion macros.</span></div>
|
|
<div class="line"><a name="l01874"></a><span class="lineno"> 1874</span> <span class="preprocessor">#include "gtest/gtest_pred_impl.h"</span></div>
|
|
<div class="line"><a name="l01875"></a><span class="lineno"> 1875</span> </div>
|
|
<div class="line"><a name="l01876"></a><span class="lineno"> 1876</span> <span class="comment">// Macros for testing equalities and inequalities.</span></div>
|
|
<div class="line"><a name="l01877"></a><span class="lineno"> 1877</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01878"></a><span class="lineno"> 1878</span> <span class="comment">// * {ASSERT|EXPECT}_EQ(v1, v2): Tests that v1 == v2</span></div>
|
|
<div class="line"><a name="l01879"></a><span class="lineno"> 1879</span> <span class="comment">// * {ASSERT|EXPECT}_NE(v1, v2): Tests that v1 != v2</span></div>
|
|
<div class="line"><a name="l01880"></a><span class="lineno"> 1880</span> <span class="comment">// * {ASSERT|EXPECT}_LT(v1, v2): Tests that v1 < v2</span></div>
|
|
<div class="line"><a name="l01881"></a><span class="lineno"> 1881</span> <span class="comment">// * {ASSERT|EXPECT}_LE(v1, v2): Tests that v1 <= v2</span></div>
|
|
<div class="line"><a name="l01882"></a><span class="lineno"> 1882</span> <span class="comment">// * {ASSERT|EXPECT}_GT(v1, v2): Tests that v1 > v2</span></div>
|
|
<div class="line"><a name="l01883"></a><span class="lineno"> 1883</span> <span class="comment">// * {ASSERT|EXPECT}_GE(v1, v2): Tests that v1 >= v2</span></div>
|
|
<div class="line"><a name="l01884"></a><span class="lineno"> 1884</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01885"></a><span class="lineno"> 1885</span> <span class="comment">// When they are not, Google Test prints both the tested expressions and</span></div>
|
|
<div class="line"><a name="l01886"></a><span class="lineno"> 1886</span> <span class="comment">// their actual values. The values must be compatible built-in types,</span></div>
|
|
<div class="line"><a name="l01887"></a><span class="lineno"> 1887</span> <span class="comment">// or you will get a compiler error. By "compatible" we mean that the</span></div>
|
|
<div class="line"><a name="l01888"></a><span class="lineno"> 1888</span> <span class="comment">// values can be compared by the respective operator.</span></div>
|
|
<div class="line"><a name="l01889"></a><span class="lineno"> 1889</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01890"></a><span class="lineno"> 1890</span> <span class="comment">// Note:</span></div>
|
|
<div class="line"><a name="l01891"></a><span class="lineno"> 1891</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01892"></a><span class="lineno"> 1892</span> <span class="comment">// 1. It is possible to make a user-defined type work with</span></div>
|
|
<div class="line"><a name="l01893"></a><span class="lineno"> 1893</span> <span class="comment">// {ASSERT|EXPECT}_??(), but that requires overloading the</span></div>
|
|
<div class="line"><a name="l01894"></a><span class="lineno"> 1894</span> <span class="comment">// comparison operators and is thus discouraged by the Google C++</span></div>
|
|
<div class="line"><a name="l01895"></a><span class="lineno"> 1895</span> <span class="comment">// Usage Guide. Therefore, you are advised to use the</span></div>
|
|
<div class="line"><a name="l01896"></a><span class="lineno"> 1896</span> <span class="comment">// {ASSERT|EXPECT}_TRUE() macro to assert that two objects are</span></div>
|
|
<div class="line"><a name="l01897"></a><span class="lineno"> 1897</span> <span class="comment">// equal.</span></div>
|
|
<div class="line"><a name="l01898"></a><span class="lineno"> 1898</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01899"></a><span class="lineno"> 1899</span> <span class="comment">// 2. The {ASSERT|EXPECT}_??() macros do pointer comparisons on</span></div>
|
|
<div class="line"><a name="l01900"></a><span class="lineno"> 1900</span> <span class="comment">// pointers (in particular, C strings). Therefore, if you use it</span></div>
|
|
<div class="line"><a name="l01901"></a><span class="lineno"> 1901</span> <span class="comment">// with two C strings, you are testing how their locations in memory</span></div>
|
|
<div class="line"><a name="l01902"></a><span class="lineno"> 1902</span> <span class="comment">// are related, not how their content is related. To compare two C</span></div>
|
|
<div class="line"><a name="l01903"></a><span class="lineno"> 1903</span> <span class="comment">// strings by content, use {ASSERT|EXPECT}_STR*().</span></div>
|
|
<div class="line"><a name="l01904"></a><span class="lineno"> 1904</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01905"></a><span class="lineno"> 1905</span> <span class="comment">// 3. {ASSERT|EXPECT}_EQ(v1, v2) is preferred to</span></div>
|
|
<div class="line"><a name="l01906"></a><span class="lineno"> 1906</span> <span class="comment">// {ASSERT|EXPECT}_TRUE(v1 == v2), as the former tells you</span></div>
|
|
<div class="line"><a name="l01907"></a><span class="lineno"> 1907</span> <span class="comment">// what the actual value is when it fails, and similarly for the</span></div>
|
|
<div class="line"><a name="l01908"></a><span class="lineno"> 1908</span> <span class="comment">// other comparisons.</span></div>
|
|
<div class="line"><a name="l01909"></a><span class="lineno"> 1909</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01910"></a><span class="lineno"> 1910</span> <span class="comment">// 4. Do not depend on the order in which {ASSERT|EXPECT}_??()</span></div>
|
|
<div class="line"><a name="l01911"></a><span class="lineno"> 1911</span> <span class="comment">// evaluate their arguments, which is undefined.</span></div>
|
|
<div class="line"><a name="l01912"></a><span class="lineno"> 1912</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01913"></a><span class="lineno"> 1913</span> <span class="comment">// 5. These macros evaluate their arguments exactly once.</span></div>
|
|
<div class="line"><a name="l01914"></a><span class="lineno"> 1914</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01915"></a><span class="lineno"> 1915</span> <span class="comment">// Examples:</span></div>
|
|
<div class="line"><a name="l01916"></a><span class="lineno"> 1916</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01917"></a><span class="lineno"> 1917</span> <span class="comment">// EXPECT_NE(5, Foo());</span></div>
|
|
<div class="line"><a name="l01918"></a><span class="lineno"> 1918</span> <span class="comment">// EXPECT_EQ(NULL, a_pointer);</span></div>
|
|
<div class="line"><a name="l01919"></a><span class="lineno"> 1919</span> <span class="comment">// ASSERT_LT(i, array_size);</span></div>
|
|
<div class="line"><a name="l01920"></a><span class="lineno"> 1920</span> <span class="comment">// ASSERT_GT(records.size(), 0) << "There is no record left.";</span></div>
|
|
<div class="line"><a name="l01921"></a><span class="lineno"> 1921</span> </div>
|
|
<div class="line"><a name="l01922"></a><span class="lineno"> 1922</span> <span class="preprocessor">#define EXPECT_EQ(val1, val2) \</span></div>
|
|
<div class="line"><a name="l01923"></a><span class="lineno"> 1923</span> <span class="preprocessor"> EXPECT_PRED_FORMAT2(::testing::internal:: \</span></div>
|
|
<div class="line"><a name="l01924"></a><span class="lineno"> 1924</span> <span class="preprocessor"> EqHelper<GTEST_IS_NULL_LITERAL_(val1)>::Compare, \</span></div>
|
|
<div class="line"><a name="l01925"></a><span class="lineno"> 1925</span> <span class="preprocessor"> val1, val2)</span></div>
|
|
<div class="line"><a name="l01926"></a><span class="lineno"> 1926</span> <span class="preprocessor"></span><span class="preprocessor">#define EXPECT_NE(val1, val2) \</span></div>
|
|
<div class="line"><a name="l01927"></a><span class="lineno"> 1927</span> <span class="preprocessor"> EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperNE, val1, val2)</span></div>
|
|
<div class="line"><a name="l01928"></a><span class="lineno"> 1928</span> <span class="preprocessor"></span><span class="preprocessor">#define EXPECT_LE(val1, val2) \</span></div>
|
|
<div class="line"><a name="l01929"></a><span class="lineno"> 1929</span> <span class="preprocessor"> EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperLE, val1, val2)</span></div>
|
|
<div class="line"><a name="l01930"></a><span class="lineno"> 1930</span> <span class="preprocessor"></span><span class="preprocessor">#define EXPECT_LT(val1, val2) \</span></div>
|
|
<div class="line"><a name="l01931"></a><span class="lineno"> 1931</span> <span class="preprocessor"> EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperLT, val1, val2)</span></div>
|
|
<div class="line"><a name="l01932"></a><span class="lineno"> 1932</span> <span class="preprocessor"></span><span class="preprocessor">#define EXPECT_GE(val1, val2) \</span></div>
|
|
<div class="line"><a name="l01933"></a><span class="lineno"> 1933</span> <span class="preprocessor"> EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperGE, val1, val2)</span></div>
|
|
<div class="line"><a name="l01934"></a><span class="lineno"> 1934</span> <span class="preprocessor"></span><span class="preprocessor">#define EXPECT_GT(val1, val2) \</span></div>
|
|
<div class="line"><a name="l01935"></a><span class="lineno"> 1935</span> <span class="preprocessor"> EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperGT, val1, val2)</span></div>
|
|
<div class="line"><a name="l01936"></a><span class="lineno"> 1936</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01937"></a><span class="lineno"> 1937</span> <span class="preprocessor">#define GTEST_ASSERT_EQ(val1, val2) \</span></div>
|
|
<div class="line"><a name="l01938"></a><span class="lineno"> 1938</span> <span class="preprocessor"> ASSERT_PRED_FORMAT2(::testing::internal:: \</span></div>
|
|
<div class="line"><a name="l01939"></a><span class="lineno"> 1939</span> <span class="preprocessor"> EqHelper<GTEST_IS_NULL_LITERAL_(val1)>::Compare, \</span></div>
|
|
<div class="line"><a name="l01940"></a><span class="lineno"> 1940</span> <span class="preprocessor"> val1, val2)</span></div>
|
|
<div class="line"><a name="l01941"></a><span class="lineno"> 1941</span> <span class="preprocessor"></span><span class="preprocessor">#define GTEST_ASSERT_NE(val1, val2) \</span></div>
|
|
<div class="line"><a name="l01942"></a><span class="lineno"> 1942</span> <span class="preprocessor"> ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperNE, val1, val2)</span></div>
|
|
<div class="line"><a name="l01943"></a><span class="lineno"> 1943</span> <span class="preprocessor"></span><span class="preprocessor">#define GTEST_ASSERT_LE(val1, val2) \</span></div>
|
|
<div class="line"><a name="l01944"></a><span class="lineno"> 1944</span> <span class="preprocessor"> ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperLE, val1, val2)</span></div>
|
|
<div class="line"><a name="l01945"></a><span class="lineno"> 1945</span> <span class="preprocessor"></span><span class="preprocessor">#define GTEST_ASSERT_LT(val1, val2) \</span></div>
|
|
<div class="line"><a name="l01946"></a><span class="lineno"> 1946</span> <span class="preprocessor"> ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperLT, val1, val2)</span></div>
|
|
<div class="line"><a name="l01947"></a><span class="lineno"> 1947</span> <span class="preprocessor"></span><span class="preprocessor">#define GTEST_ASSERT_GE(val1, val2) \</span></div>
|
|
<div class="line"><a name="l01948"></a><span class="lineno"> 1948</span> <span class="preprocessor"> ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperGE, val1, val2)</span></div>
|
|
<div class="line"><a name="l01949"></a><span class="lineno"> 1949</span> <span class="preprocessor"></span><span class="preprocessor">#define GTEST_ASSERT_GT(val1, val2) \</span></div>
|
|
<div class="line"><a name="l01950"></a><span class="lineno"> 1950</span> <span class="preprocessor"> ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperGT, val1, val2)</span></div>
|
|
<div class="line"><a name="l01951"></a><span class="lineno"> 1951</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01952"></a><span class="lineno"> 1952</span> <span class="comment">// Define macro GTEST_DONT_DEFINE_ASSERT_XY to 1 to omit the definition of</span></div>
|
|
<div class="line"><a name="l01953"></a><span class="lineno"> 1953</span> <span class="comment">// ASSERT_XY(), which clashes with some users' own code.</span></div>
|
|
<div class="line"><a name="l01954"></a><span class="lineno"> 1954</span> </div>
|
|
<div class="line"><a name="l01955"></a><span class="lineno"> 1955</span> <span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_EQ</span></div>
|
|
<div class="line"><a name="l01956"></a><span class="lineno"> 1956</span> <span class="preprocessor"></span><span class="preprocessor"># define ASSERT_EQ(val1, val2) GTEST_ASSERT_EQ(val1, val2)</span></div>
|
|
<div class="line"><a name="l01957"></a><span class="lineno"> 1957</span> <span class="preprocessor"></span><span class="preprocessor">#endif</span></div>
|
|
<div class="line"><a name="l01958"></a><span class="lineno"> 1958</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01959"></a><span class="lineno"> 1959</span> <span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_NE</span></div>
|
|
<div class="line"><a name="l01960"></a><span class="lineno"> 1960</span> <span class="preprocessor"></span><span class="preprocessor"># define ASSERT_NE(val1, val2) GTEST_ASSERT_NE(val1, val2)</span></div>
|
|
<div class="line"><a name="l01961"></a><span class="lineno"> 1961</span> <span class="preprocessor"></span><span class="preprocessor">#endif</span></div>
|
|
<div class="line"><a name="l01962"></a><span class="lineno"> 1962</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01963"></a><span class="lineno"> 1963</span> <span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_LE</span></div>
|
|
<div class="line"><a name="l01964"></a><span class="lineno"> 1964</span> <span class="preprocessor"></span><span class="preprocessor"># define ASSERT_LE(val1, val2) GTEST_ASSERT_LE(val1, val2)</span></div>
|
|
<div class="line"><a name="l01965"></a><span class="lineno"> 1965</span> <span class="preprocessor"></span><span class="preprocessor">#endif</span></div>
|
|
<div class="line"><a name="l01966"></a><span class="lineno"> 1966</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01967"></a><span class="lineno"> 1967</span> <span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_LT</span></div>
|
|
<div class="line"><a name="l01968"></a><span class="lineno"> 1968</span> <span class="preprocessor"></span><span class="preprocessor"># define ASSERT_LT(val1, val2) GTEST_ASSERT_LT(val1, val2)</span></div>
|
|
<div class="line"><a name="l01969"></a><span class="lineno"> 1969</span> <span class="preprocessor"></span><span class="preprocessor">#endif</span></div>
|
|
<div class="line"><a name="l01970"></a><span class="lineno"> 1970</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01971"></a><span class="lineno"> 1971</span> <span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_GE</span></div>
|
|
<div class="line"><a name="l01972"></a><span class="lineno"> 1972</span> <span class="preprocessor"></span><span class="preprocessor"># define ASSERT_GE(val1, val2) GTEST_ASSERT_GE(val1, val2)</span></div>
|
|
<div class="line"><a name="l01973"></a><span class="lineno"> 1973</span> <span class="preprocessor"></span><span class="preprocessor">#endif</span></div>
|
|
<div class="line"><a name="l01974"></a><span class="lineno"> 1974</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01975"></a><span class="lineno"> 1975</span> <span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_GT</span></div>
|
|
<div class="line"><a name="l01976"></a><span class="lineno"> 1976</span> <span class="preprocessor"></span><span class="preprocessor"># define ASSERT_GT(val1, val2) GTEST_ASSERT_GT(val1, val2)</span></div>
|
|
<div class="line"><a name="l01977"></a><span class="lineno"> 1977</span> <span class="preprocessor"></span><span class="preprocessor">#endif</span></div>
|
|
<div class="line"><a name="l01978"></a><span class="lineno"> 1978</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l01979"></a><span class="lineno"> 1979</span> <span class="comment">// C-string Comparisons. All tests treat NULL and any non-NULL string</span></div>
|
|
<div class="line"><a name="l01980"></a><span class="lineno"> 1980</span> <span class="comment">// as different. Two NULLs are equal.</span></div>
|
|
<div class="line"><a name="l01981"></a><span class="lineno"> 1981</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01982"></a><span class="lineno"> 1982</span> <span class="comment">// * {ASSERT|EXPECT}_STREQ(s1, s2): Tests that s1 == s2</span></div>
|
|
<div class="line"><a name="l01983"></a><span class="lineno"> 1983</span> <span class="comment">// * {ASSERT|EXPECT}_STRNE(s1, s2): Tests that s1 != s2</span></div>
|
|
<div class="line"><a name="l01984"></a><span class="lineno"> 1984</span> <span class="comment">// * {ASSERT|EXPECT}_STRCASEEQ(s1, s2): Tests that s1 == s2, ignoring case</span></div>
|
|
<div class="line"><a name="l01985"></a><span class="lineno"> 1985</span> <span class="comment">// * {ASSERT|EXPECT}_STRCASENE(s1, s2): Tests that s1 != s2, ignoring case</span></div>
|
|
<div class="line"><a name="l01986"></a><span class="lineno"> 1986</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01987"></a><span class="lineno"> 1987</span> <span class="comment">// For wide or narrow string objects, you can use the</span></div>
|
|
<div class="line"><a name="l01988"></a><span class="lineno"> 1988</span> <span class="comment">// {ASSERT|EXPECT}_??() macros.</span></div>
|
|
<div class="line"><a name="l01989"></a><span class="lineno"> 1989</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01990"></a><span class="lineno"> 1990</span> <span class="comment">// Don't depend on the order in which the arguments are evaluated,</span></div>
|
|
<div class="line"><a name="l01991"></a><span class="lineno"> 1991</span> <span class="comment">// which is undefined.</span></div>
|
|
<div class="line"><a name="l01992"></a><span class="lineno"> 1992</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l01993"></a><span class="lineno"> 1993</span> <span class="comment">// These macros evaluate their arguments exactly once.</span></div>
|
|
<div class="line"><a name="l01994"></a><span class="lineno"> 1994</span> </div>
|
|
<div class="line"><a name="l01995"></a><span class="lineno"> 1995</span> <span class="preprocessor">#define EXPECT_STREQ(s1, s2) \</span></div>
|
|
<div class="line"><a name="l01996"></a><span class="lineno"> 1996</span> <span class="preprocessor"> EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, s1, s2)</span></div>
|
|
<div class="line"><a name="l01997"></a><span class="lineno"> 1997</span> <span class="preprocessor"></span><span class="preprocessor">#define EXPECT_STRNE(s1, s2) \</span></div>
|
|
<div class="line"><a name="l01998"></a><span class="lineno"> 1998</span> <span class="preprocessor"> EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)</span></div>
|
|
<div class="line"><a name="l01999"></a><span class="lineno"> 1999</span> <span class="preprocessor"></span><span class="preprocessor">#define EXPECT_STRCASEEQ(s1, s2) \</span></div>
|
|
<div class="line"><a name="l02000"></a><span class="lineno"> 2000</span> <span class="preprocessor"> EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, s1, s2)</span></div>
|
|
<div class="line"><a name="l02001"></a><span class="lineno"> 2001</span> <span class="preprocessor"></span><span class="preprocessor">#define EXPECT_STRCASENE(s1, s2)\</span></div>
|
|
<div class="line"><a name="l02002"></a><span class="lineno"> 2002</span> <span class="preprocessor"> EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)</span></div>
|
|
<div class="line"><a name="l02003"></a><span class="lineno"> 2003</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02004"></a><span class="lineno"> 2004</span> <span class="preprocessor">#define ASSERT_STREQ(s1, s2) \</span></div>
|
|
<div class="line"><a name="l02005"></a><span class="lineno"> 2005</span> <span class="preprocessor"> ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, s1, s2)</span></div>
|
|
<div class="line"><a name="l02006"></a><span class="lineno"> 2006</span> <span class="preprocessor"></span><span class="preprocessor">#define ASSERT_STRNE(s1, s2) \</span></div>
|
|
<div class="line"><a name="l02007"></a><span class="lineno"> 2007</span> <span class="preprocessor"> ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)</span></div>
|
|
<div class="line"><a name="l02008"></a><span class="lineno"> 2008</span> <span class="preprocessor"></span><span class="preprocessor">#define ASSERT_STRCASEEQ(s1, s2) \</span></div>
|
|
<div class="line"><a name="l02009"></a><span class="lineno"> 2009</span> <span class="preprocessor"> ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, s1, s2)</span></div>
|
|
<div class="line"><a name="l02010"></a><span class="lineno"> 2010</span> <span class="preprocessor"></span><span class="preprocessor">#define ASSERT_STRCASENE(s1, s2)\</span></div>
|
|
<div class="line"><a name="l02011"></a><span class="lineno"> 2011</span> <span class="preprocessor"> ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)</span></div>
|
|
<div class="line"><a name="l02012"></a><span class="lineno"> 2012</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02013"></a><span class="lineno"> 2013</span> <span class="comment">// Macros for comparing floating-point numbers.</span></div>
|
|
<div class="line"><a name="l02014"></a><span class="lineno"> 2014</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02015"></a><span class="lineno"> 2015</span> <span class="comment">// * {ASSERT|EXPECT}_FLOAT_EQ(val1, val2):</span></div>
|
|
<div class="line"><a name="l02016"></a><span class="lineno"> 2016</span> <span class="comment">// Tests that two float values are almost equal.</span></div>
|
|
<div class="line"><a name="l02017"></a><span class="lineno"> 2017</span> <span class="comment">// * {ASSERT|EXPECT}_DOUBLE_EQ(val1, val2):</span></div>
|
|
<div class="line"><a name="l02018"></a><span class="lineno"> 2018</span> <span class="comment">// Tests that two double values are almost equal.</span></div>
|
|
<div class="line"><a name="l02019"></a><span class="lineno"> 2019</span> <span class="comment">// * {ASSERT|EXPECT}_NEAR(v1, v2, abs_error):</span></div>
|
|
<div class="line"><a name="l02020"></a><span class="lineno"> 2020</span> <span class="comment">// Tests that v1 and v2 are within the given distance to each other.</span></div>
|
|
<div class="line"><a name="l02021"></a><span class="lineno"> 2021</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02022"></a><span class="lineno"> 2022</span> <span class="comment">// Google Test uses ULP-based comparison to automatically pick a default</span></div>
|
|
<div class="line"><a name="l02023"></a><span class="lineno"> 2023</span> <span class="comment">// error bound that is appropriate for the operands. See the</span></div>
|
|
<div class="line"><a name="l02024"></a><span class="lineno"> 2024</span> <span class="comment">// FloatingPoint template class in gtest-internal.h if you are</span></div>
|
|
<div class="line"><a name="l02025"></a><span class="lineno"> 2025</span> <span class="comment">// interested in the implementation details.</span></div>
|
|
<div class="line"><a name="l02026"></a><span class="lineno"> 2026</span> </div>
|
|
<div class="line"><a name="l02027"></a><span class="lineno"> 2027</span> <span class="preprocessor">#define EXPECT_FLOAT_EQ(val1, val2)\</span></div>
|
|
<div class="line"><a name="l02028"></a><span class="lineno"> 2028</span> <span class="preprocessor"> EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<float>, \</span></div>
|
|
<div class="line"><a name="l02029"></a><span class="lineno"> 2029</span> <span class="preprocessor"> val1, val2)</span></div>
|
|
<div class="line"><a name="l02030"></a><span class="lineno"> 2030</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02031"></a><span class="lineno"> 2031</span> <span class="preprocessor">#define EXPECT_DOUBLE_EQ(val1, val2)\</span></div>
|
|
<div class="line"><a name="l02032"></a><span class="lineno"> 2032</span> <span class="preprocessor"> EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<double>, \</span></div>
|
|
<div class="line"><a name="l02033"></a><span class="lineno"> 2033</span> <span class="preprocessor"> val1, val2)</span></div>
|
|
<div class="line"><a name="l02034"></a><span class="lineno"> 2034</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02035"></a><span class="lineno"> 2035</span> <span class="preprocessor">#define ASSERT_FLOAT_EQ(val1, val2)\</span></div>
|
|
<div class="line"><a name="l02036"></a><span class="lineno"> 2036</span> <span class="preprocessor"> ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<float>, \</span></div>
|
|
<div class="line"><a name="l02037"></a><span class="lineno"> 2037</span> <span class="preprocessor"> val1, val2)</span></div>
|
|
<div class="line"><a name="l02038"></a><span class="lineno"> 2038</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02039"></a><span class="lineno"> 2039</span> <span class="preprocessor">#define ASSERT_DOUBLE_EQ(val1, val2)\</span></div>
|
|
<div class="line"><a name="l02040"></a><span class="lineno"> 2040</span> <span class="preprocessor"> ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ<double>, \</span></div>
|
|
<div class="line"><a name="l02041"></a><span class="lineno"> 2041</span> <span class="preprocessor"> val1, val2)</span></div>
|
|
<div class="line"><a name="l02042"></a><span class="lineno"> 2042</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02043"></a><span class="lineno"> 2043</span> <span class="preprocessor">#define EXPECT_NEAR(val1, val2, abs_error)\</span></div>
|
|
<div class="line"><a name="l02044"></a><span class="lineno"> 2044</span> <span class="preprocessor"> EXPECT_PRED_FORMAT3(::testing::internal::DoubleNearPredFormat, \</span></div>
|
|
<div class="line"><a name="l02045"></a><span class="lineno"> 2045</span> <span class="preprocessor"> val1, val2, abs_error)</span></div>
|
|
<div class="line"><a name="l02046"></a><span class="lineno"> 2046</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02047"></a><span class="lineno"> 2047</span> <span class="preprocessor">#define ASSERT_NEAR(val1, val2, abs_error)\</span></div>
|
|
<div class="line"><a name="l02048"></a><span class="lineno"> 2048</span> <span class="preprocessor"> ASSERT_PRED_FORMAT3(::testing::internal::DoubleNearPredFormat, \</span></div>
|
|
<div class="line"><a name="l02049"></a><span class="lineno"> 2049</span> <span class="preprocessor"> val1, val2, abs_error)</span></div>
|
|
<div class="line"><a name="l02050"></a><span class="lineno"> 2050</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02051"></a><span class="lineno"> 2051</span> <span class="comment">// These predicate format functions work on floating-point values, and</span></div>
|
|
<div class="line"><a name="l02052"></a><span class="lineno"> 2052</span> <span class="comment">// can be used in {ASSERT|EXPECT}_PRED_FORMAT2*(), e.g.</span></div>
|
|
<div class="line"><a name="l02053"></a><span class="lineno"> 2053</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02054"></a><span class="lineno"> 2054</span> <span class="comment">// EXPECT_PRED_FORMAT2(testing::DoubleLE, Foo(), 5.0);</span></div>
|
|
<div class="line"><a name="l02055"></a><span class="lineno"> 2055</span> </div>
|
|
<div class="line"><a name="l02056"></a><span class="lineno"> 2056</span> <span class="comment">// Asserts that val1 is less than, or almost equal to, val2. Fails</span></div>
|
|
<div class="line"><a name="l02057"></a><span class="lineno"> 2057</span> <span class="comment">// otherwise. In particular, it fails if either val1 or val2 is NaN.</span></div>
|
|
<div class="line"><a name="l02058"></a><span class="lineno"> 2058</span> GTEST_API_ AssertionResult FloatLE(<span class="keyword">const</span> <span class="keywordtype">char</span>* expr1, <span class="keyword">const</span> <span class="keywordtype">char</span>* expr2,</div>
|
|
<div class="line"><a name="l02059"></a><span class="lineno"> 2059</span>  <span class="keywordtype">float</span> val1, <span class="keywordtype">float</span> val2);</div>
|
|
<div class="line"><a name="l02060"></a><span class="lineno"> 2060</span> GTEST_API_ AssertionResult DoubleLE(<span class="keyword">const</span> <span class="keywordtype">char</span>* expr1, <span class="keyword">const</span> <span class="keywordtype">char</span>* expr2,</div>
|
|
<div class="line"><a name="l02061"></a><span class="lineno"> 2061</span>  <span class="keywordtype">double</span> val1, <span class="keywordtype">double</span> val2);</div>
|
|
<div class="line"><a name="l02062"></a><span class="lineno"> 2062</span> </div>
|
|
<div class="line"><a name="l02063"></a><span class="lineno"> 2063</span> </div>
|
|
<div class="line"><a name="l02064"></a><span class="lineno"> 2064</span> <span class="preprocessor">#if GTEST_OS_WINDOWS</span></div>
|
|
<div class="line"><a name="l02065"></a><span class="lineno"> 2065</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02066"></a><span class="lineno"> 2066</span> <span class="comment">// Macros that test for HRESULT failure and success, these are only useful</span></div>
|
|
<div class="line"><a name="l02067"></a><span class="lineno"> 2067</span> <span class="comment">// on Windows, and rely on Windows SDK macros and APIs to compile.</span></div>
|
|
<div class="line"><a name="l02068"></a><span class="lineno"> 2068</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02069"></a><span class="lineno"> 2069</span> <span class="comment">// * {ASSERT|EXPECT}_HRESULT_{SUCCEEDED|FAILED}(expr)</span></div>
|
|
<div class="line"><a name="l02070"></a><span class="lineno"> 2070</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02071"></a><span class="lineno"> 2071</span> <span class="comment">// When expr unexpectedly fails or succeeds, Google Test prints the</span></div>
|
|
<div class="line"><a name="l02072"></a><span class="lineno"> 2072</span> <span class="comment">// expected result and the actual result with both a human-readable</span></div>
|
|
<div class="line"><a name="l02073"></a><span class="lineno"> 2073</span> <span class="comment">// string representation of the error, if available, as well as the</span></div>
|
|
<div class="line"><a name="l02074"></a><span class="lineno"> 2074</span> <span class="comment">// hex result code.</span></div>
|
|
<div class="line"><a name="l02075"></a><span class="lineno"> 2075</span> <span class="preprocessor"># define EXPECT_HRESULT_SUCCEEDED(expr) \</span></div>
|
|
<div class="line"><a name="l02076"></a><span class="lineno"> 2076</span> <span class="preprocessor"> EXPECT_PRED_FORMAT1(::testing::internal::IsHRESULTSuccess, (expr))</span></div>
|
|
<div class="line"><a name="l02077"></a><span class="lineno"> 2077</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02078"></a><span class="lineno"> 2078</span> <span class="preprocessor"># define ASSERT_HRESULT_SUCCEEDED(expr) \</span></div>
|
|
<div class="line"><a name="l02079"></a><span class="lineno"> 2079</span> <span class="preprocessor"> ASSERT_PRED_FORMAT1(::testing::internal::IsHRESULTSuccess, (expr))</span></div>
|
|
<div class="line"><a name="l02080"></a><span class="lineno"> 2080</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02081"></a><span class="lineno"> 2081</span> <span class="preprocessor"># define EXPECT_HRESULT_FAILED(expr) \</span></div>
|
|
<div class="line"><a name="l02082"></a><span class="lineno"> 2082</span> <span class="preprocessor"> EXPECT_PRED_FORMAT1(::testing::internal::IsHRESULTFailure, (expr))</span></div>
|
|
<div class="line"><a name="l02083"></a><span class="lineno"> 2083</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02084"></a><span class="lineno"> 2084</span> <span class="preprocessor"># define ASSERT_HRESULT_FAILED(expr) \</span></div>
|
|
<div class="line"><a name="l02085"></a><span class="lineno"> 2085</span> <span class="preprocessor"> ASSERT_PRED_FORMAT1(::testing::internal::IsHRESULTFailure, (expr))</span></div>
|
|
<div class="line"><a name="l02086"></a><span class="lineno"> 2086</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02087"></a><span class="lineno"> 2087</span> <span class="preprocessor">#endif // GTEST_OS_WINDOWS</span></div>
|
|
<div class="line"><a name="l02088"></a><span class="lineno"> 2088</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02089"></a><span class="lineno"> 2089</span> <span class="comment">// Macros that execute statement and check that it doesn't generate new fatal</span></div>
|
|
<div class="line"><a name="l02090"></a><span class="lineno"> 2090</span> <span class="comment">// failures in the current thread.</span></div>
|
|
<div class="line"><a name="l02091"></a><span class="lineno"> 2091</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02092"></a><span class="lineno"> 2092</span> <span class="comment">// * {ASSERT|EXPECT}_NO_FATAL_FAILURE(statement);</span></div>
|
|
<div class="line"><a name="l02093"></a><span class="lineno"> 2093</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02094"></a><span class="lineno"> 2094</span> <span class="comment">// Examples:</span></div>
|
|
<div class="line"><a name="l02095"></a><span class="lineno"> 2095</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02096"></a><span class="lineno"> 2096</span> <span class="comment">// EXPECT_NO_FATAL_FAILURE(Process());</span></div>
|
|
<div class="line"><a name="l02097"></a><span class="lineno"> 2097</span> <span class="comment">// ASSERT_NO_FATAL_FAILURE(Process()) << "Process() failed";</span></div>
|
|
<div class="line"><a name="l02098"></a><span class="lineno"> 2098</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02099"></a><span class="lineno"> 2099</span> <span class="preprocessor">#define ASSERT_NO_FATAL_FAILURE(statement) \</span></div>
|
|
<div class="line"><a name="l02100"></a><span class="lineno"> 2100</span> <span class="preprocessor"> GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_FATAL_FAILURE_)</span></div>
|
|
<div class="line"><a name="l02101"></a><span class="lineno"> 2101</span> <span class="preprocessor"></span><span class="preprocessor">#define EXPECT_NO_FATAL_FAILURE(statement) \</span></div>
|
|
<div class="line"><a name="l02102"></a><span class="lineno"> 2102</span> <span class="preprocessor"> GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_NONFATAL_FAILURE_)</span></div>
|
|
<div class="line"><a name="l02103"></a><span class="lineno"> 2103</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02104"></a><span class="lineno"> 2104</span> <span class="comment">// Causes a trace (including the source file path, the current line</span></div>
|
|
<div class="line"><a name="l02105"></a><span class="lineno"> 2105</span> <span class="comment">// number, and the given message) to be included in every test failure</span></div>
|
|
<div class="line"><a name="l02106"></a><span class="lineno"> 2106</span> <span class="comment">// message generated by code in the current scope. The effect is</span></div>
|
|
<div class="line"><a name="l02107"></a><span class="lineno"> 2107</span> <span class="comment">// undone when the control leaves the current scope.</span></div>
|
|
<div class="line"><a name="l02108"></a><span class="lineno"> 2108</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02109"></a><span class="lineno"> 2109</span> <span class="comment">// The message argument can be anything streamable to std::ostream.</span></div>
|
|
<div class="line"><a name="l02110"></a><span class="lineno"> 2110</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02111"></a><span class="lineno"> 2111</span> <span class="comment">// In the implementation, we include the current line number as part</span></div>
|
|
<div class="line"><a name="l02112"></a><span class="lineno"> 2112</span> <span class="comment">// of the dummy variable name, thus allowing multiple SCOPED_TRACE()s</span></div>
|
|
<div class="line"><a name="l02113"></a><span class="lineno"> 2113</span> <span class="comment">// to appear in the same block - as long as they are on different</span></div>
|
|
<div class="line"><a name="l02114"></a><span class="lineno"> 2114</span> <span class="comment">// lines.</span></div>
|
|
<div class="line"><a name="l02115"></a><span class="lineno"> 2115</span> <span class="preprocessor">#define SCOPED_TRACE(message) \</span></div>
|
|
<div class="line"><a name="l02116"></a><span class="lineno"> 2116</span> <span class="preprocessor"> ::testing::internal::ScopedTrace GTEST_CONCAT_TOKEN_(gtest_trace_, __LINE__)(\</span></div>
|
|
<div class="line"><a name="l02117"></a><span class="lineno"> 2117</span> <span class="preprocessor"> __FILE__, __LINE__, ::testing::Message() << (message))</span></div>
|
|
<div class="line"><a name="l02118"></a><span class="lineno"> 2118</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02119"></a><span class="lineno"> 2119</span> <span class="comment">// Compile-time assertion for type equality.</span></div>
|
|
<div class="line"><a name="l02120"></a><span class="lineno"> 2120</span> <span class="comment">// StaticAssertTypeEq<type1, type2>() compiles iff type1 and type2 are</span></div>
|
|
<div class="line"><a name="l02121"></a><span class="lineno"> 2121</span> <span class="comment">// the same type. The value it returns is not interesting.</span></div>
|
|
<div class="line"><a name="l02122"></a><span class="lineno"> 2122</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02123"></a><span class="lineno"> 2123</span> <span class="comment">// Instead of making StaticAssertTypeEq a class template, we make it a</span></div>
|
|
<div class="line"><a name="l02124"></a><span class="lineno"> 2124</span> <span class="comment">// function template that invokes a helper class template. This</span></div>
|
|
<div class="line"><a name="l02125"></a><span class="lineno"> 2125</span> <span class="comment">// prevents a user from misusing StaticAssertTypeEq<T1, T2> by</span></div>
|
|
<div class="line"><a name="l02126"></a><span class="lineno"> 2126</span> <span class="comment">// defining objects of that type.</span></div>
|
|
<div class="line"><a name="l02127"></a><span class="lineno"> 2127</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02128"></a><span class="lineno"> 2128</span> <span class="comment">// CAVEAT:</span></div>
|
|
<div class="line"><a name="l02129"></a><span class="lineno"> 2129</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02130"></a><span class="lineno"> 2130</span> <span class="comment">// When used inside a method of a class template,</span></div>
|
|
<div class="line"><a name="l02131"></a><span class="lineno"> 2131</span> <span class="comment">// StaticAssertTypeEq<T1, T2>() is effective ONLY IF the method is</span></div>
|
|
<div class="line"><a name="l02132"></a><span class="lineno"> 2132</span> <span class="comment">// instantiated. For example, given:</span></div>
|
|
<div class="line"><a name="l02133"></a><span class="lineno"> 2133</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02134"></a><span class="lineno"> 2134</span> <span class="comment">// template <typename T> class Foo {</span></div>
|
|
<div class="line"><a name="l02135"></a><span class="lineno"> 2135</span> <span class="comment">// public:</span></div>
|
|
<div class="line"><a name="l02136"></a><span class="lineno"> 2136</span> <span class="comment">// void Bar() { testing::StaticAssertTypeEq<int, T>(); }</span></div>
|
|
<div class="line"><a name="l02137"></a><span class="lineno"> 2137</span> <span class="comment">// };</span></div>
|
|
<div class="line"><a name="l02138"></a><span class="lineno"> 2138</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02139"></a><span class="lineno"> 2139</span> <span class="comment">// the code:</span></div>
|
|
<div class="line"><a name="l02140"></a><span class="lineno"> 2140</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02141"></a><span class="lineno"> 2141</span> <span class="comment">// void Test1() { Foo<bool> foo; }</span></div>
|
|
<div class="line"><a name="l02142"></a><span class="lineno"> 2142</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02143"></a><span class="lineno"> 2143</span> <span class="comment">// will NOT generate a compiler error, as Foo<bool>::Bar() is never</span></div>
|
|
<div class="line"><a name="l02144"></a><span class="lineno"> 2144</span> <span class="comment">// actually instantiated. Instead, you need:</span></div>
|
|
<div class="line"><a name="l02145"></a><span class="lineno"> 2145</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02146"></a><span class="lineno"> 2146</span> <span class="comment">// void Test2() { Foo<bool> foo; foo.Bar(); }</span></div>
|
|
<div class="line"><a name="l02147"></a><span class="lineno"> 2147</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02148"></a><span class="lineno"> 2148</span> <span class="comment">// to cause a compiler error.</span></div>
|
|
<div class="line"><a name="l02149"></a><span class="lineno"> 2149</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T1, <span class="keyword">typename</span> T2></div>
|
|
<div class="line"><a name="l02150"></a><span class="lineno"> 2150</span> <span class="keywordtype">bool</span> StaticAssertTypeEq() {</div>
|
|
<div class="line"><a name="l02151"></a><span class="lineno"> 2151</span>  (void)internal::StaticAssertTypeEqHelper<T1, T2>();</div>
|
|
<div class="line"><a name="l02152"></a><span class="lineno"> 2152</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
|
|
<div class="line"><a name="l02153"></a><span class="lineno"> 2153</span> }</div>
|
|
<div class="line"><a name="l02154"></a><span class="lineno"> 2154</span> </div>
|
|
<div class="line"><a name="l02155"></a><span class="lineno"> 2155</span> <span class="comment">// Defines a test.</span></div>
|
|
<div class="line"><a name="l02156"></a><span class="lineno"> 2156</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02157"></a><span class="lineno"> 2157</span> <span class="comment">// The first parameter is the name of the test case, and the second</span></div>
|
|
<div class="line"><a name="l02158"></a><span class="lineno"> 2158</span> <span class="comment">// parameter is the name of the test within the test case.</span></div>
|
|
<div class="line"><a name="l02159"></a><span class="lineno"> 2159</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02160"></a><span class="lineno"> 2160</span> <span class="comment">// The convention is to end the test case name with "Test". For</span></div>
|
|
<div class="line"><a name="l02161"></a><span class="lineno"> 2161</span> <span class="comment">// example, a test case for the Foo class can be named FooTest.</span></div>
|
|
<div class="line"><a name="l02162"></a><span class="lineno"> 2162</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02163"></a><span class="lineno"> 2163</span> <span class="comment">// Test code should appear between braces after an invocation of</span></div>
|
|
<div class="line"><a name="l02164"></a><span class="lineno"> 2164</span> <span class="comment">// this macro. Example:</span></div>
|
|
<div class="line"><a name="l02165"></a><span class="lineno"> 2165</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02166"></a><span class="lineno"> 2166</span> <span class="comment">// TEST(FooTest, InitializesCorrectly) {</span></div>
|
|
<div class="line"><a name="l02167"></a><span class="lineno"> 2167</span> <span class="comment">// Foo foo;</span></div>
|
|
<div class="line"><a name="l02168"></a><span class="lineno"> 2168</span> <span class="comment">// EXPECT_TRUE(foo.StatusIsOK());</span></div>
|
|
<div class="line"><a name="l02169"></a><span class="lineno"> 2169</span> <span class="comment">// }</span></div>
|
|
<div class="line"><a name="l02170"></a><span class="lineno"> 2170</span> </div>
|
|
<div class="line"><a name="l02171"></a><span class="lineno"> 2171</span> <span class="comment">// Note that we call GetTestTypeId() instead of GetTypeId<</span></div>
|
|
<div class="line"><a name="l02172"></a><span class="lineno"> 2172</span> <span class="comment">// ::testing::Test>() here to get the type ID of testing::Test. This</span></div>
|
|
<div class="line"><a name="l02173"></a><span class="lineno"> 2173</span> <span class="comment">// is to work around a suspected linker bug when using Google Test as</span></div>
|
|
<div class="line"><a name="l02174"></a><span class="lineno"> 2174</span> <span class="comment">// a framework on Mac OS X. The bug causes GetTypeId<</span></div>
|
|
<div class="line"><a name="l02175"></a><span class="lineno"> 2175</span> <span class="comment">// ::testing::Test>() to return different values depending on whether</span></div>
|
|
<div class="line"><a name="l02176"></a><span class="lineno"> 2176</span> <span class="comment">// the call is from the Google Test framework itself or from user test</span></div>
|
|
<div class="line"><a name="l02177"></a><span class="lineno"> 2177</span> <span class="comment">// code. GetTestTypeId() is guaranteed to always return the same</span></div>
|
|
<div class="line"><a name="l02178"></a><span class="lineno"> 2178</span> <span class="comment">// value, as it always calls GetTypeId<>() from the Google Test</span></div>
|
|
<div class="line"><a name="l02179"></a><span class="lineno"> 2179</span> <span class="comment">// framework.</span></div>
|
|
<div class="line"><a name="l02180"></a><span class="lineno"> 2180</span> <span class="preprocessor">#define GTEST_TEST(test_case_name, test_name)\</span></div>
|
|
<div class="line"><a name="l02181"></a><span class="lineno"> 2181</span> <span class="preprocessor"> GTEST_TEST_(test_case_name, test_name, \</span></div>
|
|
<div class="line"><a name="l02182"></a><span class="lineno"> 2182</span> <span class="preprocessor"> ::testing::Test, ::testing::internal::GetTestTypeId())</span></div>
|
|
<div class="line"><a name="l02183"></a><span class="lineno"> 2183</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02184"></a><span class="lineno"> 2184</span> <span class="comment">// Define this macro to 1 to omit the definition of TEST(), which</span></div>
|
|
<div class="line"><a name="l02185"></a><span class="lineno"> 2185</span> <span class="comment">// is a generic name and clashes with some other libraries.</span></div>
|
|
<div class="line"><a name="l02186"></a><span class="lineno"> 2186</span> <span class="preprocessor">#if !GTEST_DONT_DEFINE_TEST</span></div>
|
|
<div class="line"><a name="l02187"></a><span class="lineno"> 2187</span> <span class="preprocessor"></span><span class="preprocessor"># define TEST(test_case_name, test_name) GTEST_TEST(test_case_name, test_name)</span></div>
|
|
<div class="line"><a name="l02188"></a><span class="lineno"> 2188</span> <span class="preprocessor"></span><span class="preprocessor">#endif</span></div>
|
|
<div class="line"><a name="l02189"></a><span class="lineno"> 2189</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02190"></a><span class="lineno"> 2190</span> <span class="comment">// Defines a test that uses a test fixture.</span></div>
|
|
<div class="line"><a name="l02191"></a><span class="lineno"> 2191</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02192"></a><span class="lineno"> 2192</span> <span class="comment">// The first parameter is the name of the test fixture class, which</span></div>
|
|
<div class="line"><a name="l02193"></a><span class="lineno"> 2193</span> <span class="comment">// also doubles as the test case name. The second parameter is the</span></div>
|
|
<div class="line"><a name="l02194"></a><span class="lineno"> 2194</span> <span class="comment">// name of the test within the test case.</span></div>
|
|
<div class="line"><a name="l02195"></a><span class="lineno"> 2195</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02196"></a><span class="lineno"> 2196</span> <span class="comment">// A test fixture class must be declared earlier. The user should put</span></div>
|
|
<div class="line"><a name="l02197"></a><span class="lineno"> 2197</span> <span class="comment">// his test code between braces after using this macro. Example:</span></div>
|
|
<div class="line"><a name="l02198"></a><span class="lineno"> 2198</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02199"></a><span class="lineno"> 2199</span> <span class="comment">// class FooTest : public testing::Test {</span></div>
|
|
<div class="line"><a name="l02200"></a><span class="lineno"> 2200</span> <span class="comment">// protected:</span></div>
|
|
<div class="line"><a name="l02201"></a><span class="lineno"> 2201</span> <span class="comment">// virtual void SetUp() { b_.AddElement(3); }</span></div>
|
|
<div class="line"><a name="l02202"></a><span class="lineno"> 2202</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02203"></a><span class="lineno"> 2203</span> <span class="comment">// Foo a_;</span></div>
|
|
<div class="line"><a name="l02204"></a><span class="lineno"> 2204</span> <span class="comment">// Foo b_;</span></div>
|
|
<div class="line"><a name="l02205"></a><span class="lineno"> 2205</span> <span class="comment">// };</span></div>
|
|
<div class="line"><a name="l02206"></a><span class="lineno"> 2206</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02207"></a><span class="lineno"> 2207</span> <span class="comment">// TEST_F(FooTest, InitializesCorrectly) {</span></div>
|
|
<div class="line"><a name="l02208"></a><span class="lineno"> 2208</span> <span class="comment">// EXPECT_TRUE(a_.StatusIsOK());</span></div>
|
|
<div class="line"><a name="l02209"></a><span class="lineno"> 2209</span> <span class="comment">// }</span></div>
|
|
<div class="line"><a name="l02210"></a><span class="lineno"> 2210</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02211"></a><span class="lineno"> 2211</span> <span class="comment">// TEST_F(FooTest, ReturnsElementCountCorrectly) {</span></div>
|
|
<div class="line"><a name="l02212"></a><span class="lineno"> 2212</span> <span class="comment">// EXPECT_EQ(0, a_.size());</span></div>
|
|
<div class="line"><a name="l02213"></a><span class="lineno"> 2213</span> <span class="comment">// EXPECT_EQ(1, b_.size());</span></div>
|
|
<div class="line"><a name="l02214"></a><span class="lineno"> 2214</span> <span class="comment">// }</span></div>
|
|
<div class="line"><a name="l02215"></a><span class="lineno"> 2215</span> </div>
|
|
<div class="line"><a name="l02216"></a><span class="lineno"> 2216</span> <span class="preprocessor">#define TEST_F(test_fixture, test_name)\</span></div>
|
|
<div class="line"><a name="l02217"></a><span class="lineno"> 2217</span> <span class="preprocessor"> GTEST_TEST_(test_fixture, test_name, test_fixture, \</span></div>
|
|
<div class="line"><a name="l02218"></a><span class="lineno"> 2218</span> <span class="preprocessor"> ::testing::internal::GetTypeId<test_fixture>())</span></div>
|
|
<div class="line"><a name="l02219"></a><span class="lineno"> 2219</span> <span class="preprocessor"></span></div>
|
|
<div class="line"><a name="l02220"></a><span class="lineno"> 2220</span> } <span class="comment">// namespace testing</span></div>
|
|
<div class="line"><a name="l02221"></a><span class="lineno"> 2221</span> </div>
|
|
<div class="line"><a name="l02222"></a><span class="lineno"> 2222</span> <span class="comment">// Use this function in main() to run all tests. It returns 0 if all</span></div>
|
|
<div class="line"><a name="l02223"></a><span class="lineno"> 2223</span> <span class="comment">// tests are successful, or 1 otherwise.</span></div>
|
|
<div class="line"><a name="l02224"></a><span class="lineno"> 2224</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02225"></a><span class="lineno"> 2225</span> <span class="comment">// RUN_ALL_TESTS() should be invoked after the command line has been</span></div>
|
|
<div class="line"><a name="l02226"></a><span class="lineno"> 2226</span> <span class="comment">// parsed by InitGoogleTest().</span></div>
|
|
<div class="line"><a name="l02227"></a><span class="lineno"> 2227</span> <span class="comment">//</span></div>
|
|
<div class="line"><a name="l02228"></a><span class="lineno"> 2228</span> <span class="comment">// This function was formerly a macro; thus, it is in the global</span></div>
|
|
<div class="line"><a name="l02229"></a><span class="lineno"> 2229</span> <span class="comment">// namespace and has an all-caps name.</span></div>
|
|
<div class="line"><a name="l02230"></a><span class="lineno"> 2230</span> <span class="keywordtype">int</span> RUN_ALL_TESTS() GTEST_MUST_USE_RESULT_;</div>
|
|
<div class="line"><a name="l02231"></a><span class="lineno"> 2231</span> </div>
|
|
<div class="line"><a name="l02232"></a><span class="lineno"> 2232</span> inline <span class="keywordtype">int</span> RUN_ALL_TESTS() {</div>
|
|
<div class="line"><a name="l02233"></a><span class="lineno"> 2233</span>  return ::testing::UnitTest::GetInstance()->Run();</div>
|
|
<div class="line"><a name="l02234"></a><span class="lineno"> 2234</span> }</div>
|
|
<div class="line"><a name="l02235"></a><span class="lineno"> 2235</span> </div>
|
|
<div class="line"><a name="l02236"></a><span class="lineno"> 2236</span> <span class="preprocessor">#endif // GTEST_INCLUDE_GTEST_GTEST_H_</span></div>
|
|
<div class="ttc" id="classtesting_1_1TestResult_html"><div class="ttname"><a href="classtesting_1_1TestResult.html">testing::TestResult</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l00523">gtest.h:523</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1internal_1_1DefaultGlobalTestPartResultReporter_html"><div class="ttname"><a href="classtesting_1_1internal_1_1DefaultGlobalTestPartResultReporter.html">testing::internal::DefaultGlobalTestPartResultReporter</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-internal-inl_8h_source.html#l00465">gtest-internal-inl.h:465</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1internal_1_1AssertHelper_html"><div class="ttname"><a href="classtesting_1_1internal_1_1AssertHelper.html">testing::internal::AssertHelper</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l01668">gtest.h:1668</a></div></div>
|
|
<div class="ttc" id="structtesting_1_1internal_1_1is__pointer_html"><div class="ttname"><a href="structtesting_1_1internal_1_1is__pointer.html">testing::internal::is_pointer</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-port_8h_source.html#l02213">gtest-port.h:2213</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1internal_1_1Random_html"><div class="ttname"><a href="classtesting_1_1internal_1_1Random.html">testing::internal::Random</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-internal_8h_source.html#l00752">gtest-internal.h:752</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1TestEventListeners_html"><div class="ttname"><a href="classtesting_1_1TestEventListeners.html">testing::TestEventListeners</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l01064">gtest.h:1064</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1Message_html"><div class="ttname"><a href="classtesting_1_1Message.html">testing::Message</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-message_8h_source.html#l00085">gtest-message.h:85</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1internal_1_1TestFactoryBase_html"><div class="ttname"><a href="classtesting_1_1internal_1_1TestFactoryBase.html">testing::internal::TestFactoryBase</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-internal_8h_source.html#l00464">gtest-internal.h:464</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1UnitTest_html"><div class="ttname"><a href="classtesting_1_1UnitTest.html">testing::UnitTest</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l01151">gtest.h:1151</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1TestEventListener_html"><div class="ttname"><a href="classtesting_1_1TestEventListener.html">testing::TestEventListener</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l00991">gtest.h:991</a></div></div>
|
|
<div class="ttc" id="structtesting_1_1internal_1_1CodeLocation_html"><div class="ttname"><a href="structtesting_1_1internal_1_1CodeLocation.html">testing::internal::CodeLocation</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-internal_8h_source.html#l00504">gtest-internal.h:504</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1Test_html"><div class="ttname"><a href="classtesting_1_1Test.html">testing::Test</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l00371">gtest.h:371</a></div></div>
|
|
<div class="ttc" id="structtesting_1_1internal_1_1EnableIf_html"><div class="ttname"><a href="structtesting_1_1internal_1_1EnableIf.html">testing::internal::EnableIf</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-internal_8h_source.html#l00946">gtest-internal.h:946</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1internal_1_1Mutex_html"><div class="ttname"><a href="classtesting_1_1internal_1_1Mutex.html">testing::internal::Mutex</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-port_8h_source.html#l02136">gtest-port.h:2136</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1TestPartResult_html"><div class="ttname"><a href="classtesting_1_1TestPartResult.html">testing::TestPartResult</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-test-part_8h_source.html#l00047">gtest-test-part.h:47</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1internal_1_1EqHelper_html"><div class="ttname"><a href="classtesting_1_1internal_1_1EqHelper.html">testing::internal::EqHelper</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l01413">gtest.h:1413</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1TestProperty_html"><div class="ttname"><a href="classtesting_1_1TestProperty.html">testing::TestProperty</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l00486">gtest.h:486</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1internal_1_1ImplicitlyConvertible_html"><div class="ttname"><a href="classtesting_1_1internal_1_1ImplicitlyConvertible.html">testing::internal::ImplicitlyConvertible</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-internal_8h_source.html#l00855">gtest-internal.h:855</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1Environment_html"><div class="ttname"><a href="classtesting_1_1Environment.html">testing::Environment</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l00972">gtest.h:972</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1internal_1_1ScopedTrace_html"><div class="ttname"><a href="classtesting_1_1internal_1_1ScopedTrace.html">testing::internal::ScopedTrace</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-internal_8h_source.html#l00156">gtest-internal.h:156</a></div></div>
|
|
<div class="ttc" id="structtesting_1_1internal_1_1TraceInfo_html"><div class="ttname"><a href="structtesting_1_1internal_1_1TraceInfo.html">testing::internal::TraceInfo</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-internal-inl_8h_source.html#l00457">gtest-internal-inl.h:457</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1internal_1_1UnitTestImpl_html"><div class="ttname"><a href="classtesting_1_1internal_1_1UnitTestImpl.html">testing::internal::UnitTestImpl</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-internal-inl_8h_source.html#l00499">gtest-internal-inl.h:499</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1internal_1_1TestResultAccessor_html"><div class="ttname"><a href="classtesting_1_1internal_1_1TestResultAccessor.html">testing::internal::TestResultAccessor</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-internal-inl_8h_source.html#l01014">gtest-internal-inl.h:1014</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1TestCase_html"><div class="ttname"><a href="classtesting_1_1TestCase.html">testing::TestCase</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l00778">gtest.h:778</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1EmptyTestEventListener_html"><div class="ttname"><a href="classtesting_1_1EmptyTestEventListener.html">testing::EmptyTestEventListener</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l01044">gtest.h:1044</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1AssertionResult_html"><div class="ttname"><a href="classtesting_1_1AssertionResult.html">testing::AssertionResult</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l00256">gtest.h:256</a></div></div>
|
|
<div class="ttc" id="classtesting_1_1internal_1_1scoped__ptr_html"><div class="ttname"><a href="classtesting_1_1internal_1_1scoped__ptr.html">testing::internal::scoped_ptr< ::std::string ></a></div></div>
|
|
<div class="ttc" id="classtesting_1_1TestInfo_html"><div class="ttname"><a href="classtesting_1_1TestInfo.html">testing::TestInfo</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest_8h_source.html#l00644">gtest.h:644</a></div></div>
|
|
</div><!-- fragment --></div><!-- contents -->
|
|
<!-- start footer part -->
|
|
<hr class="footer"/><address class="footer"><small>
|
|
Generated by  <a href="http://www.doxygen.org/index.html">
|
|
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
|
</a> 1.8.5
|
|
</small></address>
|
|
</body>
|
|
</html>
|