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
<!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/internal/gtest-linked_ptr.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><li class="navelem"><a class="el" href="dir_ab51700946c11ac31211b18bf5cffab4.html">internal</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">gtest-linked_ptr.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 2003 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">// Authors: Dan Egnor (egnor@google.com)</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">// A "smart" pointer type with reference tracking. Every pointer to a</span></div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="comment">// particular object is kept on a circular linked list. When the last pointer</span></div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="comment">// to an object is destroyed or reassigned, the object is deleted.</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">// Used properly, this deletes the object when the last reference goes away.</span></div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="comment">// There are several caveats:</span></div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="comment">// - Like all reference counting schemes, cycles lead to leaks.</span></div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="comment">// - Each smart pointer is actually two pointers (8 bytes instead of 4).</span></div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="comment">// - Every time a pointer is assigned, the entire list of pointers to that</span></div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="comment">// object is traversed. This class is therefore NOT SUITABLE when there</span></div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment">// will often be more than two or three pointers to a particular object.</span></div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment">// - References are only tracked as long as linked_ptr<> objects are copied.</span></div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment">// If a linked_ptr<> is converted to a raw pointer and back, BAD THINGS</span></div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">// will happen (double deletion).</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">// A good use of this class is storing object references in STL containers.</span></div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// You can safely put linked_ptr<> in a vector<>.</span></div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">// Other uses may not be as good.</span></div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">//</span></div>
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment">// Note: If you use an incomplete type with linked_ptr<>, the class</span></div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// *containing* linked_ptr<> must have a constructor and destructor (even</span></div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment">// if they do nothing!).</span></div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment">//</span></div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="comment">// Bill Gibbons suggested we use something like this.</span></div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment">//</span></div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment">// Thread Safety:</span></div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="comment">// Unlike other linked_ptr implementations, in this implementation</span></div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="comment">// a linked_ptr object is thread-safe in the sense that:</span></div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="comment">// - it's safe to copy linked_ptr objects concurrently,</span></div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="comment">// - it's safe to copy *from* a linked_ptr and read its underlying</span></div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="comment">// raw pointer (e.g. via get()) concurrently, and</span></div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="comment">// - it's safe to write to two linked_ptrs that point to the same</span></div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="comment">// shared object concurrently.</span></div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="comment">// TODO(wan@google.com): rename this to safe_linked_ptr to avoid</span></div>
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="comment">// confusion with normal linked_ptr.</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="preprocessor">#ifndef GTEST_INCLUDE_GTEST_INTERNAL_GTEST_LINKED_PTR_H_</span></div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="preprocessor"></span><span class="preprocessor">#define GTEST_INCLUDE_GTEST_INTERNAL_GTEST_LINKED_PTR_H_</span></div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="preprocessor">#include <stdlib.h></span></div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="preprocessor">#include <assert.h></span></div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> </div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="preprocessor">#include "gtest/internal/gtest-port.h"</span></div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span> </div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="keyword">namespace </span>testing {</div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="keyword">namespace </span>internal {</div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span> </div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span> <span class="comment">// Protects copying of all linked_ptr objects.</span></div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span> GTEST_API_ GTEST_DECLARE_STATIC_MUTEX_(g_linked_ptr_mutex);</div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span> </div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span> <span class="comment">// This is used internally by all instances of linked_ptr<>. It needs to be</span></div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="comment">// a non-template class because different types of linked_ptr<> can refer to</span></div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span> <span class="comment">// the same object (linked_ptr<Superclass>(obj) vs linked_ptr<Subclass>(obj)).</span></div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span> <span class="comment">// So, it needs to be possible for different types of linked_ptr to participate</span></div>
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span> <span class="comment">// in the same circular linked list, so we need a single class type here.</span></div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span> <span class="comment">//</span></div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span> <span class="comment">// DO NOT USE THIS CLASS DIRECTLY YOURSELF. Use linked_ptr<T>.</span></div>
<div class="line"><a name="l00089"></a><span class="lineno"><a class="line" href="classtesting_1_1internal_1_1linked__ptr__internal.html"> 89</a></span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1linked__ptr__internal.html">linked_ptr_internal</a> {</div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  <span class="keyword">public</span>:</div>
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  <span class="comment">// Create a new circle that includes only this instance.</span></div>
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  <span class="keywordtype">void</span> join_new() {</div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  next_ = <span class="keyword">this</span>;</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> </div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  <span class="comment">// Many linked_ptr operations may change p.link_ for some linked_ptr</span></div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  <span class="comment">// variable p in the same circle as this object. Therefore we need</span></div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  <span class="comment">// to prevent two such operations from occurring concurrently.</span></div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <span class="comment">//</span></div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <span class="comment">// Note that different types of linked_ptr objects can coexist in a</span></div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  <span class="comment">// circle (e.g. linked_ptr<Base>, linked_ptr<Derived1>, and</span></div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  <span class="comment">// linked_ptr<Derived2>). Therefore we must use a single mutex to</span></div>
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  <span class="comment">// protect all linked_ptr objects. This can create serious</span></div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <span class="comment">// contention in production code, but is acceptable in a testing</span></div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  <span class="comment">// framework.</span></div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span> </div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <span class="comment">// Join an existing circle.</span></div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="keywordtype">void</span> join(<a class="code" href="classtesting_1_1internal_1_1linked__ptr__internal.html">linked_ptr_internal</a> <span class="keyword">const</span>* ptr)</div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  GTEST_LOCK_EXCLUDED_(g_linked_ptr_mutex) {</div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  <a class="code" href="classtesting_1_1internal_1_1GTestMutexLock.html">MutexLock</a> lock(&g_linked_ptr_mutex);</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>  <a class="code" href="classtesting_1_1internal_1_1linked__ptr__internal.html">linked_ptr_internal</a> <span class="keyword">const</span>* p = ptr;</div>
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  <span class="keywordflow">while</span> (p->next_ != ptr) {</div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  assert(p->next_ != <span class="keyword">this</span> &&</div>
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span>  <span class="stringliteral">"Trying to join() a linked ring we are already in. "</span></div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  <span class="stringliteral">"Is GMock thread safety enabled?"</span>);</div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  p = p->next_;</div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  }</div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  p->next_ = <span class="keyword">this</span>;</div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  next_ = ptr;</div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  }</div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span> </div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <span class="comment">// Leave whatever circle we're part of. Returns true if we were the</span></div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <span class="comment">// last member of the circle. Once this is done, you can join() another.</span></div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  <span class="keywordtype">bool</span> depart()</div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  GTEST_LOCK_EXCLUDED_(g_linked_ptr_mutex) {</div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  <a class="code" href="classtesting_1_1internal_1_1GTestMutexLock.html">MutexLock</a> lock(&g_linked_ptr_mutex);</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="keywordflow">if</span> (next_ == <span class="keyword">this</span>) <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  <a class="code" href="classtesting_1_1internal_1_1linked__ptr__internal.html">linked_ptr_internal</a> <span class="keyword">const</span>* p = next_;</div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  <span class="keywordflow">while</span> (p->next_ != <span class="keyword">this</span>) {</div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  assert(p->next_ != next_ &&</div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  <span class="stringliteral">"Trying to depart() a linked ring we are not in. "</span></div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  <span class="stringliteral">"Is GMock thread safety enabled?"</span>);</div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  p = p->next_;</div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  }</div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  p->next_ = next_;</div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  }</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="keyword">private</span>:</div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  <span class="keyword">mutable</span> <a class="code" href="classtesting_1_1internal_1_1linked__ptr__internal.html">linked_ptr_internal</a> <span class="keyword">const</span>* next_;</div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span> };</div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span> </div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
<div class="line"><a name="l00146"></a><span class="lineno"><a class="line" href="classtesting_1_1internal_1_1linked__ptr.html"> 146</a></span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr</a> {</div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="keyword">public</span>:</div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <span class="keyword">typedef</span> T element_type;</div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span> </div>
<div class="line"><a name="l00150"></a><span class="lineno"> 150</span>  <span class="comment">// Take over ownership of a raw pointer. This should happen as soon as</span></div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span>  <span class="comment">// possible after the object is created.</span></div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  <span class="keyword">explicit</span> <a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr</a>(T* ptr = NULL) { capture(ptr); }</div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  ~<a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr</a>() { depart(); }</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="comment">// Copy an existing linked_ptr<>, adding ourselves to the list of references.</span></div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> U> <a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr</a>(<a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr<U></a> <span class="keyword">const</span>& ptr) { copy(&ptr); }</div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  <a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr</a>(<a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr</a> <span class="keyword">const</span>& ptr) { <span class="comment">// NOLINT</span></div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  assert(&ptr != <span class="keyword">this</span>);</div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  copy(&ptr);</div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  }</div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span> </div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <span class="comment">// Assignment releases the old value and acquires the new.</span></div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> U> <a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr</a>& operator=(<a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr<U></a> <span class="keyword">const</span>& ptr) {</div>
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  depart();</div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  copy(&ptr);</div>
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</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>  <a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr</a>& operator=(<a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr</a> <span class="keyword">const</span>& ptr) {</div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span>  <span class="keywordflow">if</span> (&ptr != <span class="keyword">this</span>) {</div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>  depart();</div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  copy(&ptr);</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>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  }</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">// Smart pointer members.</span></div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <span class="keywordtype">void</span> reset(T* ptr = NULL) {</div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  depart();</div>
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  capture(ptr);</div>
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  }</div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  T* <span class="keyword">get</span>() <span class="keyword">const</span> { <span class="keywordflow">return</span> value_; }</div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  T* operator->()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> value_; }</div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  T& operator*()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> *value_; }</div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span> </div>
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  <span class="keywordtype">bool</span> operator==(T* p)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> value_ == p; }</div>
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <span class="keywordtype">bool</span> operator!=(T* p)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> value_ != p; }</div>
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> U></div>
<div class="line"><a name="l00189"></a><span class="lineno"> 189</span>  <span class="keywordtype">bool</span> operator==(<a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr<U></a> <span class="keyword">const</span>& ptr)<span class="keyword"> const </span>{</div>
<div class="line"><a name="l00190"></a><span class="lineno"> 190</span>  <span class="keywordflow">return</span> value_ == ptr.get();</div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  }</div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> U></div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  <span class="keywordtype">bool</span> operator!=(<a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr<U></a> <span class="keyword">const</span>& ptr)<span class="keyword"> const </span>{</div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <span class="keywordflow">return</span> value_ != ptr.get();</div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span>  }</div>
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span> </div>
<div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  <span class="keyword">private</span>:</div>
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> U></div>
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr</a>;</div>
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span> </div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  T* value_;</div>
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span>  <a class="code" href="classtesting_1_1internal_1_1linked__ptr__internal.html">linked_ptr_internal</a> link_;</div>
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span> </div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  <span class="keywordtype">void</span> depart() {</div>
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  <span class="keywordflow">if</span> (link_.depart()) <span class="keyword">delete</span> value_;</div>
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  }</div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span> </div>
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <span class="keywordtype">void</span> capture(T* ptr) {</div>
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  value_ = ptr;</div>
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span>  link_.join_new();</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> U> <span class="keywordtype">void</span> copy(<a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr<U></a> <span class="keyword">const</span>* ptr) {</div>
<div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  value_ = ptr->get();</div>
<div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  <span class="keywordflow">if</span> (value_)</div>
<div class="line"><a name="l00216"></a><span class="lineno"> 216</span>  link_.join(&ptr->link_);</div>
<div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  <span class="keywordflow">else</span></div>
<div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  link_.join_new();</div>
<div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  }</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> </div>
<div class="line"><a name="l00222"></a><span class="lineno"> 222</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">inline</span></div>
<div class="line"><a name="l00223"></a><span class="lineno"> 223</span> <span class="keywordtype">bool</span> operator==(T* ptr, <span class="keyword">const</span> <a class="code" href="classtesting_1_1internal_1_1linked__ptr.html">linked_ptr<T></a>& x) {</div>
<div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  <span class="keywordflow">return</span> ptr == x.get();</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> </div>
<div class="line"><a name="l00227"></a><span class="lineno"> 227</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">inline</span></div>
<div class="line"><a name="l00228"></a><span class="lineno"> 228</span> <span class="keywordtype">bool</span> operator!=(T* ptr, <span class="keyword">const</span> linked_ptr<T>& x) {</div>
<div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  <span class="keywordflow">return</span> ptr != x.get();</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> </div>
<div class="line"><a name="l00232"></a><span class="lineno"> 232</span> <span class="comment">// A function to convert T* into linked_ptr<T></span></div>
<div class="line"><a name="l00233"></a><span class="lineno"> 233</span> <span class="comment">// Doing e.g. make_linked_ptr(new FooBarBaz<type>(arg)) is a shorter notation</span></div>
<div class="line"><a name="l00234"></a><span class="lineno"> 234</span> <span class="comment">// for linked_ptr<FooBarBaz<type> >(new FooBarBaz<type>(arg))</span></div>
<div class="line"><a name="l00235"></a><span class="lineno"> 235</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T></div>
<div class="line"><a name="l00236"></a><span class="lineno"> 236</span> linked_ptr<T> make_linked_ptr(T* ptr) {</div>
<div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  <span class="keywordflow">return</span> linked_ptr<T>(ptr);</div>
<div class="line"><a name="l00238"></a><span class="lineno"> 238</span> }</div>
<div class="line"><a name="l00239"></a><span class="lineno"> 239</span> </div>
<div class="line"><a name="l00240"></a><span class="lineno"> 240</span> } <span class="comment">// namespace internal</span></div>
<div class="line"><a name="l00241"></a><span class="lineno"> 241</span> } <span class="comment">// namespace testing</span></div>
<div class="line"><a name="l00242"></a><span class="lineno"> 242</span> </div>
<div class="line"><a name="l00243"></a><span class="lineno"> 243</span> <span class="preprocessor">#endif // GTEST_INCLUDE_GTEST_INTERNAL_GTEST_LINKED_PTR_H_</span></div>
<div class="ttc" id="classtesting_1_1internal_1_1linked__ptr_html"><div class="ttname"><a href="classtesting_1_1internal_1_1linked__ptr.html">testing::internal::linked_ptr</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-linked__ptr_8h_source.html#l00146">gtest-linked_ptr.h:146</a></div></div>
<div class="ttc" id="classtesting_1_1internal_1_1GTestMutexLock_html"><div class="ttname"><a href="classtesting_1_1internal_1_1GTestMutexLock.html">testing::internal::GTestMutexLock</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-port_8h_source.html#l02154">gtest-port.h:2154</a></div></div>
<div class="ttc" id="classtesting_1_1internal_1_1linked__ptr__internal_html"><div class="ttname"><a href="classtesting_1_1internal_1_1linked__ptr__internal.html">testing::internal::linked_ptr_internal</a></div><div class="ttdef"><b>Definition:</b> <a href="gtest-linked__ptr_8h_source.html#l00089">gtest-linked_ptr.h:89</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>