1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
<!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-message.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-message.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 Message class.</span></div>
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="comment">//</span></div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="comment">// IMPORTANT NOTE: Due to limitation of the C++ language, we have to</span></div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="comment">// leave some internal implementation details in this header file.</span></div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="comment">// They are clearly marked by comments like this:</span></div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="comment">//</span></div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="comment">// // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="comment">//</span></div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</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="l00043"></a><span class="lineno"> 43</span> <span class="comment">// to CHANGE WITHOUT NOTICE. Therefore DO NOT DEPEND ON IT in a user</span></div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment">// program!</span></div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span> </div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="preprocessor">#ifndef GTEST_INCLUDE_GTEST_GTEST_MESSAGE_H_</span></div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="preprocessor"></span><span class="preprocessor">#define GTEST_INCLUDE_GTEST_GTEST_MESSAGE_H_</span></div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="preprocessor">#include <limits></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">#include "gtest/internal/gtest-port.h"</span></div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span> </div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment">// Ensures that there is at least one operator<< in the global namespace.</span></div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment">// See Message& operator<<(...) below for why.</span></div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="keywordtype">void</span> operator<<(<span class="keyword">const</span> testing::internal::Secret&, <span class="keywordtype">int</span>);</div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span> </div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="keyword">namespace </span>testing {</div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span> </div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="comment">// The Message class works like an ostream repeater.</span></div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="comment">//</span></div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="comment">// Typical usage:</span></div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="comment">//</span></div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="comment">// 1. You stream a bunch of values to a Message object.</span></div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="comment">// It will remember the text in a stringstream.</span></div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="comment">// 2. Then you stream the Message object to an ostream.</span></div>
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="comment">// This causes the text in the Message to be streamed</span></div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span> <span class="comment">// to the ostream.</span></div>
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span> <span class="comment">//</span></div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="comment">// For example;</span></div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="comment">//</span></div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="comment">// testing::Message foo;</span></div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="comment">// foo << 1 << " != " << 2;</span></div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="comment">// std::cout << foo;</span></div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="comment">//</span></div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span> <span class="comment">// will print "1 != 2".</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">// Message is not intended to be inherited from. In particular, its</span></div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span> <span class="comment">// destructor is not virtual.</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">// Note that stringstream behaves differently in gcc and in MSVC. You</span></div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span> <span class="comment">// can stream a NULL char pointer to it in the former, but not in the</span></div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span> <span class="comment">// latter (it causes an access violation if you do). The Message</span></div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="comment">// class hides this difference by treating a NULL char pointer as</span></div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span> <span class="comment">// "(null)".</span></div>
<div class="line"><a name="l00085"></a><span class="lineno"><a class="line" href="classtesting_1_1Message.html"> 85</a></span> <span class="keyword">class </span>GTEST_API_ <a class="code" href="classtesting_1_1Message.html">Message</a> {</div>
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  <span class="keyword">private</span>:</div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  <span class="comment">// The type of basic IO manipulators (endl, ends, and flush) for</span></div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="comment">// narrow streams.</span></div>
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  <span class="keyword">typedef</span> std::ostream& (*BasicNarrowIoManip)(std::ostream&);</div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span> </div>
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  <span class="keyword">public</span>:</div>
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  <span class="comment">// Constructs an empty Message.</span></div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  <a class="code" href="classtesting_1_1Message.html">Message</a>();</div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span> </div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  <span class="comment">// Copy constructor.</span></div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  <a class="code" href="classtesting_1_1Message.html">Message</a>(<span class="keyword">const</span> <a class="code" href="classtesting_1_1Message.html">Message</a>& msg) : ss_(new ::std::stringstream) { <span class="comment">// NOLINT</span></div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  *ss_ << msg.GetString();</div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  }</div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span> </div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <span class="comment">// Constructs a Message from a C-string.</span></div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <span class="keyword">explicit</span> <a class="code" href="classtesting_1_1Message.html">Message</a>(<span class="keyword">const</span> <span class="keywordtype">char</span>* str) : ss_(new ::std::stringstream) {</div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  *ss_ << str;</div>
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  }</div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span> </div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span> <span class="preprocessor">#if GTEST_OS_SYMBIAN</span></div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span> <span class="preprocessor"></span> <span class="comment">// Streams a value (either a pointer or not) to this object.</span></div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="keyword">inline</span> <a class="code" href="classtesting_1_1Message.html">Message</a>& operator <<(<span class="keyword">const</span> T& value) {</div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  StreamHelper(<span class="keyword">typename</span> <a class="code" href="structtesting_1_1internal_1_1bool__constant.html">internal::is_pointer<T>::type</a>(), value);</div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  }</div>
<div class="line"><a name="l00112"></a><span class="lineno"> 112</span> <span class="preprocessor">#else</span></div>
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span> <span class="preprocessor"></span> <span class="comment">// Streams a non-pointer value to this object.</span></div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  <span class="keyword">inline</span> <a class="code" href="classtesting_1_1Message.html">Message</a>& operator <<(<span class="keyword">const</span> T& val) {</div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  <span class="comment">// Some libraries overload << for STL containers. These</span></div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  <span class="comment">// overloads are defined in the global namespace instead of ::std.</span></div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  <span class="comment">//</span></div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  <span class="comment">// C++'s symbol lookup rule (i.e. Koenig lookup) says that these</span></div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  <span class="comment">// overloads are visible in either the std namespace or the global</span></div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  <span class="comment">// namespace, but not other namespaces, including the testing</span></div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  <span class="comment">// namespace which Google Test's Message class is in.</span></div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <span class="comment">//</span></div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <span class="comment">// To allow STL containers (and other types that has a << operator</span></div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  <span class="comment">// defined in the global namespace) to be used in Google Test</span></div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  <span class="comment">// assertions, testing::Message must access the custom << operator</span></div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  <span class="comment">// from the global namespace. With this using declaration,</span></div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  <span class="comment">// overloads of << defined in the global namespace and those</span></div>
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  <span class="comment">// visible via Koenig lookup are both exposed in this function.</span></div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  using ::operator <<;</div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  *ss_ << val;</div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  }</div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span> </div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  <span class="comment">// Streams a pointer value to this object.</span></div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <span class="comment">//</span></div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  <span class="comment">// This function is an overload of the previous one. When you</span></div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  <span class="comment">// stream a pointer to a Message, this definition will be used as it</span></div>
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  <span class="comment">// is more specialized. (The C++ Standard, section</span></div>
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  <span class="comment">// [temp.func.order].) If you stream a non-pointer, then the</span></div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <span class="comment">// previous definition will be used.</span></div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  <span class="comment">//</span></div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  <span class="comment">// The reason for this overload is that streaming a NULL pointer to</span></div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  <span class="comment">// ostream is undefined behavior. Depending on the compiler, you</span></div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span>  <span class="comment">// may get "0", "(nil)", "(null)", or an access violation. To</span></div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  <span class="comment">// ensure consistent result across compilers, we always treat NULL</span></div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="comment">// as "(null)".</span></div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  <span class="keyword">inline</span> <a class="code" href="classtesting_1_1Message.html">Message</a>& operator <<(T* <span class="keyword">const</span>& pointer) { <span class="comment">// NOLINT</span></div>
<div class="line"><a name="l00150"></a><span class="lineno"> 150</span>  <span class="keywordflow">if</span> (pointer == NULL) {</div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  *ss_ << <span class="stringliteral">"(null)"</span>;</div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  } <span class="keywordflow">else</span> {</div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  *ss_ << pointer;</div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  }</div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  }</div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span> <span class="preprocessor">#endif // GTEST_OS_SYMBIAN</span></div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="comment">// Since the basic IO manipulators are overloaded for both narrow</span></div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <span class="comment">// and wide streams, we have to provide this specialized definition</span></div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  <span class="comment">// of operator <<, even though its body is the same as the</span></div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <span class="comment">// templatized version above. Without this definition, streaming</span></div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  <span class="comment">// endl or other basic IO manipulators to Message will confuse the</span></div>
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  <span class="comment">// compiler.</span></div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  <a class="code" href="classtesting_1_1Message.html">Message</a>& operator <<(BasicNarrowIoManip val) {</div>
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  *ss_ << val;</div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <span class="keywordflow">return</span> *<span class="keyword">this</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> </div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  <span class="comment">// Instead of 1/0, we want to see true/false for bool values.</span></div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  <a class="code" href="classtesting_1_1Message.html">Message</a>& operator <<(<span class="keywordtype">bool</span> b) {</div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span> << (b ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>);</div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  }</div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span> </div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <span class="comment">// These two overloads allow streaming a wide C string to a Message</span></div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  <span class="comment">// using the UTF-8 encoding.</span></div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <a class="code" href="classtesting_1_1Message.html">Message</a>& operator <<(<span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* wide_c_str);</div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <a class="code" href="classtesting_1_1Message.html">Message</a>& operator <<(<span class="keywordtype">wchar_t</span>* wide_c_str);</div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span> </div>
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span> <span class="preprocessor">#if GTEST_HAS_STD_WSTRING</span></div>
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span> <span class="preprocessor"></span> <span class="comment">// Converts the given wide string to a narrow string using the UTF-8</span></div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <span class="comment">// encoding, and streams the result to this Message object.</span></div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  <a class="code" href="classtesting_1_1Message.html">Message</a>& operator <<(const ::std::wstring& wstr);</div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span> <span class="preprocessor">#endif // GTEST_HAS_STD_WSTRING</span></div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span> <span class="preprocessor">#if GTEST_HAS_GLOBAL_WSTRING</span></div>
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span> <span class="preprocessor"></span> <span class="comment">// Converts the given wide string to a narrow string using the UTF-8</span></div>
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <span class="comment">// encoding, and streams the result to this Message object.</span></div>
<div class="line"><a name="l00189"></a><span class="lineno"> 189</span>  <a class="code" href="classtesting_1_1Message.html">Message</a>& operator <<(const ::wstring& wstr);</div>
<div class="line"><a name="l00190"></a><span class="lineno"> 190</span> <span class="preprocessor">#endif // GTEST_HAS_GLOBAL_WSTRING</span></div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  <span class="comment">// Gets the text streamed to this object so far as an std::string.</span></div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  <span class="comment">// Each '\0' character in the buffer is replaced with "\\0".</span></div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <span class="comment">//</span></div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  std::string GetString() <span class="keyword">const</span>;</div>
<div class="line"><a name="l00197"></a><span class="lineno"> 197</span> </div>
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  <span class="keyword">private</span>:</div>
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span> </div>
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span> <span class="preprocessor">#if GTEST_OS_SYMBIAN</span></div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span> <span class="preprocessor"></span> <span class="comment">// These are needed as the Nokia Symbian Compiler cannot decide between</span></div>
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  <span class="comment">// const T& and const T* in a function template. The Nokia compiler _can_</span></div>
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span>  <span class="comment">// decide between class template specializations for T and T*, so a</span></div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  <span class="comment">// tr1::type_traits-like is_pointer works, and we can overload on that.</span></div>
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <span class="keyword">inline</span> <span class="keywordtype">void</span> StreamHelper(<a class="code" href="structtesting_1_1internal_1_1bool__constant.html">internal::true_type</a> <span class="comment">/*is_pointer*/</span>, T* pointer) {</div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  <span class="keywordflow">if</span> (pointer == NULL) {</div>
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  *ss_ << <span class="stringliteral">"(null)"</span>;</div>
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  } <span class="keywordflow">else</span> {</div>
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  *ss_ << pointer;</div>
<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  }</div>
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  }</div>
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
<div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <span class="keyword">inline</span> <span class="keywordtype">void</span> StreamHelper(<a class="code" href="structtesting_1_1internal_1_1bool__constant.html">internal::false_type</a> <span class="comment">/*is_pointer*/</span>,</div>
<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  <span class="keyword">const</span> T& value) {</div>
<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  <span class="comment">// See the comments in Message& operator <<(const T&) above for why</span></div>
<div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  <span class="comment">// we need this using statement.</span></div>
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  using ::operator <<;</div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  *ss_ << value;</div>
<div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  }</div>
<div class="line"><a name="l00221"></a><span class="lineno"> 221</span> <span class="preprocessor">#endif // GTEST_OS_SYMBIAN</span></div>
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00223"></a><span class="lineno"> 223</span>  <span class="comment">// We'll hold the text streamed to this object here.</span></div>
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  <span class="keyword">const</span> <a class="code" href="classtesting_1_1internal_1_1scoped__ptr.html">internal::scoped_ptr< ::std::stringstream></a> ss_;</div>
<div class="line"><a name="l00225"></a><span class="lineno"> 225</span> </div>
<div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  <span class="comment">// We declare (but don't implement) this to prevent the compiler</span></div>
<div class="line"><a name="l00227"></a><span class="lineno"> 227</span>  <span class="comment">// from implementing the assignment operator.</span></div>
<div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  <span class="keywordtype">void</span> operator=(<span class="keyword">const</span> <a class="code" href="classtesting_1_1Message.html">Message</a>&);</div>
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span> };</div>
<div class="line"><a name="l00230"></a><span class="lineno"> 230</span> </div>
<div class="line"><a name="l00231"></a><span class="lineno"> 231</span> <span class="comment">// Streams a Message to an ostream.</span></div>
<div class="line"><a name="l00232"></a><span class="lineno"> 232</span> <span class="keyword">inline</span> std::ostream& operator <<(std::ostream& os, <span class="keyword">const</span> <a class="code" href="classtesting_1_1Message.html">Message</a>& sb) {</div>
<div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  <span class="keywordflow">return</span> os << sb.GetString();</div>
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span> }</div>
<div class="line"><a name="l00235"></a><span class="lineno"> 235</span> </div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span> <span class="keyword">namespace </span>internal {</div>
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span> </div>
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span> <span class="comment">// Converts a streamable value to an std::string. A NULL pointer is</span></div>
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span> <span class="comment">// converted to "(null)". When the input value is a ::string,</span></div>
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span> <span class="comment">// ::std::string, ::wstring, or ::std::wstring object, each NUL</span></div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span> <span class="comment">// character in it is replaced with "\\0".</span></div>
<div class="line"><a name="l00242"></a><span class="lineno"> 242</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
<div class="line"><a name="l00243"></a><span class="lineno"> 243</span> std::string StreamableToString(<span class="keyword">const</span> T& streamable) {</div>
<div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  <span class="keywordflow">return</span> (Message() << streamable).GetString();</div>
<div class="line"><a name="l00245"></a><span class="lineno"> 245</span> }</div>
<div class="line"><a name="l00246"></a><span class="lineno"> 246</span> </div>
<div class="line"><a name="l00247"></a><span class="lineno"> 247</span> } <span class="comment">// namespace internal</span></div>
<div class="line"><a name="l00248"></a><span class="lineno"> 248</span> } <span class="comment">// namespace testing</span></div>
<div class="line"><a name="l00249"></a><span class="lineno"> 249</span> </div>
<div class="line"><a name="l00250"></a><span class="lineno"> 250</span> <span class="preprocessor">#endif // GTEST_INCLUDE_GTEST_GTEST_MESSAGE_H_</span></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="structtesting_1_1internal_1_1bool__constant_html"><div class="ttname"><a href="structtesting_1_1internal_1_1bool__constant.html">testing::internal::bool_constant</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-port_8h_source.html#l02203">gtest-port.h:2203</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::stringstream ></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>