Files
ortools-clone/docs/cpp_graph/connected__components_8h_source.html
2019-06-29 18:18:08 +02:00

78 lines
65 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>
<title>OR-Tools</title>
<meta http-equiv="Content-Type" content="text/html;"/>
<meta charset="utf-8"/>
<!--<link rel='stylesheet' type='text/css' href="https://fonts.googleapis.com/css?family=Ubuntu:400,700,400italic"/>-->
<link rel="stylesheet" type="text/css" href="ortools.css" title="default" media="screen,print" />
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
</head>
<body>
<div id="banner-container">
<div id="banner">
<span id="sfml">OR-Tools 7.2</span>
</div>
</div>
<link rel="icon" href="https://developers.google.com/optimization/images/orLogo.png">
<div id="content">
<!-- Generated by Doxygen 1.8.15 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main&#160;Page</span></a></li>
<li><a href="pages.html"><span>Related&#160;Pages</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>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File&#160;List</span></a></li>
<li><a href="globals.html"><span>File&#160;Members</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_a7cc1eeded8f693d0da6c729bc88c45a.html">ortools</a></li><li class="navelem"><a class="el" href="dir_725f3a5915051842f84e3ea508be2a62.html">graph</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">connected_components.h</div> </div>
</div><!--header-->
<div class="contents">
<a href="connected__components_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span>&#160;<span class="comment">// Copyright 2010-2018 Google LLC</span></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span>&#160;<span class="comment">// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span></div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span>&#160;<span class="comment">// you may not use this file except in compliance with the License.</span></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span>&#160;<span class="comment">// You may obtain a copy of the License at</span></div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span>&#160;<span class="comment">// http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span>&#160;<span class="comment">// Unless required by applicable law or agreed to in writing, software</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span>&#160;<span class="comment">// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span></div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span>&#160;<span class="comment">// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span>&#160;<span class="comment">// See the License for the specific language governing permissions and</span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span>&#160;<span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span>&#160;</div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span>&#160;<span class="comment">// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span></div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span>&#160;<span class="comment">// you may not use this file except in compliance with the License.</span></div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span>&#160;<span class="comment">// You may obtain a copy of the License at</span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span>&#160;<span class="comment">// http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span>&#160;<span class="comment">// Unless required by applicable law or agreed to in writing, software</span></div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span>&#160;<span class="comment">// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span></div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span>&#160;<span class="comment">// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span>&#160;<span class="comment">// See the License for the specific language governing permissions and</span></div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span>&#160;<span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span>&#160;</div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span>&#160;<span class="comment">// Finds the connected components in an undirected graph:</span></div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span>&#160;<span class="comment">// https://en.wikipedia.org/wiki/Connected_component_(graph_theory)</span></div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span>&#160;<span class="comment">// If you have a fixed graph where the node are dense integers, use</span></div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span>&#160;<span class="comment">// GetConnectedComponents(): it&#39;s very fast and uses little memory.</span></div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span>&#160;<span class="comment">// If you have a more dynamic scenario where you want to incrementally</span></div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span>&#160;<span class="comment">// add nodes or edges and query the connectivity between them, use the</span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span>&#160;<span class="comment">// [Dense]ConnectedComponentsFinder class, which uses the union-find algorithm</span></div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span>&#160;<span class="comment">// aka disjoint sets: https://en.wikipedia.org/wiki/Disjoint-set_data_structure.</span></div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span>&#160;</div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span>&#160;<span class="preprocessor">#ifndef UTIL_GRAPH_CONNECTED_COMPONENTS_H_</span></div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span>&#160;<span class="preprocessor">#define UTIL_GRAPH_CONNECTED_COMPONENTS_H_</span></div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span>&#160;</div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span>&#160;<span class="preprocessor">#include &lt;functional&gt;</span></div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span>&#160;<span class="preprocessor">#include &lt;map&gt;</span></div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span>&#160;<span class="preprocessor">#include &lt;memory&gt;</span></div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span>&#160;<span class="preprocessor">#include &lt;set&gt;</span></div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span>&#160;<span class="preprocessor">#include &lt;type_traits&gt;</span></div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span>&#160;<span class="preprocessor">#include &lt;vector&gt;</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span>&#160;</div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span>&#160;<span class="preprocessor">#include &quot;absl/container/flat_hash_map.h&quot;</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span>&#160;<span class="preprocessor">#include &quot;absl/container/flat_hash_set.h&quot;</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span>&#160;<span class="preprocessor">#include &quot;absl/hash/hash.h&quot;</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span>&#160;<span class="preprocessor">#include &quot;absl/meta/type_traits.h&quot;</span></div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span>&#160;<span class="preprocessor">#include &quot;ortools/base/logging.h&quot;</span></div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span>&#160;<span class="preprocessor">#include &quot;ortools/base/map_util.h&quot;</span></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span>&#160;<span class="preprocessor">#include &quot;ortools/base/ptr_util.h&quot;</span></div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span>&#160;</div><div class="line"><a name="l00056"></a><span class="lineno"><a class="line" href="namespaceutil.html"> 56</a></span>&#160;<span class="keyword">namespace </span><a class="code" href="namespaceutil.html">util</a> {</div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span>&#160;<span class="comment">// Finds the connected components of the graph, using BFS internally.</span></div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span>&#160;<span class="comment">// Works on any *undirected* graph class whose nodes are dense integers and that</span></div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span>&#160;<span class="comment">// supports the [] operator for adjacency lists: graph[x] must be an integer</span></div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span>&#160;<span class="comment">// container listing the nodes that are adjacent to node #x.</span></div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span>&#160;<span class="comment">// Example: std::vector&lt;std::vector&lt;int&gt;&gt;.</span></div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span>&#160;<span class="comment">// &quot;Undirected&quot; means that for all y in graph[x], x is in graph[y].</span></div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span>&#160;<span class="comment">// Returns the mapping from node to component index. The component indices are</span></div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span>&#160;<span class="comment">// deterministic: Component #0 will be the one that has node #0, component #1</span></div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>&#160;<span class="comment">// the one that has the lowest-index node that isn&#39;t in component #0, and so on.</span></div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span>&#160;<span class="comment">// Example on the following 6-node graph: 5--3--0--1 2--4</span></div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span>&#160;<span class="comment">// std::vector&lt;std::vector&lt;int&gt;&gt; graph = {{1, 3}, {0}, {4}, {0, 5}, {2}, {3}};</span></div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span>&#160;<span class="comment">// GetConnectedComponents(graph); // returns [0, 0, 1, 0, 1, 0].</span></div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span>&#160;<span class="keyword">template</span> &lt;<span class="keyword">class</span> UndirectedGraph&gt;</div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span>&#160;std::vector&lt;int&gt; <a class="code" href="namespaceutil.html#a13f0e8f7e15873600cf8e395958c71e1">GetConnectedComponents</a>(<span class="keywordtype">int</span> num_nodes,</div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span>&#160; <span class="keyword">const</span> UndirectedGraph&amp; graph);</div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span>&#160;} <span class="comment">// namespace util</span></div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span>&#160;</div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span>&#160;<span class="comment">// NOTE(user): The rest of the functions below should also be in namespace</span></div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span>&#160;<span class="comment">// util, but for historical reasons it hasn&#39;t been done yet.</span></div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span>&#160;</div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span>&#160;<span class="comment">// A connected components finder that only works on dense ints.</span></div><div class="line"><a name="l00081"></a><span class="lineno"><a class="line" href="classDenseConnectedComponentsFinder.html"> 81</a></span>&#160;<span class="keyword">class </span><a class="code" href="classDenseConnectedComponentsFinder.html">DenseConnectedComponentsFinder</a> {</div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l00083"></a><span class="lineno"><a class="line" href="classDenseConnectedComponentsFinder.html#a33639c91528c2a525e1591df24ff2cc9"> 83</a></span>&#160; <a class="code" href="classDenseConnectedComponentsFinder.html#a33639c91528c2a525e1591df24ff2cc9">DenseConnectedComponentsFinder</a>() {}</div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span>&#160;</div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span>&#160; <a class="code" href="classDenseConnectedComponentsFinder.html#a33639c91528c2a525e1591df24ff2cc9">DenseConnectedComponentsFinder</a>(<span class="keyword">const</span> <a class="code" href="classDenseConnectedComponentsFinder.html">DenseConnectedComponentsFinder</a>&amp;) =</div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span>&#160; <span class="keyword">delete</span>;</div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span>&#160; <a class="code" href="classDenseConnectedComponentsFinder.html">DenseConnectedComponentsFinder</a>&amp; <a class="code" href="classDenseConnectedComponentsFinder.html#a20f2a5d6bb7631a0dcdd678387a1b61a">operator=</a>(</div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span>&#160; <span class="keyword">const</span> <a class="code" href="classDenseConnectedComponentsFinder.html">DenseConnectedComponentsFinder</a>&amp;) = <span class="keyword">delete</span>;</div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span>&#160;</div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>&#160; <span class="comment">// The main API is the same as ConnectedComponentsFinder (below): see the</span></div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span>&#160; <span class="comment">// homonymous functions there.</span></div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span>&#160; <span class="keywordtype">void</span> <a class="code" href="classDenseConnectedComponentsFinder.html#aba450cf3f16d9386d043c4354a19a4aa">AddEdge</a>(<span class="keywordtype">int</span> node1, <span class="keywordtype">int</span> node2);</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span>&#160; <span class="keywordtype">bool</span> <a class="code" href="classDenseConnectedComponentsFinder.html#a071f52956431e211e14ed7f3894c1d0b">Connected</a>(<span class="keywordtype">int</span> node1, <span class="keywordtype">int</span> node2);</div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span>&#160; <span class="keywordtype">int</span> <a class="code" href="classDenseConnectedComponentsFinder.html#a0a639b64de57bc14f04f0f238e0092d1">GetSize</a>(<span class="keywordtype">int</span> node);</div><div class="line"><a name="l00095"></a><span class="lineno"><a class="line" href="classDenseConnectedComponentsFinder.html#a5090a0bdc205d23778d2b8a742f5c5fd"> 95</a></span>&#160; <span class="keywordtype">int</span> <a class="code" href="classDenseConnectedComponentsFinder.html#a5090a0bdc205d23778d2b8a742f5c5fd">GetNumberOfComponents</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> num_components_; }</div><div class="line"><a name="l00096"></a><span class="lineno"><a class="line" href="classDenseConnectedComponentsFinder.html#a317fb43e59ef01ebe3d0d492b4ab33dd"> 96</a></span>&#160; <span class="keywordtype">int</span> <a class="code" href="classDenseConnectedComponentsFinder.html#a317fb43e59ef01ebe3d0d492b4ab33dd">GetNumberOfNodes</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> parent_.size(); }</div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span>&#160;</div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span>&#160; <span class="comment">// Sets the number of nodes in the graph. The graph can only grow: this</span></div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span>&#160; <span class="comment">// dies if &quot;num_nodes&quot; is lower or equal to any of the values ever given</span></div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span>&#160; <span class="comment">// to AddEdge(), or lower than a previous value given to SetNumberOfNodes().</span></div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>&#160; <span class="comment">// You need this if there are nodes that don&#39;t have any edges.</span></div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span>&#160; <span class="keywordtype">void</span> <a class="code" href="classDenseConnectedComponentsFinder.html#a46780e194c525fa9853fa899d69b4340">SetNumberOfNodes</a>(<span class="keywordtype">int</span> num_nodes);</div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span>&#160;</div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span>&#160; <span class="comment">// Returns the root of the set for the given node. node must be in</span></div><div class="line"><a name="l00105"></a><span class="lineno"> 105</span>&#160; <span class="comment">// [0;GetNumberOfNodes()-1].</span></div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span>&#160; <span class="comment">// Non-const because it does path compression internally.</span></div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span>&#160; <span class="keywordtype">int</span> <a class="code" href="classDenseConnectedComponentsFinder.html#afdcff89dd2374ce33c05934d328e64ec">FindRoot</a>(<span class="keywordtype">int</span> node);</div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span>&#160;</div><div class="line"><a name="l00109"></a><span class="lineno"> 109</span>&#160; <span class="comment">// Returns the same as GetConnectedComponents().</span></div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span>&#160; std::vector&lt;int&gt; <a class="code" href="classDenseConnectedComponentsFinder.html#aee7f0057f42256a520b5ef32bae58b36">GetComponentIds</a>();</div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span>&#160;</div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span>&#160; <span class="keyword">private</span>:</div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span>&#160; <span class="comment">// parent[i] is the id of an ancestor for node i. A node is a root iff</span></div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span>&#160; <span class="comment">// parent[i] == i.</span></div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span>&#160; std::vector&lt;int&gt; parent_;</div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span>&#160; <span class="comment">// If i is a root, component_size_[i] is the number of elements in the</span></div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span>&#160; <span class="comment">// component. If i is not a root, component_size_[i] is meaningless.</span></div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span>&#160; std::vector&lt;int&gt; component_size_;</div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span>&#160; <span class="comment">// rank[i] is the depth of the tree.</span></div><div class="line"><a name="l00120"></a><span class="lineno"> 120</span>&#160; std::vector&lt;int&gt; rank_;</div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span>&#160; <span class="comment">// Number of connected components.</span></div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span>&#160; <span class="keywordtype">int</span> num_components_ = 0;</div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span>&#160;};</div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span>&#160;</div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span>&#160;<span class="keyword">namespace </span>internal {</div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span>&#160;<span class="comment">// A helper to deduce the type of map to use depending on whether CompareOrHashT</span></div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span>&#160;<span class="comment">// is a comparator or a hasher (prefer the latter).</span></div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span>&#160;<span class="keyword">template</span> &lt;<span class="keyword">typename</span> T, <span class="keyword">typename</span> CompareOrHashT&gt;</div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span>&#160;<span class="keyword">struct </span>ConnectedComponentsTypeHelper {</div><div class="line"><a name="l00130"></a><span class="lineno"> 130</span>&#160; <span class="comment">// SFINAE trait to detect hash functors and select unordered containers if so,</span></div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span>&#160; <span class="comment">// and ordered containers otherwise (= by default).</span></div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span>&#160; <span class="keyword">template</span> &lt;<span class="keyword">typename</span> U, <span class="keyword">typename</span> E = <span class="keywordtype">void</span>&gt;</div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span>&#160; <span class="keyword">struct </span>SelectContainer {</div><div class="line"><a name="l00134"></a><span class="lineno"> 134</span>&#160; <span class="keyword">using</span> Set = std::set&lt;T, CompareOrHashT&gt;;</div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span>&#160; <span class="keyword">using</span> Map = std::map&lt;T, int, CompareOrHashT&gt;;</div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span>&#160; };</div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span>&#160;</div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span>&#160; <span class="comment">// The expression inside decltype is basically saying that &quot;H(x)&quot; is</span></div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span>&#160; <span class="comment">// well-formed, where H is an instance of U and x is an instance of T, and is</span></div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>&#160; <span class="comment">// a value of integral type. That is, we are &quot;duck-typing&quot; on whether U looks</span></div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span>&#160; <span class="comment">// like a hash functor.</span></div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span>&#160; <span class="keyword">template</span> &lt;<span class="keyword">typename</span> U&gt;</div><div class="line"><a name="l00143"></a><span class="lineno"> 143</span>&#160; <span class="keyword">struct </span>SelectContainer&lt;</div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span>&#160; U, absl::enable_if_t&lt;std::is_integral&lt;decltype(</div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span>&#160; std::declval&lt;const U&amp;&gt;()(std::declval&lt;const T&amp;&gt;()))&gt;::value&gt;&gt; {</div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span>&#160; <span class="keyword">using</span> Set = absl::flat_hash_set&lt;T, CompareOrHashT&gt;;</div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>&#160; <span class="keyword">using</span> Map = absl::flat_hash_map&lt;T, int, CompareOrHashT&gt;;</div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span>&#160; };</div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span>&#160;</div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span>&#160; <span class="keyword">using</span> Set = <span class="keyword">typename</span> SelectContainer&lt;CompareOrHashT&gt;::Set;</div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span>&#160; <span class="keyword">using</span> Map = <span class="keyword">typename</span> SelectContainer&lt;CompareOrHashT&gt;::Map;</div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span>&#160;};</div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span>&#160;</div><div class="line"><a name="l00154"></a><span class="lineno"> 154</span>&#160;} <span class="comment">// namespace internal</span></div><div class="line"><a name="l00155"></a><span class="lineno"> 155</span>&#160;</div><div class="line"><a name="l00156"></a><span class="lineno"> 156</span>&#160;<span class="comment">// Usage:</span></div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span>&#160;<span class="comment">// ConnectedComponentsFinder&lt;MyNodeType&gt; cc;</span></div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span>&#160;<span class="comment">// cc.AddNode(node1);</span></div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span>&#160;<span class="comment">// cc.AddNode(node2);</span></div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span>&#160;<span class="comment">// cc.AddEdge(node1, node2);</span></div><div class="line"><a name="l00161"></a><span class="lineno"> 161</span>&#160;<span class="comment">// ... repeating, adding nodes and edges as needed. Adding an edge</span></div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span>&#160;<span class="comment">// will automatically also add the two nodes at its ends, if they</span></div><div class="line"><a name="l00163"></a><span class="lineno"> 163</span>&#160;<span class="comment">// haven&#39;t already been added.</span></div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span>&#160;<span class="comment">// std::vector&lt;std::set&lt;MyNodeType&gt; &gt; components;</span></div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span>&#160;<span class="comment">// cc.FindConnectedComponents(&amp;components);</span></div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span>&#160;<span class="comment">// Each entry in components now contains all the nodes in a single</span></div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span>&#160;<span class="comment">// connected component.</span></div><div class="line"><a name="l00168"></a><span class="lineno"> 168</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00169"></a><span class="lineno"> 169</span>&#160;<span class="comment">// Usage with flat_hash_set:</span></div><div class="line"><a name="l00170"></a><span class="lineno"> 170</span>&#160;<span class="comment">// using ConnectedComponentType = flat_hash_set&lt;MyNodeType&gt;;</span></div><div class="line"><a name="l00171"></a><span class="lineno"> 171</span>&#160;<span class="comment">// ConnectedComponentsFinder&lt;ConnectedComponentType::key_type,</span></div><div class="line"><a name="l00172"></a><span class="lineno"> 172</span>&#160;<span class="comment">// ConnectedComponentType::hasher&gt;</span></div><div class="line"><a name="l00173"></a><span class="lineno"> 173</span>&#160;<span class="comment">// cc;</span></div><div class="line"><a name="l00174"></a><span class="lineno"> 174</span>&#160;<span class="comment">// ...</span></div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span>&#160;<span class="comment">// std::vector&lt;ConnectedComponentType&gt; components;</span></div><div class="line"><a name="l00176"></a><span class="lineno"> 176</span>&#160;<span class="comment">// cc.FindConnectedComponents(&amp;components);</span></div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span>&#160;<span class="comment">// If you want to, you can continue adding nodes and edges after calling</span></div><div class="line"><a name="l00179"></a><span class="lineno"> 179</span>&#160;<span class="comment">// FindConnectedComponents, then call it again later.</span></div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span>&#160;<span class="comment">// If your node type isn&#39;t STL-friendly, then you can use pointers to</span></div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span>&#160;<span class="comment">// it instead:</span></div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span>&#160;<span class="comment">// ConnectedComponentsFinder&lt;MySTLUnfriendlyNodeType*&gt; cc;</span></div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span>&#160;<span class="comment">// cc.AddNode(&amp;node1);</span></div><div class="line"><a name="l00185"></a><span class="lineno"> 185</span>&#160;<span class="comment">// ... and so on...</span></div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span>&#160;<span class="comment">// Of course, in this usage, the connected components finder retains</span></div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span>&#160;<span class="comment">// these pointers through its lifetime (though it doesn&#39;t dereference them).</span></div><div class="line"><a name="l00188"></a><span class="lineno"> 188</span>&#160;<span class="keyword">template</span> &lt;<span class="keyword">typename</span> T, <span class="keyword">typename</span> CompareOrHashT = std::less&lt;T&gt;&gt;</div><div class="line"><a name="l00189"></a><span class="lineno"><a class="line" href="classConnectedComponentsFinder.html"> 189</a></span>&#160;<span class="keyword">class </span><a class="code" href="classConnectedComponentsFinder.html">ConnectedComponentsFinder</a> {</div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l00191"></a><span class="lineno"> 191</span>&#160; <span class="comment">// Constructs a connected components finder.</span></div><div class="line"><a name="l00192"></a><span class="lineno"><a class="line" href="classConnectedComponentsFinder.html#aa669a113d3ee23c506b97949f740b1cc"> 192</a></span>&#160; <a class="code" href="classConnectedComponentsFinder.html#aa669a113d3ee23c506b97949f740b1cc">ConnectedComponentsFinder</a>() {}</div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span>&#160;</div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span>&#160; <a class="code" href="classConnectedComponentsFinder.html#aa669a113d3ee23c506b97949f740b1cc">ConnectedComponentsFinder</a>(<span class="keyword">const</span> <a class="code" href="classConnectedComponentsFinder.html">ConnectedComponentsFinder</a>&amp;) = <span class="keyword">delete</span>;</div><div class="line"><a name="l00195"></a><span class="lineno"> 195</span>&#160; <a class="code" href="classConnectedComponentsFinder.html">ConnectedComponentsFinder</a>&amp; <a class="code" href="classConnectedComponentsFinder.html#a21da7363443c34ad00c529fae4b3b3e2">operator=</a>(<span class="keyword">const</span> <a class="code" href="classConnectedComponentsFinder.html">ConnectedComponentsFinder</a>&amp;) =</div><div class="line"><a name="l00196"></a><span class="lineno"> 196</span>&#160; <span class="keyword">delete</span>;</div><div class="line"><a name="l00197"></a><span class="lineno"> 197</span>&#160;</div><div class="line"><a name="l00198"></a><span class="lineno"> 198</span>&#160; <span class="comment">// Adds a node in the graph. It is OK to add the same node more than</span></div><div class="line"><a name="l00199"></a><span class="lineno"> 199</span>&#160; <span class="comment">// once; additions after the first have no effect.</span></div><div class="line"><a name="l00200"></a><span class="lineno"><a class="line" href="classConnectedComponentsFinder.html#a93b2c753675c77bfdbc0c33eb582380b"> 200</a></span>&#160; <span class="keywordtype">void</span> <a class="code" href="classConnectedComponentsFinder.html#a93b2c753675c77bfdbc0c33eb582380b">AddNode</a>(T node) { LookupOrInsertNode&lt;true&gt;(node); }</div><div class="line"><a name="l00201"></a><span class="lineno"> 201</span>&#160;</div><div class="line"><a name="l00202"></a><span class="lineno"> 202</span>&#160; <span class="comment">// Adds an edge in the graph. Also adds both endpoint nodes as necessary.</span></div><div class="line"><a name="l00203"></a><span class="lineno"> 203</span>&#160; <span class="comment">// It is not an error to add the same edge twice. Self-edges are OK too.</span></div><div class="line"><a name="l00204"></a><span class="lineno"><a class="line" href="classConnectedComponentsFinder.html#a77a24beaed190e2f3a0d12662a65b18a"> 204</a></span>&#160; <span class="keywordtype">void</span> <a class="code" href="classConnectedComponentsFinder.html#a77a24beaed190e2f3a0d12662a65b18a">AddEdge</a>(T node1, T node2) {</div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span>&#160; delegate_.<a class="code" href="classDenseConnectedComponentsFinder.html#aba450cf3f16d9386d043c4354a19a4aa">AddEdge</a>(LookupOrInsertNode&lt;false&gt;(node1),</div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span>&#160; LookupOrInsertNode&lt;false&gt;(node2));</div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span>&#160; }</div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span>&#160;</div><div class="line"><a name="l00209"></a><span class="lineno"> 209</span>&#160; <span class="comment">// Returns true iff both nodes are in the same connected component.</span></div><div class="line"><a name="l00210"></a><span class="lineno"> 210</span>&#160; <span class="comment">// Returns false if either node has not been already added with AddNode.</span></div><div class="line"><a name="l00211"></a><span class="lineno"><a class="line" href="classConnectedComponentsFinder.html#a67dc34888511ab5b90b7389c90dbc1f8"> 211</a></span>&#160; <span class="keywordtype">bool</span> <a class="code" href="classConnectedComponentsFinder.html#a67dc34888511ab5b90b7389c90dbc1f8">Connected</a>(T node1, T node2) {</div><div class="line"><a name="l00212"></a><span class="lineno"> 212</span>&#160; <span class="keywordflow">return</span> delegate_.<a class="code" href="classDenseConnectedComponentsFinder.html#a071f52956431e211e14ed7f3894c1d0b">Connected</a>(gtl::FindWithDefault(index_, node1, -1),</div><div class="line"><a name="l00213"></a><span class="lineno"> 213</span>&#160; gtl::FindWithDefault(index_, node2, -1));</div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span>&#160; }</div><div class="line"><a name="l00215"></a><span class="lineno"> 215</span>&#160;</div><div class="line"><a name="l00216"></a><span class="lineno"> 216</span>&#160; <span class="comment">// Finds the connected component containing a node, and returns the</span></div><div class="line"><a name="l00217"></a><span class="lineno"> 217</span>&#160; <span class="comment">// total number of nodes in that component. Returns zero iff the</span></div><div class="line"><a name="l00218"></a><span class="lineno"> 218</span>&#160; <span class="comment">// node has not been already added with AddNode.</span></div><div class="line"><a name="l00219"></a><span class="lineno"><a class="line" href="classConnectedComponentsFinder.html#a7a173636e3dce11a27f2f7121e01a563"> 219</a></span>&#160; <span class="keywordtype">int</span> <a class="code" href="classConnectedComponentsFinder.html#a7a173636e3dce11a27f2f7121e01a563">GetSize</a>(T node) {</div><div class="line"><a name="l00220"></a><span class="lineno"> 220</span>&#160; <span class="keywordflow">return</span> delegate_.<a class="code" href="classDenseConnectedComponentsFinder.html#a0a639b64de57bc14f04f0f238e0092d1">GetSize</a>(gtl::FindWithDefault(index_, node, -1));</div><div class="line"><a name="l00221"></a><span class="lineno"> 221</span>&#160; }</div><div class="line"><a name="l00222"></a><span class="lineno"> 222</span>&#160;</div><div class="line"><a name="l00223"></a><span class="lineno"> 223</span>&#160; <span class="comment">// Finds all the connected components and assigns them to components.</span></div><div class="line"><a name="l00224"></a><span class="lineno"> 224</span>&#160; <span class="comment">// Components are ordered in the same way nodes were added, i.e. if node &#39;b&#39;</span></div><div class="line"><a name="l00225"></a><span class="lineno"> 225</span>&#160; <span class="comment">// was added before node &#39;c&#39;, then either:</span></div><div class="line"><a name="l00226"></a><span class="lineno"> 226</span>&#160; <span class="comment">// - &#39;c&#39; belongs to the same component as a node &#39;a&#39; added before &#39;b&#39;, or</span></div><div class="line"><a name="l00227"></a><span class="lineno"> 227</span>&#160; <span class="comment">// - the component for &#39;c&#39; comes after the one for &#39;b&#39;.</span></div><div class="line"><a name="l00228"></a><span class="lineno"> 228</span>&#160; <span class="comment">// There are two versions:</span></div><div class="line"><a name="l00229"></a><span class="lineno"> 229</span>&#160; <span class="comment">// - The first one returns the result, and stores each component in a vector.</span></div><div class="line"><a name="l00230"></a><span class="lineno"> 230</span>&#160; <span class="comment">// This is the preferred version.</span></div><div class="line"><a name="l00231"></a><span class="lineno"> 231</span>&#160; <span class="comment">// - The second one populates the result, and stores each component in a set.</span></div><div class="line"><a name="l00232"></a><span class="lineno"><a class="line" href="classConnectedComponentsFinder.html#a9eaa06cffceda90c1d44f550ad3459f3"> 232</a></span>&#160; std::vector&lt;std::vector&lt;T&gt;&gt; <a class="code" href="classConnectedComponentsFinder.html#a9eaa06cffceda90c1d44f550ad3459f3">FindConnectedComponents</a>() {</div><div class="line"><a name="l00233"></a><span class="lineno"> 233</span>&#160; <span class="keyword">const</span> <span class="keyword">auto</span> component_ids = delegate_.<a class="code" href="classDenseConnectedComponentsFinder.html#aee7f0057f42256a520b5ef32bae58b36">GetComponentIds</a>();</div><div class="line"><a name="l00234"></a><span class="lineno"> 234</span>&#160; std::vector&lt;std::vector&lt;T&gt;&gt; components(delegate_.<a class="code" href="classDenseConnectedComponentsFinder.html#a5090a0bdc205d23778d2b8a742f5c5fd">GetNumberOfComponents</a>());</div><div class="line"><a name="l00235"></a><span class="lineno"> 235</span>&#160; <span class="keywordflow">for</span> (<span class="keyword">const</span> <span class="keyword">auto</span>&amp; elem_id : index_) {</div><div class="line"><a name="l00236"></a><span class="lineno"> 236</span>&#160; components[component_ids[elem_id.second]].push_back(elem_id.first);</div><div class="line"><a name="l00237"></a><span class="lineno"> 237</span>&#160; }</div><div class="line"><a name="l00238"></a><span class="lineno"> 238</span>&#160; <span class="keywordflow">return</span> components;</div><div class="line"><a name="l00239"></a><span class="lineno"> 239</span>&#160; }</div><div class="line"><a name="l00240"></a><span class="lineno"><a class="line" href="classConnectedComponentsFinder.html#a7f7b2f745e4c87bcaafec8fa295bfa91"> 240</a></span>&#160; <span class="keywordtype">void</span> <a class="code" href="classConnectedComponentsFinder.html#a7f7b2f745e4c87bcaafec8fa295bfa91">FindConnectedComponents</a>(</div><div class="line"><a name="l00241"></a><span class="lineno"> 241</span>&#160; std::vector&lt;<span class="keyword">typename</span> internal::ConnectedComponentsTypeHelper&lt;</div><div class="line"><a name="l00242"></a><span class="lineno"> 242</span>&#160; T, CompareOrHashT&gt;::Set&gt;* components) {</div><div class="line"><a name="l00243"></a><span class="lineno"> 243</span>&#160; <span class="keyword">const</span> <span class="keyword">auto</span> component_ids = delegate_.<a class="code" href="classDenseConnectedComponentsFinder.html#aee7f0057f42256a520b5ef32bae58b36">GetComponentIds</a>();</div><div class="line"><a name="l00244"></a><span class="lineno"> 244</span>&#160; components-&gt;clear();</div><div class="line"><a name="l00245"></a><span class="lineno"> 245</span>&#160; components-&gt;resize(delegate_.<a class="code" href="classDenseConnectedComponentsFinder.html#a5090a0bdc205d23778d2b8a742f5c5fd">GetNumberOfComponents</a>());</div><div class="line"><a name="l00246"></a><span class="lineno"> 246</span>&#160; <span class="keywordflow">for</span> (<span class="keyword">const</span> <span class="keyword">auto</span>&amp; elem_id : index_) {</div><div class="line"><a name="l00247"></a><span class="lineno"> 247</span>&#160; components-&gt;at(component_ids[elem_id.second]).insert(elem_id.first);</div><div class="line"><a name="l00248"></a><span class="lineno"> 248</span>&#160; }</div><div class="line"><a name="l00249"></a><span class="lineno"> 249</span>&#160; }</div><div class="line"><a name="l00250"></a><span class="lineno"> 250</span>&#160;</div><div class="line"><a name="l00251"></a><span class="lineno"> 251</span>&#160; <span class="comment">// Returns the current number of connected components.</span></div><div class="line"><a name="l00252"></a><span class="lineno"> 252</span>&#160; <span class="comment">// This number can change as the new nodes or edges are added.</span></div><div class="line"><a name="l00253"></a><span class="lineno"><a class="line" href="classConnectedComponentsFinder.html#a30350bb98f0e1f7ae47ec1292d253b52"> 253</a></span>&#160; <span class="keywordtype">int</span> <a class="code" href="classConnectedComponentsFinder.html#a30350bb98f0e1f7ae47ec1292d253b52">GetNumberOfComponents</a>()<span class="keyword"> const </span>{</div><div class="line"><a name="l00254"></a><span class="lineno"> 254</span>&#160; <span class="keywordflow">return</span> delegate_.<a class="code" href="classDenseConnectedComponentsFinder.html#a5090a0bdc205d23778d2b8a742f5c5fd">GetNumberOfComponents</a>();</div><div class="line"><a name="l00255"></a><span class="lineno"> 255</span>&#160; }</div><div class="line"><a name="l00256"></a><span class="lineno"> 256</span>&#160;</div><div class="line"><a name="l00257"></a><span class="lineno"> 257</span>&#160; <span class="comment">// Returns the current number of added distinct nodes.</span></div><div class="line"><a name="l00258"></a><span class="lineno"> 258</span>&#160; <span class="comment">// This includes nodes added explicitly via the calls to AddNode() method</span></div><div class="line"><a name="l00259"></a><span class="lineno"> 259</span>&#160; <span class="comment">// and implicitly via the calls to AddEdge() method.</span></div><div class="line"><a name="l00260"></a><span class="lineno"> 260</span>&#160; <span class="comment">// Nodes that were added several times only count once.</span></div><div class="line"><a name="l00261"></a><span class="lineno"><a class="line" href="classConnectedComponentsFinder.html#a350a0a0790e558f619478ce97c8f2ae7"> 261</a></span>&#160; <span class="keywordtype">int</span> <a class="code" href="classConnectedComponentsFinder.html#a350a0a0790e558f619478ce97c8f2ae7">GetNumberOfNodes</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> delegate_.<a class="code" href="classDenseConnectedComponentsFinder.html#a317fb43e59ef01ebe3d0d492b4ab33dd">GetNumberOfNodes</a>(); }</div><div class="line"><a name="l00262"></a><span class="lineno"> 262</span>&#160;</div><div class="line"><a name="l00263"></a><span class="lineno"> 263</span>&#160; <span class="keyword">private</span>:</div><div class="line"><a name="l00264"></a><span class="lineno"> 264</span>&#160; <span class="comment">// Returns the index for the given node. If the node does not exist and</span></div><div class="line"><a name="l00265"></a><span class="lineno"> 265</span>&#160; <span class="comment">// update_delegate is true, explicitly add the node to the delegate.</span></div><div class="line"><a name="l00266"></a><span class="lineno"> 266</span>&#160; <span class="keyword">template</span> &lt;<span class="keywordtype">bool</span> update_delegate&gt;</div><div class="line"><a name="l00267"></a><span class="lineno"> 267</span>&#160; <span class="keywordtype">int</span> LookupOrInsertNode(T node) {</div><div class="line"><a name="l00268"></a><span class="lineno"> 268</span>&#160; <span class="keyword">const</span> <span class="keyword">auto</span> result = index_.emplace(node, index_.size());</div><div class="line"><a name="l00269"></a><span class="lineno"> 269</span>&#160; <span class="keyword">const</span> <span class="keywordtype">int</span> node_id = result.first-&gt;second;</div><div class="line"><a name="l00270"></a><span class="lineno"> 270</span>&#160; <span class="keywordflow">if</span> (update_delegate &amp;&amp; result.second) {</div><div class="line"><a name="l00271"></a><span class="lineno"> 271</span>&#160; <span class="comment">// A new index was created.</span></div><div class="line"><a name="l00272"></a><span class="lineno"> 272</span>&#160; delegate_.<a class="code" href="classDenseConnectedComponentsFinder.html#a46780e194c525fa9853fa899d69b4340">SetNumberOfNodes</a>(node_id + 1);</div><div class="line"><a name="l00273"></a><span class="lineno"> 273</span>&#160; }</div><div class="line"><a name="l00274"></a><span class="lineno"> 274</span>&#160; <span class="keywordflow">return</span> node_id;</div><div class="line"><a name="l00275"></a><span class="lineno"> 275</span>&#160; }</div><div class="line"><a name="l00276"></a><span class="lineno"> 276</span>&#160;</div><div class="line"><a name="l00277"></a><span class="lineno"> 277</span>&#160; <a class="code" href="classDenseConnectedComponentsFinder.html">DenseConnectedComponentsFinder</a> delegate_;</div><div class="line"><a name="l00278"></a><span class="lineno"> 278</span>&#160; <span class="keyword">typename</span> internal::ConnectedComponentsTypeHelper&lt;T, CompareOrHashT&gt;::Map</div><div class="line"><a name="l00279"></a><span class="lineno"> 279</span>&#160; index_;</div><div class="line"><a name="l00280"></a><span class="lineno"> 280</span>&#160;};</div><div class="line"><a name="l00281"></a><span class="lineno"> 281</span>&#160;</div><div class="line"><a name="l00282"></a><span class="lineno"> 282</span>&#160;<span class="comment">// =============================================================================</span></div><div class="line"><a name="l00283"></a><span class="lineno"> 283</span>&#160;<span class="comment">// Implementations of the method templates</span></div><div class="line"><a name="l00284"></a><span class="lineno"> 284</span>&#160;<span class="comment">// =============================================================================</span></div><div class="line"><a name="l00285"></a><span class="lineno"> 285</span>&#160;<span class="keyword">namespace </span><a class="code" href="namespaceutil.html">util</a> {</div><div class="line"><a name="l00286"></a><span class="lineno"> 286</span>&#160;<span class="keyword">template</span> &lt;<span class="keyword">class</span> UndirectedGraph&gt;</div><div class="line"><a name="l00287"></a><span class="lineno"> 287</span>&#160;std::vector&lt;int&gt; <a class="code" href="namespaceutil.html#a13f0e8f7e15873600cf8e395958c71e1">GetConnectedComponents</a>(<span class="keywordtype">int</span> num_nodes,</div><div class="line"><a name="l00288"></a><span class="lineno"> 288</span>&#160; <span class="keyword">const</span> UndirectedGraph&amp; graph) {</div><div class="line"><a name="l00289"></a><span class="lineno"><a class="line" href="namespaceutil.html#a13f0e8f7e15873600cf8e395958c71e1"> 289</a></span>&#160; std::vector&lt;int&gt; component_of_node(num_nodes, -1);</div><div class="line"><a name="l00290"></a><span class="lineno"> 290</span>&#160; std::vector&lt;int&gt; bfs_queue;</div><div class="line"><a name="l00291"></a><span class="lineno"> 291</span>&#160; <span class="keywordtype">int</span> num_components = 0;</div><div class="line"><a name="l00292"></a><span class="lineno"> 292</span>&#160; <span class="keywordflow">for</span> (<span class="keywordtype">int</span> src = 0; src &lt; num_nodes; ++src) {</div><div class="line"><a name="l00293"></a><span class="lineno"> 293</span>&#160; <span class="keywordflow">if</span> (component_of_node[src] &gt;= 0) <span class="keywordflow">continue</span>;</div><div class="line"><a name="l00294"></a><span class="lineno"> 294</span>&#160; bfs_queue.push_back(src);</div><div class="line"><a name="l00295"></a><span class="lineno"> 295</span>&#160; component_of_node[src] = num_components;</div><div class="line"><a name="l00296"></a><span class="lineno"> 296</span>&#160; <span class="keywordflow">for</span> (<span class="keywordtype">int</span> num_visited = 0; num_visited &lt; bfs_queue.size(); ++num_visited) {</div><div class="line"><a name="l00297"></a><span class="lineno"> 297</span>&#160; <span class="keyword">const</span> <span class="keywordtype">int</span> node = bfs_queue[num_visited];</div><div class="line"><a name="l00298"></a><span class="lineno"> 298</span>&#160; <span class="keywordflow">for</span> (<span class="keyword">const</span> <span class="keywordtype">int</span> neighbor : graph[node]) {</div><div class="line"><a name="l00299"></a><span class="lineno"> 299</span>&#160; <span class="keywordflow">if</span> (component_of_node[neighbor] &gt;= 0) <span class="keywordflow">continue</span>;</div><div class="line"><a name="l00300"></a><span class="lineno"> 300</span>&#160; component_of_node[neighbor] = num_components;</div><div class="line"><a name="l00301"></a><span class="lineno"> 301</span>&#160; bfs_queue.push_back(neighbor);</div><div class="line"><a name="l00302"></a><span class="lineno"> 302</span>&#160; }</div><div class="line"><a name="l00303"></a><span class="lineno"> 303</span>&#160; }</div><div class="line"><a name="l00304"></a><span class="lineno"> 304</span>&#160; ++num_components;</div><div class="line"><a name="l00305"></a><span class="lineno"> 305</span>&#160; bfs_queue.clear();</div><div class="line"><a name="l00306"></a><span class="lineno"> 306</span>&#160; }</div><div class="line"><a name="l00307"></a><span class="lineno"> 307</span>&#160; <span class="keywordflow">return</span> component_of_node;</div><div class="line"><a name="l00308"></a><span class="lineno"> 308</span>&#160;}</div><div class="line"><a name="l00309"></a><span class="lineno"> 309</span>&#160;} <span class="comment">// namespace util</span></div><div class="line"><a name="l00310"></a><span class="lineno"> 310</span>&#160;</div><div class="line"><a name="l00311"></a><span class="lineno"> 311</span>&#160;<span class="preprocessor">#endif // UTIL_GRAPH_CONNECTED_COMPONENTS_H_</span></div><div class="ttc" id="classConnectedComponentsFinder_html_a77a24beaed190e2f3a0d12662a65b18a"><div class="ttname"><a href="classConnectedComponentsFinder.html#a77a24beaed190e2f3a0d12662a65b18a">ConnectedComponentsFinder::AddEdge</a></div><div class="ttdeci">void AddEdge(T node1, T node2)</div><div class="ttdoc">Adds an edge in the graph.</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00204">connected_components.h:204</a></div></div>
<div class="ttc" id="classConnectedComponentsFinder_html_a93b2c753675c77bfdbc0c33eb582380b"><div class="ttname"><a href="classConnectedComponentsFinder.html#a93b2c753675c77bfdbc0c33eb582380b">ConnectedComponentsFinder::AddNode</a></div><div class="ttdeci">void AddNode(T node)</div><div class="ttdoc">Adds a node in the graph.</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00200">connected_components.h:200</a></div></div>
<div class="ttc" id="classDenseConnectedComponentsFinder_html_a071f52956431e211e14ed7f3894c1d0b"><div class="ttname"><a href="classDenseConnectedComponentsFinder.html#a071f52956431e211e14ed7f3894c1d0b">DenseConnectedComponentsFinder::Connected</a></div><div class="ttdeci">bool Connected(int node1, int node2)</div></div>
<div class="ttc" id="namespaceutil_html"><div class="ttname"><a href="namespaceutil.html">util</a></div><div class="ttdoc">Licensed under the Apache License, Version 2.0 (the &quot;License&quot;); you may not use this file except in c...</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00056">connected_components.h:56</a></div></div>
<div class="ttc" id="classConnectedComponentsFinder_html_aa669a113d3ee23c506b97949f740b1cc"><div class="ttname"><a href="classConnectedComponentsFinder.html#aa669a113d3ee23c506b97949f740b1cc">ConnectedComponentsFinder::ConnectedComponentsFinder</a></div><div class="ttdeci">ConnectedComponentsFinder()</div><div class="ttdoc">Constructs a connected components finder.</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00192">connected_components.h:192</a></div></div>
<div class="ttc" id="classConnectedComponentsFinder_html_a7a173636e3dce11a27f2f7121e01a563"><div class="ttname"><a href="classConnectedComponentsFinder.html#a7a173636e3dce11a27f2f7121e01a563">ConnectedComponentsFinder::GetSize</a></div><div class="ttdeci">int GetSize(T node)</div><div class="ttdoc">Finds the connected component containing a node, and returns the total number of nodes in that compon...</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00219">connected_components.h:219</a></div></div>
<div class="ttc" id="classDenseConnectedComponentsFinder_html_a46780e194c525fa9853fa899d69b4340"><div class="ttname"><a href="classDenseConnectedComponentsFinder.html#a46780e194c525fa9853fa899d69b4340">DenseConnectedComponentsFinder::SetNumberOfNodes</a></div><div class="ttdeci">void SetNumberOfNodes(int num_nodes)</div><div class="ttdoc">Sets the number of nodes in the graph.</div></div>
<div class="ttc" id="classConnectedComponentsFinder_html_a9eaa06cffceda90c1d44f550ad3459f3"><div class="ttname"><a href="classConnectedComponentsFinder.html#a9eaa06cffceda90c1d44f550ad3459f3">ConnectedComponentsFinder::FindConnectedComponents</a></div><div class="ttdeci">std::vector&lt; std::vector&lt; T &gt; &gt; FindConnectedComponents()</div><div class="ttdoc">Finds all the connected components and assigns them to components.</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00232">connected_components.h:232</a></div></div>
<div class="ttc" id="classDenseConnectedComponentsFinder_html_a33639c91528c2a525e1591df24ff2cc9"><div class="ttname"><a href="classDenseConnectedComponentsFinder.html#a33639c91528c2a525e1591df24ff2cc9">DenseConnectedComponentsFinder::DenseConnectedComponentsFinder</a></div><div class="ttdeci">DenseConnectedComponentsFinder()</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00083">connected_components.h:83</a></div></div>
<div class="ttc" id="classDenseConnectedComponentsFinder_html"><div class="ttname"><a href="classDenseConnectedComponentsFinder.html">DenseConnectedComponentsFinder</a></div><div class="ttdoc">NOTE(user): The rest of the functions below should also be in namespace util, but for historical reas...</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00081">connected_components.h:81</a></div></div>
<div class="ttc" id="namespaceutil_html_a13f0e8f7e15873600cf8e395958c71e1"><div class="ttname"><a href="namespaceutil.html#a13f0e8f7e15873600cf8e395958c71e1">util::GetConnectedComponents</a></div><div class="ttdeci">std::vector&lt; int &gt; GetConnectedComponents(int num_nodes, const UndirectedGraph &amp;graph)</div><div class="ttdoc">Finds the connected components of the graph, using BFS internally.</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00289">connected_components.h:289</a></div></div>
<div class="ttc" id="classConnectedComponentsFinder_html_a350a0a0790e558f619478ce97c8f2ae7"><div class="ttname"><a href="classConnectedComponentsFinder.html#a350a0a0790e558f619478ce97c8f2ae7">ConnectedComponentsFinder::GetNumberOfNodes</a></div><div class="ttdeci">int GetNumberOfNodes() const</div><div class="ttdoc">Returns the current number of added distinct nodes.</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00261">connected_components.h:261</a></div></div>
<div class="ttc" id="classDenseConnectedComponentsFinder_html_a317fb43e59ef01ebe3d0d492b4ab33dd"><div class="ttname"><a href="classDenseConnectedComponentsFinder.html#a317fb43e59ef01ebe3d0d492b4ab33dd">DenseConnectedComponentsFinder::GetNumberOfNodes</a></div><div class="ttdeci">int GetNumberOfNodes() const</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00096">connected_components.h:96</a></div></div>
<div class="ttc" id="classConnectedComponentsFinder_html_a67dc34888511ab5b90b7389c90dbc1f8"><div class="ttname"><a href="classConnectedComponentsFinder.html#a67dc34888511ab5b90b7389c90dbc1f8">ConnectedComponentsFinder::Connected</a></div><div class="ttdeci">bool Connected(T node1, T node2)</div><div class="ttdoc">Returns true iff both nodes are in the same connected component.</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00211">connected_components.h:211</a></div></div>
<div class="ttc" id="classConnectedComponentsFinder_html_a30350bb98f0e1f7ae47ec1292d253b52"><div class="ttname"><a href="classConnectedComponentsFinder.html#a30350bb98f0e1f7ae47ec1292d253b52">ConnectedComponentsFinder::GetNumberOfComponents</a></div><div class="ttdeci">int GetNumberOfComponents() const</div><div class="ttdoc">Returns the current number of connected components.</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00253">connected_components.h:253</a></div></div>
<div class="ttc" id="classConnectedComponentsFinder_html_a21da7363443c34ad00c529fae4b3b3e2"><div class="ttname"><a href="classConnectedComponentsFinder.html#a21da7363443c34ad00c529fae4b3b3e2">ConnectedComponentsFinder::operator=</a></div><div class="ttdeci">ConnectedComponentsFinder &amp; operator=(const ConnectedComponentsFinder &amp;)=delete</div></div>
<div class="ttc" id="classDenseConnectedComponentsFinder_html_a5090a0bdc205d23778d2b8a742f5c5fd"><div class="ttname"><a href="classDenseConnectedComponentsFinder.html#a5090a0bdc205d23778d2b8a742f5c5fd">DenseConnectedComponentsFinder::GetNumberOfComponents</a></div><div class="ttdeci">int GetNumberOfComponents() const</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00095">connected_components.h:95</a></div></div>
<div class="ttc" id="classConnectedComponentsFinder_html"><div class="ttname"><a href="classConnectedComponentsFinder.html">ConnectedComponentsFinder</a></div><div class="ttdoc">Usage: ConnectedComponentsFinder&lt;MyNodeType&gt; cc; cc.AddNode(node1); cc.AddNode(node2); cc....</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00189">connected_components.h:189</a></div></div>
<div class="ttc" id="classDenseConnectedComponentsFinder_html_a0a639b64de57bc14f04f0f238e0092d1"><div class="ttname"><a href="classDenseConnectedComponentsFinder.html#a0a639b64de57bc14f04f0f238e0092d1">DenseConnectedComponentsFinder::GetSize</a></div><div class="ttdeci">int GetSize(int node)</div></div>
<div class="ttc" id="classDenseConnectedComponentsFinder_html_aee7f0057f42256a520b5ef32bae58b36"><div class="ttname"><a href="classDenseConnectedComponentsFinder.html#aee7f0057f42256a520b5ef32bae58b36">DenseConnectedComponentsFinder::GetComponentIds</a></div><div class="ttdeci">std::vector&lt; int &gt; GetComponentIds()</div><div class="ttdoc">Returns the same as GetConnectedComponents().</div></div>
<div class="ttc" id="classDenseConnectedComponentsFinder_html_a20f2a5d6bb7631a0dcdd678387a1b61a"><div class="ttname"><a href="classDenseConnectedComponentsFinder.html#a20f2a5d6bb7631a0dcdd678387a1b61a">DenseConnectedComponentsFinder::operator=</a></div><div class="ttdeci">DenseConnectedComponentsFinder &amp; operator=(const DenseConnectedComponentsFinder &amp;)=delete</div></div>
<div class="ttc" id="classConnectedComponentsFinder_html_a7f7b2f745e4c87bcaafec8fa295bfa91"><div class="ttname"><a href="classConnectedComponentsFinder.html#a7f7b2f745e4c87bcaafec8fa295bfa91">ConnectedComponentsFinder::FindConnectedComponents</a></div><div class="ttdeci">void FindConnectedComponents(std::vector&lt; typename internal::ConnectedComponentsTypeHelper&lt; T, CompareOrHashT &gt;::Set &gt; *components)</div><div class="ttdef"><b>Definition:</b> <a href="connected__components_8h_source.html#l00240">connected_components.h:240</a></div></div>
<div class="ttc" id="classDenseConnectedComponentsFinder_html_aba450cf3f16d9386d043c4354a19a4aa"><div class="ttname"><a href="classDenseConnectedComponentsFinder.html#aba450cf3f16d9386d043c4354a19a4aa">DenseConnectedComponentsFinder::AddEdge</a></div><div class="ttdeci">void AddEdge(int node1, int node2)</div><div class="ttdoc">The main API is the same as ConnectedComponentsFinder (below): see the homonymous functions there.</div></div>
<div class="ttc" id="classDenseConnectedComponentsFinder_html_afdcff89dd2374ce33c05934d328e64ec"><div class="ttname"><a href="classDenseConnectedComponentsFinder.html#afdcff89dd2374ce33c05934d328e64ec">DenseConnectedComponentsFinder::FindRoot</a></div><div class="ttdeci">int FindRoot(int node)</div><div class="ttdoc">Returns the root of the set for the given node.</div></div>
</div><!-- fragment --></div><!-- contents -->
</div>
<div id="footer-container">
<div id="footer">
</div>
</div>
</body>
</html>