http://git-wip-us.apache.org/repos/asf/mesos-site/blob/76e6eac5/content/api/latest/c++/collect_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/collect_8hpp_source.html 
b/content/api/latest/c++/collect_8hpp_source.html
index 2250009..0586b89 100644
--- a/content/api/latest/c++/collect_8hpp_source.html
+++ b/content/api/latest/c++/collect_8hpp_source.html
@@ -52,7 +52,7 @@
 <div class="title">collect.hpp</div>  </div>
 </div><!--header-->
 <div class="contents">
-<a href="collect_8hpp.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">// Licensed under the Apache License, 
Version 2.0 (the &quot;License&quot;);</span></div><div class="line"><a 
name="l00002"></a><span class="lineno">    2</span>&#160;<span 
class="comment">// you may not use this file except in compliance with the 
License.</span></div><div class="line"><a name="l00003"></a><span 
class="lineno">    3</span>&#160;<span class="comment">// You may obtain a copy 
of the License at</span></div><div class="line"><a name="l00004"></a><span 
class="lineno">    4</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00005"></a><span class="lineno">    5</span>&#160;<span 
class="comment">//     
http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a 
name="l00006"></a><span class="lineno">    6</span>&#160;<span 
class="comment">//</s
 pan></div><div class="line"><a name="l00007"></a><span class="lineno">    
7</span>&#160;<span class="comment">// Unless required by applicable law or 
agreed to in writing, software</span></div><div class="line"><a 
name="l00008"></a><span class="lineno">    8</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="l00009"></a><span 
class="lineno">    9</span>&#160;<span class="comment">// WITHOUT WARRANTIES OR 
CONDITIONS OF ANY KIND, either express or implied.</span></div><div 
class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span 
class="comment">// See the License for the specific language governing 
permissions and</span></div><div class="line"><a name="l00011"></a><span 
class="lineno">   11</span>&#160;<span class="comment">// limitations under the 
License</span></div><div class="line"><a name="l00012"></a><span 
class="lineno">   12</span>&#160;</div><div class="l
 ine"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span 
class="preprocessor">#ifndef __PROCESS_COLLECT_HPP__</span></div><div 
class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span 
class="preprocessor">#define __PROCESS_COLLECT_HPP__</span></div><div 
class="line"><a name="l00015"></a><span class="lineno">   
15</span>&#160;</div><div class="line"><a name="l00016"></a><span 
class="lineno">   16</span>&#160;<span class="preprocessor">#include 
&lt;functional&gt;</span></div><div class="line"><a name="l00017"></a><span 
class="lineno">   17</span>&#160;<span class="preprocessor">#include 
&lt;list&gt;</span></div><div class="line"><a name="l00018"></a><span 
class="lineno">   18</span>&#160;<span class="preprocessor">#include 
&lt;tuple&gt;</span></div><div class="line"><a name="l00019"></a><span 
class="lineno">   19</span>&#160;</div><div class="line"><a 
name="l00020"></a><span class="lineno">   20</span>&#160;<span 
class="preprocessor">#include &lt;<a
  class="code" 
href="libprocess_2include_2process_2check_8hpp.html">process/check.hpp</a>&gt;</span></div><div
 class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="defer_8hpp.html">process/defer.hpp</a>&gt;</span></div><div 
class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="future_8hpp.html">process/future.hpp</a>&gt;</span></div><div 
class="line"><a name="l00023"></a><span class="lineno">   23</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="id_8hpp.html">process/id.hpp</a>&gt;</span></div><div class="line"><a 
name="l00024"></a><span class="lineno">   24</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="owned_8hpp.html">process/owned.hpp</a>&gt;</span></div><div 
class="line"><a name="l00025"></a><span class="lineno">   25</span>&#160;<span 
class="preprocessor">#include &l
 t;<a class="code" 
href="libprocess_2include_2process_2process_8hpp.html">process/process.hpp</a>&gt;</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="preprocessor">#include &lt;<a 
class="code" href="lambda_8hpp.html">stout/lambda.hpp</a>&gt;</span></div><div 
class="line"><a name="l00028"></a><span class="lineno">   
28</span>&#160;</div><div class="line"><a name="l00029"></a><span 
class="lineno">   29</span>&#160;<span class="comment">// TODO(bmahler): Move 
these into a futures.hpp header to group Future</span></div><div 
class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;<span 
class="comment">// related utilities.</span></div><div class="line"><a 
name="l00031"></a><span class="lineno">   31</span>&#160;</div><div 
class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;<span 
class="keyword">namespace </span><a 
 class="code" href="namespaceprocess.html">process</a> {</div><div 
class="line"><a name="l00033"></a><span class="lineno">   
33</span>&#160;</div><div class="line"><a name="l00034"></a><span 
class="lineno">   34</span>&#160;<span class="comment">// Waits on each future 
in the specified list and returns the list of</span></div><div class="line"><a 
name="l00035"></a><span class="lineno">   35</span>&#160;<span 
class="comment">// resulting values in the same order. If any future is 
discarded then</span></div><div class="line"><a name="l00036"></a><span 
class="lineno">   36</span>&#160;<span class="comment">// the result will be a 
failure. Likewise, if any future fails then</span></div><div class="line"><a 
name="l00037"></a><span class="lineno">   37</span>&#160;<span 
class="comment">// the result future will be a failure.</span></div><div 
class="line"><a name="l00038"></a><span class="lineno">   38</span>&#160;<span 
class="keyword">template</span> &lt;<span class="keyword">typename</spa
 n> T&gt;</div><div class="line"><a name="l00039"></a><span class="lineno">   
39</span>&#160;Future&lt;std::list&lt;T&gt;&gt; <a class="code" 
href="namespaceprocess.html#a0f89a937c1caa20e3048e16aeb0c9736">collect</a>(<span
 class="keyword">const</span> <a class="code" 
href="namespacecgroups_1_1devices.html#a22494291bc2cb89697dcd2b5f288bdd3">std::list</a>&lt;Future&lt;T&gt;&gt;&amp;
 futures);</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;</div><div class="line"><a 
name="l00042"></a><span class="lineno">   42</span>&#160;<span 
class="comment">// Waits on each future specified and returns the wrapping 
future</span></div><div class="line"><a name="l00043"></a><span class="lineno"> 
  43</span>&#160;<span class="comment">// typed of a tuple of 
values.</span></div><div class="line"><a name="l00044"></a><span 
class="lineno">   44</span>&#160;<span class="keyword">template</
 span> &lt;<span class="keyword">typename</span>... Ts&gt;</div><div 
class="line"><a name="l00045"></a><span class="lineno">   
45</span>&#160;Future&lt;std::tuple&lt;Ts...&gt;&gt; <a class="code" 
href="namespaceprocess.html#a0f89a937c1caa20e3048e16aeb0c9736">collect</a>(<span
 class="keyword">const</span> Future&lt;Ts&gt;&amp;... futures);</div><div 
class="line"><a name="l00046"></a><span class="lineno">   
46</span>&#160;</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="comment">// Waits on each future in the specified set and returns the 
list of</span></div><div class="line"><a name="l00049"></a><span 
class="lineno">   49</span>&#160;<span class="comment">// non-pending 
futures.</span></div><div class="line"><a name="l00050"></a><span 
class="lineno">   50</span>&#160;<span class="keyword">template</span> 
&lt;<span class="keyword">typename</span> T&gt;</di
 v><div class="line"><a name="l00051"></a><span class="lineno">   
51</span>&#160;Future&lt;std::list&lt;Future&lt;T&gt;&gt;&gt; <a class="code" 
href="namespaceprocess.html#a9244f063b856adbc7182f8620b01034c">await</a>(<span 
class="keyword">const</span> <a class="code" 
href="namespacecgroups_1_1devices.html#a22494291bc2cb89697dcd2b5f288bdd3">std::list</a>&lt;Future&lt;T&gt;&gt;&amp;
 futures);</div><div class="line"><a name="l00052"></a><span class="lineno">   
52</span>&#160;</div><div class="line"><a name="l00053"></a><span 
class="lineno">   53</span>&#160;</div><div class="line"><a 
name="l00054"></a><span class="lineno">   54</span>&#160;<span 
class="comment">// Waits on each future specified and returns the wrapping 
future</span></div><div class="line"><a name="l00055"></a><span class="lineno"> 
  55</span>&#160;<span class="comment">// typed of a tuple of 
futures.</span></div><div class="line"><a name="l00056"></a><span 
class="lineno">   56</span>&#160;<span class="keyword">template<
 /span> &lt;<span class="keyword">typename</span>... Ts&gt;</div><div 
class="line"><a name="l00057"></a><span class="lineno">   
57</span>&#160;Future&lt;std::tuple&lt;Future&lt;Ts&gt;...&gt;&gt; <a 
class="code" 
href="namespaceprocess.html#a9244f063b856adbc7182f8620b01034c">await</a>(<span 
class="keyword">const</span> Future&lt;Ts&gt;&amp;... futures);</div><div 
class="line"><a name="l00058"></a><span class="lineno">   
58</span>&#160;</div><div class="line"><a name="l00059"></a><span 
class="lineno">   59</span>&#160;</div><div class="line"><a 
name="l00060"></a><span class="lineno">   60</span>&#160;<span 
class="comment">// Waits on the future specified and returns after the future 
has been</span></div><div class="line"><a name="l00061"></a><span 
class="lineno">   61</span>&#160;<span class="comment">// completed or the 
await has been discarded. This is useful when</span></div><div class="line"><a 
name="l00062"></a><span class="lineno">   62</span>&#160;<span 
class="comment">// wanting
  to &quot;break out&quot; of a future chain if a discard occurs 
but</span></div><div class="line"><a name="l00063"></a><span class="lineno">   
63</span>&#160;<span class="comment">// the underlying future has not been 
discarded. For example:</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">//   
Future&lt;string&gt; foo()</span></div><div class="line"><a 
name="l00066"></a><span class="lineno">   66</span>&#160;<span 
class="comment">//   {</span></div><div class="line"><a name="l00067"></a><span 
class="lineno">   67</span>&#160;<span class="comment">//     return 
bar()</span></div><div class="line"><a name="l00068"></a><span class="lineno">  
 68</span>&#160;<span class="comment">//       .then([](int i) 
{</span></div><div class="line"><a name="l00069"></a><span class="lineno">   
69</span>&#160;<span class="com
 ment">//         return stringify(i);</span></div><div class="line"><a 
name="l00070"></a><span class="lineno">   70</span>&#160;<span 
class="comment">//       });</span></div><div class="line"><a 
name="l00071"></a><span class="lineno">   71</span>&#160;<span 
class="comment">//   }</span></div><div class="line"><a name="l00072"></a><span 
class="lineno">   72</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;<span 
class="comment">//   Future&lt;stringify&gt; future = foo();</span></div><div 
class="line"><a name="l00074"></a><span class="lineno">   74</span>&#160;<span 
class="comment">//   future.discard();</span></div><div class="line"><a 
name="l00075"></a><span class="lineno">   75</span>&#160;<span 
class="comment">//</span></div><div class="line"><a name="l00076"></a><span 
class="lineno">   76</span>&#160;<span class="comment">// In the above code 
we&#39;ll propagate the discard to `bar()` but might</span><
 /div><div class="line"><a name="l00077"></a><span class="lineno">   
77</span>&#160;<span class="comment">// wait forever if `bar()` can&#39;t 
discard their computation. In some</span></div><div class="line"><a 
name="l00078"></a><span class="lineno">   78</span>&#160;<span 
class="comment">// circumstances you might want to break out early and you can 
do that</span></div><div class="line"><a name="l00079"></a><span 
class="lineno">   79</span>&#160;<span class="comment">// by using `await`, 
because if we discard an `await` that function</span></div><div class="line"><a 
name="l00080"></a><span class="lineno">   80</span>&#160;<span 
class="comment">// will return even though all of the future&#39;s it is 
waiting on have</span></div><div class="line"><a name="l00081"></a><span 
class="lineno">   81</span>&#160;<span class="comment">// not been discarded 
(in other words, the `await` can be properly</span></div><div class="line"><a 
name="l00082"></a><span class="lineno">   82</span>&#160;<sp
 an class="comment">// discarded even if the underlying futures have not been 
discarded).</span></div><div class="line"><a name="l00083"></a><span 
class="lineno">   83</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;<span 
class="comment">//   Future&lt;string&gt; foo()</span></div><div 
class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;<span 
class="comment">//   {</span></div><div class="line"><a name="l00086"></a><span 
class="lineno">   86</span>&#160;<span class="comment">//     return 
await(bar())</span></div><div class="line"><a name="l00087"></a><span 
class="lineno">   87</span>&#160;<span class="comment">//       
.recover([](const Future&lt;Future&lt;string&gt;&gt;&amp; future) 
{</span></div><div class="line"><a name="l00088"></a><span class="lineno">   
88</span>&#160;<span class="comment">//         if (future.isDiscarded()) 
{</span></div><div class="line"><a name="l00089"></a>
 <span class="lineno">   89</span>&#160;<span class="comment">//           
cleanup();</span></div><div class="line"><a name="l00090"></a><span 
class="lineno">   90</span>&#160;<span class="comment">//         
}</span></div><div class="line"><a name="l00091"></a><span class="lineno">   
91</span>&#160;<span class="comment">//         return Failure(&quot;Discarded 
waiting&quot;);</span></div><div class="line"><a name="l00092"></a><span 
class="lineno">   92</span>&#160;<span class="comment">//       
})</span></div><div class="line"><a name="l00093"></a><span class="lineno">   
93</span>&#160;<span class="comment">//       .then([](const 
Future&lt;int&gt;&amp; future) {</span></div><div class="line"><a 
name="l00094"></a><span class="lineno">   94</span>&#160;<span 
class="comment">//         return future</span></div><div class="line"><a 
name="l00095"></a><span class="lineno">   95</span>&#160;<span 
class="comment">//           .then([](int i) {</span></div><div class="line"><a 
name="l0009
 6"></a><span class="lineno">   96</span>&#160;<span class="comment">//         
    return stringify(i);</span></div><div class="line"><a 
name="l00097"></a><span class="lineno">   97</span>&#160;<span 
class="comment">//           });</span></div><div class="line"><a 
name="l00098"></a><span class="lineno">   98</span>&#160;<span 
class="comment">//       });</span></div><div class="line"><a 
name="l00099"></a><span class="lineno">   99</span>&#160;<span 
class="comment">//   }</span></div><div class="line"><a name="l00100"></a><span 
class="lineno">  100</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;<span 
class="comment">//   Future&lt;string&gt; future = foo();</span></div><div 
class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;<span 
class="comment">//   future.discard();</span></div><div class="line"><a 
name="l00103"></a><span class="lineno">  103</span>&#160;<span 
class="comment">//</
 span></div><div class="line"><a name="l00104"></a><span class="lineno">  
104</span>&#160;<span class="comment">// Using `await` will enable you to 
continue execution even if `bar()`</span></div><div class="line"><a 
name="l00105"></a><span class="lineno">  105</span>&#160;<span 
class="comment">// does not (or can not) discard their 
execution.</span></div><div class="line"><a name="l00106"></a><span 
class="lineno">  106</span>&#160;<span class="keyword">template</span> 
&lt;<span class="keyword">typename</span> T&gt;</div><div class="line"><a 
name="l00107"></a><span class="lineno"><a class="line" 
href="namespaceprocess.html#a9d64abf575bde6dc82f9d915b33743c8">  
107</a></span>&#160;<a class="code" 
href="classprocess_1_1Future.html">Future&lt;Future&lt;T&gt;</a>&gt; <a 
class="code" 
href="namespaceprocess.html#a9244f063b856adbc7182f8620b01034c">await</a>(<span 
class="keyword">const</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&amp; future)</div><div 
class="l
 ine"><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="keywordflow">return</span> <a class="code" 
href="namespaceprocess.html#a9244f063b856adbc7182f8620b01034c">await</a>(<a 
class="code" 
href="namespacecgroups_1_1devices.html#a22494291bc2cb89697dcd2b5f288bdd3">std::list</a>&lt;<a
 class="code" 
href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&gt;{future})</div><div 
class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;    
.<a class="code" 
href="namespaceprocess_1_1internal.html#a7885011cf6470b707294a6ef4ec7a0a6">then</a>([=]()
 {</div><div class="line"><a name="l00111"></a><span class="lineno">  
111</span>&#160;      <span class="keywordflow">return</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;Future&lt;T&gt;</a>&gt;(future);</div><div
 class="line"><a name="l00112"></a><span class="lineno">  112</span>&#160;    
});</div><div class
 ="line"><a name="l00113"></a><span class="lineno">  
113</span>&#160;}</div><div class="line"><a name="l00114"></a><span 
class="lineno">  114</span>&#160;</div><div class="line"><a 
name="l00115"></a><span class="lineno">  115</span>&#160;</div><div 
class="line"><a name="l00116"></a><span class="lineno"><a class="line" 
href="namespaceprocess_1_1internal.html">  116</a></span>&#160;<span 
class="keyword">namespace </span><a class="code" 
href="namespaceinternal.html">internal</a> {</div><div class="line"><a 
name="l00117"></a><span class="lineno">  117</span>&#160;</div><div 
class="line"><a name="l00118"></a><span class="lineno">  118</span>&#160;<span 
class="keyword">template</span> &lt;<span class="keyword">typename</span> 
T&gt;</div><div class="line"><a name="l00119"></a><span class="lineno"><a 
class="line" href="classprocess_1_1internal_1_1CollectProcess.html">  
119</a></span>&#160;<span class="keyword">class </span><a class="code" 
href="classprocess_1_1internal_1_1CollectProcess.html
 ">CollectProcess</a> : <span class="keyword">public</span> <a class="code" 
href="classprocess_1_1Process.html">Process</a>&lt;CollectProcess&lt;T&gt;&gt;</div><div
 class="line"><a name="l00120"></a><span class="lineno">  
120</span>&#160;{</div><div class="line"><a name="l00121"></a><span 
class="lineno">  121</span>&#160;<span class="keyword">public</span>:</div><div 
class="line"><a name="l00122"></a><span class="lineno"><a class="line" 
href="classprocess_1_1internal_1_1CollectProcess.html#aeae1fffc984af46ddb3b0570408c5ee0">
  122</a></span>&#160;  <a class="code" 
href="classprocess_1_1internal_1_1CollectProcess.html#aeae1fffc984af46ddb3b0570408c5ee0">CollectProcess</a>(</div><div
 class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;      
<span class="keyword">const</span> <a class="code" 
href="namespacecgroups_1_1devices.html#a22494291bc2cb89697dcd2b5f288bdd3">std::list</a>&lt;<a
 class="code" href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&gt;&amp; 
_futures
 ,</div><div class="line"><a name="l00124"></a><span class="lineno">  
124</span>&#160;      <a class="code" 
href="classprocess_1_1Promise.html">Promise</a>&lt;std::list&lt;T&gt;&gt;* 
_promise)</div><div class="line"><a name="l00125"></a><span class="lineno">  
125</span>&#160;    : <a class="code" 
href="classprocess_1_1ProcessBase.html">ProcessBase</a>(ID::<a class="code" 
href="namespaceprocess_1_1ID.html#aeb11a48c9def1da169d8455a30d0ee39">generate</a>(<span
 class="stringliteral">&quot;__collect__&quot;</span>)),</div><div 
class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;      
futures(_futures),</div><div class="line"><a name="l00127"></a><span 
class="lineno">  127</span>&#160;      promise(_promise),</div><div 
class="line"><a name="l00128"></a><span class="lineno">  128</span>&#160;      
ready(0) {}</div><div class="line"><a name="l00129"></a><span class="lineno">  
129</span>&#160;</div><div class="line"><a name="l00130"></a><span 
class="lineno"><a class="line
 " 
href="classprocess_1_1internal_1_1CollectProcess.html#aef71c5f6f3c016b544805111417573a8">
  130</a></span>&#160;  <span class="keyword">virtual</span> <a class="code" 
href="classprocess_1_1internal_1_1CollectProcess.html#aef71c5f6f3c016b544805111417573a8">~CollectProcess</a>()</div><div
 class="line"><a name="l00131"></a><span class="lineno">  131</span>&#160;  
{</div><div class="line"><a name="l00132"></a><span class="lineno">  
132</span>&#160;    <span class="keyword">delete</span> promise;</div><div 
class="line"><a name="l00133"></a><span class="lineno">  133</span>&#160;  
}</div><div class="line"><a name="l00134"></a><span class="lineno">  
134</span>&#160;</div><div class="line"><a name="l00135"></a><span 
class="lineno">  135</span>&#160;<span 
class="keyword">protected</span>:</div><div class="line"><a 
name="l00136"></a><span class="lineno"><a class="line" 
href="classprocess_1_1internal_1_1CollectProcess.html#a6e13d430bd37e93903d3f0b4201b8e31">
  136</a></span>&#160;  <span class
 ="keyword">virtual</span> <span class="keywordtype">void</span> <a 
class="code" 
href="classprocess_1_1internal_1_1CollectProcess.html#a6e13d430bd37e93903d3f0b4201b8e31">initialize</a>()</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">// Stop this nonsense if nobody 
cares.</span></div><div class="line"><a name="l00139"></a><span class="lineno"> 
 139</span>&#160;    promise-&gt;<a class="code" 
href="classprocess_1_1Promise.html#a8aef752d6c90cb11e58e3166b7592ef1">future</a>().<a
 class="code" 
href="classprocess_1_1Future.html#a1b80bf321358be44880d9c6bae5d9a2d">onDiscard</a>(<a
 class="code" 
href="namespaceprocess.html#a8b27a2ef76eb133bf0ce7a5eea4fb77c">defer</a>(<span 
class="keyword">this</span>, &amp;CollectProcess::discarded));</div><div 
class="line"><a name="l00140"></a><span class="lineno">  
140</span>&#160;</div><div class="line"><a name
 ="l00141"></a><span class="lineno">  141</span>&#160;    <span 
class="keywordflow">foreach</span> (<span class="keyword">const</span> <a 
class="code" href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&amp; 
future, futures) {</div><div class="line"><a name="l00142"></a><span 
class="lineno">  142</span>&#160;      future.<a class="code" 
href="classprocess_1_1Future.html#a71bde220aed3c725cef2040f63adf42a">onAny</a>(<a
 class="code" 
href="namespaceprocess.html#a8b27a2ef76eb133bf0ce7a5eea4fb77c">defer</a>(<span 
class="keyword">this</span>, &amp;CollectProcess::waited, 
lambda::_1));</div><div class="line"><a name="l00143"></a><span class="lineno"> 
 143</span>&#160;      future.<a class="code" 
href="classprocess_1_1Future.html#a3ef51b1f7e70860758e47c39ed7660f1">onAbandoned</a>(<a
 class="code" 
href="namespaceprocess.html#a8b27a2ef76eb133bf0ce7a5eea4fb77c">defer</a>(<span 
class="keyword">this</span>, &amp;CollectProcess::abandoned));</div><div 
class="line"><a name="l00144"></a><span class
 ="lineno">  144</span>&#160;    }</div><div class="line"><a 
name="l00145"></a><span class="lineno">  145</span>&#160;  }</div><div 
class="line"><a name="l00146"></a><span class="lineno">  
146</span>&#160;</div><div class="line"><a name="l00147"></a><span 
class="lineno">  147</span>&#160;<span 
class="keyword">private</span>:</div><div class="line"><a 
name="l00148"></a><span class="lineno">  148</span>&#160;  <span 
class="keywordtype">void</span> abandoned()</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="comment">// There is no use waiting because this future will never 
complete</span></div><div class="line"><a name="l00151"></a><span 
class="lineno">  151</span>&#160;    <span class="comment">// so terminate this 
process which will cause `promise` to get</span></div><div class="line"><a 
name="l00152"></a><span class="lineno">  152</span>&#160;    
 <span class="comment">// deleted and our future to also be 
abandoned.</span></div><div class="line"><a name="l00153"></a><span 
class="lineno">  153</span>&#160;    <a class="code" 
href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 class="keyword">this</span>);</div><div class="line"><a 
name="l00154"></a><span class="lineno">  154</span>&#160;  }</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="keywordtype">void</span> 
discarded()</div><div class="line"><a name="l00157"></a><span class="lineno">  
157</span>&#160;  {</div><div class="line"><a name="l00158"></a><span 
class="lineno">  158</span>&#160;    <span class="keywordflow">foreach</span> 
(<a class="code" href="classprocess_1_1Future.html">Future&lt;T&gt;</a> future, 
futures) {</div><div class="line"><a name="l00159"></a><span class="lineno">  
159</span>&#160;      fut
 ure.<a class="code" 
href="classprocess_1_1Future.html#a4012f3faa6191fc13874dca62c14ced0">discard</a>();</div><div
 class="line"><a name="l00160"></a><span class="lineno">  160</span>&#160;    
}</div><div class="line"><a name="l00161"></a><span class="lineno">  
161</span>&#160;</div><div class="line"><a name="l00162"></a><span 
class="lineno">  162</span>&#160;    <span class="comment">// NOTE: we discard 
the promise after we set discard on each of</span></div><div class="line"><a 
name="l00163"></a><span class="lineno">  163</span>&#160;    <span 
class="comment">// the futures so that there is a happens-before relationship 
that</span></div><div class="line"><a name="l00164"></a><span class="lineno">  
164</span>&#160;    <span class="comment">// can be assumed by 
callers.</span></div><div class="line"><a name="l00165"></a><span 
class="lineno">  165</span>&#160;    promise-&gt;<a class="code" 
href="classprocess_1_1Promise.html#a8f50fcfd7ddb6dd39ec2cd468377cd5d">discard</a>();</div><div
 c
 lass="line"><a name="l00166"></a><span class="lineno">  
166</span>&#160;</div><div class="line"><a name="l00167"></a><span 
class="lineno">  167</span>&#160;    <a class="code" 
href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 class="keyword">this</span>);</div><div class="line"><a 
name="l00168"></a><span class="lineno">  168</span>&#160;  }</div><div 
class="line"><a name="l00169"></a><span class="lineno">  
169</span>&#160;</div><div class="line"><a name="l00170"></a><span 
class="lineno">  170</span>&#160;  <span class="keywordtype">void</span> 
waited(<span class="keyword">const</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&amp; future)</div><div 
class="line"><a name="l00171"></a><span class="lineno">  171</span>&#160;  
{</div><div class="line"><a name="l00172"></a><span class="lineno">  
172</span>&#160;    <span class="keywordflow">if</span> (future.<a class="code" 
href="classprocess_1_1Future.html#a493227e57f8848e3777
 7b89c0f81e2ec">isFailed</a>()) {</div><div class="line"><a 
name="l00173"></a><span class="lineno">  173</span>&#160;      promise-&gt;<a 
class="code" 
href="classprocess_1_1Promise.html#a2fc569c8bf99acb3e53a68ff3b266667">fail</a>(<span
 class="stringliteral">&quot;Collect failed: &quot;</span> + future.<a 
class="code" 
href="classprocess_1_1Future.html#ae649c56b07f44c05e4b7aa3620133ff9">failure</a>());</div><div
 class="line"><a name="l00174"></a><span class="lineno">  174</span>&#160;      
<a class="code" 
href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 class="keyword">this</span>);</div><div class="line"><a 
name="l00175"></a><span class="lineno">  175</span>&#160;    } <span 
class="keywordflow">else</span> <span class="keywordflow">if</span> (future.<a 
class="code" 
href="classprocess_1_1Future.html#abc89036db733a417b7b383b091efaf3c">isDiscarded</a>())
 {</div><div class="line"><a name="l00176"></a><span class="lineno">  
176</span>&#160;      promise-&g
 t;<a class="code" 
href="classprocess_1_1Promise.html#a2fc569c8bf99acb3e53a68ff3b266667">fail</a>(<span
 class="stringliteral">&quot;Collect failed: future 
discarded&quot;</span>);</div><div class="line"><a name="l00177"></a><span 
class="lineno">  177</span>&#160;      <a class="code" 
href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 class="keyword">this</span>);</div><div class="line"><a 
name="l00178"></a><span class="lineno">  178</span>&#160;    } <span 
class="keywordflow">else</span> {</div><div class="line"><a 
name="l00179"></a><span class="lineno">  179</span>&#160;      <a class="code" 
href="libprocess_2include_2process_2check_8hpp.html#a55bf53e1f554470600774a6bf0c09140">CHECK_READY</a>(future);</div><div
 class="line"><a name="l00180"></a><span class="lineno">  180</span>&#160;      
ready += 1;</div><div class="line"><a name="l00181"></a><span class="lineno">  
181</span>&#160;      <span class="keywordflow">if</span> (ready == 
futures.size()) {<
 /div><div class="line"><a name="l00182"></a><span class="lineno">  
182</span>&#160;        std::list&lt;T&gt; values;</div><div class="line"><a 
name="l00183"></a><span class="lineno">  183</span>&#160;        <span 
class="keywordflow">foreach</span> (<span class="keyword">const</span> <a 
class="code" href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&amp; 
future, futures) {</div><div class="line"><a name="l00184"></a><span 
class="lineno">  184</span>&#160;          values.push_back(future.<a 
class="code" 
href="classprocess_1_1Future.html#aa78977d3b585a5f5ccd682c1e9e2ddc4">get</a>());</div><div
 class="line"><a name="l00185"></a><span class="lineno">  185</span>&#160;      
  }</div><div class="line"><a name="l00186"></a><span class="lineno">  
186</span>&#160;        promise-&gt;<a class="code" 
href="classprocess_1_1Promise.html#a989b8dfa7eb2633de3f0f25ac2b87943">set</a>(values);</div><div
 class="line"><a name="l00187"></a><span class="lineno">  187</span>&#160;      
  <a class="co
 de" 
href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 class="keyword">this</span>);</div><div class="line"><a 
name="l00188"></a><span class="lineno">  188</span>&#160;      }</div><div 
class="line"><a name="l00189"></a><span class="lineno">  189</span>&#160;    
}</div><div class="line"><a name="l00190"></a><span class="lineno">  
190</span>&#160;  }</div><div class="line"><a name="l00191"></a><span 
class="lineno">  191</span>&#160;</div><div class="line"><a 
name="l00192"></a><span class="lineno">  192</span>&#160;  <span 
class="keyword">const</span> std::list&lt;Future&lt;T&gt;&gt; 
futures;</div><div class="line"><a name="l00193"></a><span class="lineno">  
193</span>&#160;  <a class="code" 
href="classprocess_1_1Promise.html">Promise&lt;std::list&lt;T&gt;</a>&gt;* 
promise;</div><div class="line"><a name="l00194"></a><span class="lineno">  
194</span>&#160;  <span class="keywordtype">size_t</span> ready;</div><div 
class="line"><a name="l00195"></a><span 
 class="lineno">  195</span>&#160;};</div><div class="line"><a 
name="l00196"></a><span class="lineno">  196</span>&#160;</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="keyword">template</span> 
&lt;<span class="keyword">typename</span> T&gt;</div><div class="line"><a 
name="l00199"></a><span class="lineno"><a class="line" 
href="classprocess_1_1internal_1_1AwaitProcess.html">  
199</a></span>&#160;<span class="keyword">class </span><a class="code" 
href="classprocess_1_1internal_1_1AwaitProcess.html">AwaitProcess</a> : <span 
class="keyword">public</span> <a class="code" 
href="classprocess_1_1Process.html">Process</a>&lt;AwaitProcess&lt;T&gt;&gt;</div><div
 class="line"><a name="l00200"></a><span class="lineno">  
200</span>&#160;{</div><div class="line"><a name="l00201"></a><span 
class="lineno">  201</span>&#160;<span class="keyword">public</span>:</div><div 
c
 lass="line"><a name="l00202"></a><span class="lineno"><a class="line" 
href="classprocess_1_1internal_1_1AwaitProcess.html#a3c7eb50fa22cee33c4a23485d08866d8">
  202</a></span>&#160;  <a class="code" 
href="classprocess_1_1internal_1_1AwaitProcess.html#a3c7eb50fa22cee33c4a23485d08866d8">AwaitProcess</a>(</div><div
 class="line"><a name="l00203"></a><span class="lineno">  203</span>&#160;      
<span class="keyword">const</span> <a class="code" 
href="namespacecgroups_1_1devices.html#a22494291bc2cb89697dcd2b5f288bdd3">std::list</a>&lt;<a
 class="code" href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&gt;&amp; 
_futures,</div><div class="line"><a name="l00204"></a><span class="lineno">  
204</span>&#160;      <a class="code" 
href="classprocess_1_1Promise.html">Promise</a>&lt;<a class="code" 
href="namespacecgroups_1_1devices.html#a22494291bc2cb89697dcd2b5f288bdd3">std::list</a>&lt;<a
 class="code" href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&gt;&gt;* 
_promise)</div><div class="line
 "><a name="l00205"></a><span class="lineno">  205</span>&#160;    : <a 
class="code" href="classprocess_1_1ProcessBase.html">ProcessBase</a>(ID::<a 
class="code" 
href="namespaceprocess_1_1ID.html#aeb11a48c9def1da169d8455a30d0ee39">generate</a>(<span
 class="stringliteral">&quot;__await__&quot;</span>)),</div><div 
class="line"><a name="l00206"></a><span class="lineno">  206</span>&#160;      
futures(_futures),</div><div class="line"><a name="l00207"></a><span 
class="lineno">  207</span>&#160;      promise(_promise),</div><div 
class="line"><a name="l00208"></a><span class="lineno">  208</span>&#160;      
ready(0) {}</div><div class="line"><a name="l00209"></a><span class="lineno">  
209</span>&#160;</div><div class="line"><a name="l00210"></a><span 
class="lineno"><a class="line" 
href="classprocess_1_1internal_1_1AwaitProcess.html#ae5d9fc849ff751871f9e476491c4ff15">
  210</a></span>&#160;  <span class="keyword">virtual</span> <a class="code" 
href="classprocess_1_1internal_1_1AwaitProcess.ht
 ml#ae5d9fc849ff751871f9e476491c4ff15">~AwaitProcess</a>()</div><div 
class="line"><a name="l00211"></a><span class="lineno">  211</span>&#160;  
{</div><div class="line"><a name="l00212"></a><span class="lineno">  
212</span>&#160;    <span class="keyword">delete</span> promise;</div><div 
class="line"><a name="l00213"></a><span class="lineno">  213</span>&#160;  
}</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"><a class="line" 
href="classprocess_1_1internal_1_1AwaitProcess.html#a8121fadd91f2221a673d4e711f22c948">
  215</a></span>&#160;  <span class="keyword">virtual</span> <span 
class="keywordtype">void</span> <a class="code" 
href="classprocess_1_1internal_1_1AwaitProcess.html#a8121fadd91f2221a673d4e711f22c948">initialize</a>()</div><div
 class="line"><a name="l00216"></a><span class="lineno">  216</span>&#160;  
{</div><div class="line"><a name="l00217"></a><span class="lineno">  217</spa
 n>&#160;    <span class="comment">// Stop this nonsense if nobody 
cares.</span></div><div class="line"><a name="l00218"></a><span class="lineno"> 
 218</span>&#160;    promise-&gt;future().onDiscard(<a class="code" 
href="namespaceprocess.html#a8b27a2ef76eb133bf0ce7a5eea4fb77c">defer</a>(<span 
class="keyword">this</span>, &amp;AwaitProcess::discarded));</div><div 
class="line"><a name="l00219"></a><span class="lineno">  
219</span>&#160;</div><div class="line"><a name="l00220"></a><span 
class="lineno">  220</span>&#160;    <span class="keywordflow">foreach</span> 
(<span class="keyword">const</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&amp; future, futures) 
{</div><div class="line"><a name="l00221"></a><span class="lineno">  
221</span>&#160;      future.<a class="code" 
href="classprocess_1_1Future.html#a71bde220aed3c725cef2040f63adf42a">onAny</a>(<a
 class="code" 
href="namespaceprocess.html#a8b27a2ef76eb133bf0ce7a5eea4fb77c">defer</a>(<span 
class="keyword
 ">this</span>, &amp;AwaitProcess::waited, lambda::_1));</div><div 
class="line"><a name="l00222"></a><span class="lineno">  222</span>&#160;      
future.<a class="code" 
href="classprocess_1_1Future.html#a3ef51b1f7e70860758e47c39ed7660f1">onAbandoned</a>(<a
 class="code" 
href="namespaceprocess.html#a8b27a2ef76eb133bf0ce7a5eea4fb77c">defer</a>(<span 
class="keyword">this</span>, &amp;AwaitProcess::abandoned));</div><div 
class="line"><a name="l00223"></a><span class="lineno">  223</span>&#160;    
}</div><div class="line"><a name="l00224"></a><span class="lineno">  
224</span>&#160;  }</div><div class="line"><a name="l00225"></a><span 
class="lineno">  225</span>&#160;</div><div class="line"><a 
name="l00226"></a><span class="lineno">  226</span>&#160;<span 
class="keyword">private</span>:</div><div class="line"><a 
name="l00227"></a><span class="lineno">  227</span>&#160;  <span 
class="keywordtype">void</span> abandoned()</div><div class="line"><a 
name="l00228"></a><span class="lineno">  228</
 span>&#160;  {</div><div class="line"><a name="l00229"></a><span 
class="lineno">  229</span>&#160;    <span class="comment">// There is no use 
waiting because this future will never complete</span></div><div 
class="line"><a name="l00230"></a><span class="lineno">  230</span>&#160;    
<span class="comment">// so terminate this process which will cause `promise` 
to get</span></div><div class="line"><a name="l00231"></a><span class="lineno"> 
 231</span>&#160;    <span class="comment">// deleted and our future to also be 
abandoned.</span></div><div class="line"><a name="l00232"></a><span 
class="lineno">  232</span>&#160;    <a class="code" 
href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 class="keyword">this</span>);</div><div class="line"><a 
name="l00233"></a><span class="lineno">  233</span>&#160;  }</div><div 
class="line"><a name="l00234"></a><span class="lineno">  
234</span>&#160;</div><div class="line"><a name="l00235"></a><span 
class="lineno">  23
 5</span>&#160;  <span class="keywordtype">void</span> <a class="code" 
href="namespaceprocess_1_1internal.html#aa03406abec646ff3df058f9e55749c11">discarded</a>()</div><div
 class="line"><a name="l00236"></a><span class="lineno">  236</span>&#160;  
{</div><div class="line"><a name="l00237"></a><span class="lineno">  
237</span>&#160;    <span class="keywordflow">foreach</span> (<a class="code" 
href="classprocess_1_1Future.html">Future&lt;T&gt;</a> future, futures) 
{</div><div class="line"><a name="l00238"></a><span class="lineno">  
238</span>&#160;      future.<a class="code" 
href="classprocess_1_1Future.html#a4012f3faa6191fc13874dca62c14ced0">discard</a>();</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">  
240</span>&#160;</div><div class="line"><a name="l00241"></a><span 
class="lineno">  241</span>&#160;    <span class="comment">// NOTE: we discard 
the promise after we set discard
  on each of</span></div><div class="line"><a name="l00242"></a><span 
class="lineno">  242</span>&#160;    <span class="comment">// the futures so 
that there is a happens-before relationship that</span></div><div 
class="line"><a name="l00243"></a><span class="lineno">  243</span>&#160;    
<span class="comment">// can be assumed by callers.</span></div><div 
class="line"><a name="l00244"></a><span class="lineno">  244</span>&#160;    
promise-&gt;discard();</div><div class="line"><a name="l00245"></a><span 
class="lineno">  245</span>&#160;</div><div class="line"><a 
name="l00246"></a><span class="lineno">  246</span>&#160;    <a class="code" 
href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 class="keyword">this</span>);</div><div class="line"><a 
name="l00247"></a><span class="lineno">  247</span>&#160;  }</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">  2
 49</span>&#160;  <span class="keywordtype">void</span> waited(<span 
class="keyword">const</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&amp; future)</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;    CHECK(!future.<a class="code" 
href="classprocess_1_1Future.html#af23884cf963eb5ec061595eb2e288903">isPending</a>());</div><div
 class="line"><a name="l00252"></a><span class="lineno">  
252</span>&#160;</div><div class="line"><a name="l00253"></a><span 
class="lineno">  253</span>&#160;    ready += 1;</div><div class="line"><a 
name="l00254"></a><span class="lineno">  254</span>&#160;    <span 
class="keywordflow">if</span> (ready == futures.size()) {</div><div 
class="line"><a name="l00255"></a><span class="lineno">  255</span>&#160;      
promise-&gt;set(futures);</div><div class="line"><a name="l00256"></a><span 
class="lineno">  256</span
 >&#160;      <a class="code" 
 >href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 > class="keyword">this</span>);</div><div class="line"><a 
 >name="l00257"></a><span class="lineno">  257</span>&#160;    }</div><div 
 >class="line"><a name="l00258"></a><span class="lineno">  258</span>&#160;  
 >}</div><div class="line"><a name="l00259"></a><span class="lineno">  
 >259</span>&#160;</div><div class="line"><a name="l00260"></a><span 
 >class="lineno">  260</span>&#160;  <span class="keyword">const</span> 
 >std::list&lt;Future&lt;T&gt;&gt; futures;</div><div class="line"><a 
 >name="l00261"></a><span class="lineno">  261</span>&#160;  <a class="code" 
 >href="classprocess_1_1Promise.html">Promise&lt;std::list&lt;Future&lt;T&gt;</a>&gt;&gt;*
 > promise;</div><div class="line"><a name="l00262"></a><span class="lineno">  
 >262</span>&#160;  <span class="keywordtype">size_t</span> ready;</div><div 
 >class="line"><a name="l00263"></a><span class="lineno">  
 >263</span>&#160;};</div><div class=
 "line"><a name="l00264"></a><span class="lineno">  264</span>&#160;</div><div 
class="line"><a name="l00265"></a><span class="lineno">  
265</span>&#160;</div><div class="line"><a name="l00266"></a><span 
class="lineno">  266</span>&#160;} <span class="comment">// namespace internal 
{</span></div><div class="line"><a name="l00267"></a><span class="lineno">  
267</span>&#160;</div><div class="line"><a name="l00268"></a><span 
class="lineno">  268</span>&#160;</div><div class="line"><a 
name="l00269"></a><span class="lineno">  269</span>&#160;<span 
class="keyword">template</span> &lt;<span class="keyword">typename</span> 
T&gt;</div><div class="line"><a name="l00270"></a><span class="lineno"><a 
class="line" href="namespaceprocess.html#a0f89a937c1caa20e3048e16aeb0c9736">  
270</a></span>&#160;<span class="keyword">inline</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;std::list&lt;T&gt;</a>&gt; <a 
class="code" href="namespaceprocess.html#a0f89a937c1caa20e3048e16aeb0c9736">c
 ollect</a>(</div><div class="line"><a name="l00271"></a><span class="lineno">  
271</span>&#160;    <span class="keyword">const</span> <a class="code" 
href="namespacecgroups_1_1devices.html#a22494291bc2cb89697dcd2b5f288bdd3">std::list</a>&lt;<a
 class="code" href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&gt;&amp; 
futures)</div><div class="line"><a name="l00272"></a><span class="lineno">  
272</span>&#160;{</div><div class="line"><a name="l00273"></a><span 
class="lineno">  273</span>&#160;  <span class="keywordflow">if</span> 
(futures.empty()) {</div><div class="line"><a name="l00274"></a><span 
class="lineno">  274</span>&#160;    <span class="keywordflow">return</span> 
std::list&lt;T&gt;();</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="classprocess_1
 _1Promise.html">Promise&lt;std::list&lt;T&gt;</a>&gt;* promise = <span 
class="keyword">new</span> <a class="code" 
href="classprocess_1_1Promise.html">Promise&lt;std::list&lt;T&gt;</a>&gt;();</div><div
 class="line"><a name="l00278"></a><span class="lineno">  278</span>&#160;  <a 
class="code" 
href="classprocess_1_1Future.html">Future&lt;std::list&lt;T&gt;</a>&gt; future 
= promise-&gt;future();</div><div class="line"><a name="l00279"></a><span 
class="lineno">  279</span>&#160;  <a class="code" 
href="namespaceprocess.html#aff22904a83567125d3b4d0d88e5a2270">spawn</a>(<span 
class="keyword">new</span> <a class="code" 
href="classprocess_1_1internal_1_1CollectProcess.html">internal::CollectProcess&lt;T&gt;</a>(futures,
 promise), <span class="keyword">true</span>);</div><div class="line"><a 
name="l00280"></a><span class="lineno">  280</span>&#160;  <span 
class="keywordflow">return</span> future;</div><div class="line"><a 
name="l00281"></a><span class="lineno">  281</span>&#160;}</div><div cla
 ss="line"><a name="l00282"></a><span class="lineno">  
282</span>&#160;</div><div class="line"><a name="l00283"></a><span 
class="lineno">  283</span>&#160;</div><div class="line"><a 
name="l00284"></a><span class="lineno">  284</span>&#160;<span 
class="keyword">template</span> &lt;<span class="keyword">typename</span>... 
Ts&gt;</div><div class="line"><a name="l00285"></a><span class="lineno"><a 
class="line" href="namespaceprocess.html#a6f599ec39a0b29f140d3556dda0940f7">  
285</a></span>&#160;<a class="code" 
href="classprocess_1_1Future.html">Future</a>&lt;std::tuple&lt;Ts...&gt;&gt; <a 
class="code" 
href="namespaceprocess.html#a0f89a937c1caa20e3048e16aeb0c9736">collect</a>(<span
 class="keyword">const</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;Ts&gt;</a>&amp;... 
futures)</div><div class="line"><a name="l00286"></a><span class="lineno">  
286</span>&#160;{</div><div class="line"><a name="l00287"></a><span 
class="lineno">  287</span>&#160;  std::list&lt;Future&lt;No
 thing&gt;&gt; wrappers = {</div><div class="line"><a name="l00288"></a><span 
class="lineno">  288</span>&#160;    futures.<a class="code" 
href="classprocess_1_1Future.html#a269dcc23e03e8868067c24fe70b65a41">then</a>([]()
 { <span class="keywordflow">return</span> <a class="code" 
href="structNothing.html">Nothing</a>(); })...</div><div class="line"><a 
name="l00289"></a><span class="lineno">  289</span>&#160;  };</div><div 
class="line"><a name="l00290"></a><span class="lineno">  
290</span>&#160;</div><div class="line"><a name="l00291"></a><span 
class="lineno">  291</span>&#160;  <span class="comment">// TODO(klueska): 
Unfortunately, we have to use a lambda followed</span></div><div 
class="line"><a name="l00292"></a><span class="lineno">  292</span>&#160;  
<span class="comment">// by a bind here because of a bug in gcc 4.8 to handle 
variadic</span></div><div class="line"><a name="l00293"></a><span 
class="lineno">  293</span>&#160;  <span class="comment">// parameters in 
lambdas:</span><
 /div><div class="line"><a name="l00294"></a><span class="lineno">  
294</span>&#160;  <span class="comment">//     
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=47226</span></div><div 
class="line"><a name="l00295"></a><span class="lineno">  295</span>&#160;  
<span class="keyword">auto</span> <a class="code" 
href="namespaceprocess.html#a62d5333e8ec1817c249cf83e15d568b4">f</a> = [](<span 
class="keyword">const</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;Ts&gt;</a>&amp;... futures) 
{</div><div class="line"><a name="l00296"></a><span class="lineno">  
296</span>&#160;    <span class="keywordflow">return</span> 
std::make_tuple(futures.<a class="code" 
href="classprocess_1_1Future.html#aa78977d3b585a5f5ccd682c1e9e2ddc4">get</a>()...);</div><div
 class="line"><a name="l00297"></a><span class="lineno">  297</span>&#160;  
};</div><div class="line"><a name="l00298"></a><span class="lineno">  
298</span>&#160;</div><div class="line"><a name="l00299"></a><span 
class="lineno">  
 299</span>&#160;  <span class="keywordflow">return</span> <a class="code" 
href="namespaceprocess.html#a0f89a937c1caa20e3048e16aeb0c9736">collect</a>(wrappers)</div><div
 class="line"><a name="l00300"></a><span class="lineno">  300</span>&#160;    
.<a class="code" 
href="classprocess_1_1Future.html#a269dcc23e03e8868067c24fe70b65a41">then</a>(<a
 class="code" 
href="namespaceprocess_1_1network.html#ad067110a4b38cc83785a43f49bf6c8e2">std::bind</a>(<a
 class="code" 
href="namespaceprocess.html#a62d5333e8ec1817c249cf83e15d568b4">f</a>, 
futures...));</div><div class="line"><a name="l00301"></a><span class="lineno"> 
 301</span>&#160;}</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;<span 
class="keyword">template</span> &lt;<span class="keyword">typename</span> 
T&gt;</div><div class="line"><a name
 ="l00305"></a><span class="lineno"><a class="line" 
href="namespaceprocess.html#a9244f063b856adbc7182f8620b01034c">  
305</a></span>&#160;<span class="keyword">inline</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;std::list&lt;Future&lt;T&gt;</a>&gt;&gt;
 <a class="code" 
href="namespaceprocess_1_1internal.html#a45915c2c6b7aea85b1c9a726158f19fc">await</a>(</div><div
 class="line"><a name="l00306"></a><span class="lineno">  306</span>&#160;    
<span class="keyword">const</span> <a class="code" 
href="namespacecgroups_1_1devices.html#a22494291bc2cb89697dcd2b5f288bdd3">std::list</a>&lt;<a
 class="code" href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&gt;&amp; 
futures)</div><div class="line"><a name="l00307"></a><span class="lineno">  
307</span>&#160;{</div><div class="line"><a name="l00308"></a><span 
class="lineno">  308</span>&#160;  <span class="keywordflow">if</span> 
(futures.empty()) {</div><div class="line"><a name="l00309"></a><span 
class="lineno">  309</span>
 &#160;    <span class="keywordflow">return</span> futures;</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;</div><div class="line"><a name="l00312"></a><span 
class="lineno">  312</span>&#160;  <a class="code" 
href="classprocess_1_1Promise.html">Promise&lt;std::list&lt;Future&lt;T&gt;</a>&gt;&gt;*
 promise =</div><div class="line"><a name="l00313"></a><span class="lineno">  
313</span>&#160;    <span class="keyword">new</span> <a class="code" 
href="classprocess_1_1Promise.html">Promise&lt;std::list&lt;Future&lt;T&gt;</a>&gt;&gt;();</div><div
 class="line"><a name="l00314"></a><span class="lineno">  314</span>&#160;  <a 
class="code" 
href="classprocess_1_1Future.html">Future&lt;std::list&lt;Future&lt;T&gt;</a>&gt;&gt;
 future = promise-&gt;<a class="code" 
href="classprocess_1_1Promise.html#a8aef752d6c90cb11e58e3166b7592ef1">future</a>();</div><div
 class="line"><a name="
 l00315"></a><span class="lineno">  315</span>&#160;  <a class="code" 
href="namespaceprocess.html#aff22904a83567125d3b4d0d88e5a2270">spawn</a>(<span 
class="keyword">new</span> <a class="code" 
href="classprocess_1_1internal_1_1AwaitProcess.html">internal::AwaitProcess&lt;T&gt;</a>(futures,
 promise), <span class="keyword">true</span>);</div><div class="line"><a 
name="l00316"></a><span class="lineno">  316</span>&#160;  <span 
class="keywordflow">return</span> future;</div><div class="line"><a 
name="l00317"></a><span class="lineno">  317</span>&#160;}</div><div 
class="line"><a name="l00318"></a><span class="lineno">  
318</span>&#160;</div><div class="line"><a name="l00319"></a><span 
class="lineno">  319</span>&#160;</div><div class="line"><a 
name="l00320"></a><span class="lineno">  320</span>&#160;<span 
class="keyword">template</span> &lt;<span class="keyword">typename</span>... 
Ts&gt;</div><div class="line"><a name="l00321"></a><span class="lineno"><a 
class="line" href="namespaceprocess
 .html#a798bdf13d396404bbf4cd7bb9d25c62c">  321</a></span>&#160;<a class="code" 
href="classprocess_1_1Future.html">Future&lt;std::tuple&lt;Future&lt;Ts&gt;</a>...&gt;&gt;
 <a class="code" 
href="namespaceprocess_1_1internal.html#a45915c2c6b7aea85b1c9a726158f19fc">await</a>(<span
 class="keyword">const</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;Ts&gt;</a>&amp;... 
futures)</div><div class="line"><a name="l00322"></a><span class="lineno">  
322</span>&#160;{</div><div class="line"><a name="l00323"></a><span 
class="lineno">  323</span>&#160;  std::list&lt;Future&lt;Nothing&gt;&gt; 
wrappers = {</div><div class="line"><a name="l00324"></a><span class="lineno">  
324</span>&#160;    futures.<a class="code" 
href="classprocess_1_1Future.html#a269dcc23e03e8868067c24fe70b65a41">then</a>([]()
 { <span class="keywordflow">return</span> <a class="code" 
href="structNothing.html">Nothing</a>(); })...</div><div class="line"><a 
name="l00325"></a><span class="lineno">  325</span>&#16
 0;  };</div><div class="line"><a name="l00326"></a><span class="lineno">  
326</span>&#160;</div><div class="line"><a name="l00327"></a><span 
class="lineno">  327</span>&#160;  <span class="comment">// TODO(klueska): 
Unfortunately, we have to use a lambda followed</span></div><div 
class="line"><a name="l00328"></a><span class="lineno">  328</span>&#160;  
<span class="comment">// by a bind here because of a bug in gcc 4.8 to handle 
variadic</span></div><div class="line"><a name="l00329"></a><span 
class="lineno">  329</span>&#160;  <span class="comment">// parameters in 
lambdas:</span></div><div class="line"><a name="l00330"></a><span 
class="lineno">  330</span>&#160;  <span class="comment">//     
https://gcc.gnu.org/bugzilla/show_bug.cgi?id=47226</span></div><div 
class="line"><a name="l00331"></a><span class="lineno">  331</span>&#160;  
<span class="keyword">auto</span> <a class="code" 
href="namespaceprocess.html#a62d5333e8ec1817c249cf83e15d568b4">f</a> = [](<span 
class="keyword">cons
 t</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;Ts&gt;</a>&amp;... futures) 
{</div><div class="line"><a name="l00332"></a><span class="lineno">  
332</span>&#160;    <span class="keywordflow">return</span> 
std::make_tuple(futures...);</div><div class="line"><a name="l00333"></a><span 
class="lineno">  333</span>&#160;  };</div><div class="line"><a 
name="l00334"></a><span class="lineno">  334</span>&#160;</div><div 
class="line"><a name="l00335"></a><span class="lineno">  335</span>&#160;  
<span class="keywordflow">return</span> <a class="code" 
href="namespaceprocess_1_1internal.html#a45915c2c6b7aea85b1c9a726158f19fc">await</a>(wrappers)</div><div
 class="line"><a name="l00336"></a><span class="lineno">  336</span>&#160;    
.then(<a class="code" 
href="namespaceprocess_1_1network.html#ad067110a4b38cc83785a43f49bf6c8e2">std::bind</a>(<a
 class="code" 
href="namespaceprocess.html#a62d5333e8ec1817c249cf83e15d568b4">f</a>, 
futures...));</div><div class="line"><a name="l003
 37"></a><span class="lineno">  337</span>&#160;}</div><div class="line"><a 
name="l00338"></a><span class="lineno">  338</span>&#160;</div><div 
class="line"><a name="l00339"></a><span class="lineno">  339</span>&#160;} 
<span class="comment">// namespace process {</span></div><div class="line"><a 
name="l00340"></a><span class="lineno">  340</span>&#160;</div><div 
class="line"><a name="l00341"></a><span class="lineno">  341</span>&#160;<span 
class="preprocessor">#endif // __PROCESS_COLLECT_HPP__</span></div><div 
class="ttc" 
id="namespaceprocess_1_1ID_html_aeb11a48c9def1da169d8455a30d0ee39"><div 
class="ttname"><a 
href="namespaceprocess_1_1ID.html#aeb11a48c9def1da169d8455a30d0ee39">process::ID::generate</a></div><div
 class="ttdeci">std::string generate(const std::string 
&amp;prefix=&quot;&quot;)</div><div class="ttdoc">Returns 
&amp;#39;prefix(N)&amp;#39; where N represents the number of instances where 
the same prefix (wrt...</div></div>
+<a href="collect_8hpp.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">// Licensed under the Apache License, 
Version 2.0 (the &quot;License&quot;);</span></div><div class="line"><a 
name="l00002"></a><span class="lineno">    2</span>&#160;<span 
class="comment">// you may not use this file except in compliance with the 
License.</span></div><div class="line"><a name="l00003"></a><span 
class="lineno">    3</span>&#160;<span class="comment">// You may obtain a copy 
of the License at</span></div><div class="line"><a name="l00004"></a><span 
class="lineno">    4</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00005"></a><span class="lineno">    5</span>&#160;<span 
class="comment">//     
http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a 
name="l00006"></a><span class="lineno">    6</span>&#160;<span 
class="comment">//</s
 pan></div><div class="line"><a name="l00007"></a><span class="lineno">    
7</span>&#160;<span class="comment">// Unless required by applicable law or 
agreed to in writing, software</span></div><div class="line"><a 
name="l00008"></a><span class="lineno">    8</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="l00009"></a><span 
class="lineno">    9</span>&#160;<span class="comment">// WITHOUT WARRANTIES OR 
CONDITIONS OF ANY KIND, either express or implied.</span></div><div 
class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span 
class="comment">// See the License for the specific language governing 
permissions and</span></div><div class="line"><a name="l00011"></a><span 
class="lineno">   11</span>&#160;<span class="comment">// limitations under the 
License</span></div><div class="line"><a name="l00012"></a><span 
class="lineno">   12</span>&#160;</div><div class="l
 ine"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span 
class="preprocessor">#ifndef __PROCESS_COLLECT_HPP__</span></div><div 
class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span 
class="preprocessor">#define __PROCESS_COLLECT_HPP__</span></div><div 
class="line"><a name="l00015"></a><span class="lineno">   
15</span>&#160;</div><div class="line"><a name="l00016"></a><span 
class="lineno">   16</span>&#160;<span class="preprocessor">#include 
&lt;functional&gt;</span></div><div class="line"><a name="l00017"></a><span 
class="lineno">   17</span>&#160;<span class="preprocessor">#include 
&lt;list&gt;</span></div><div class="line"><a name="l00018"></a><span 
class="lineno">   18</span>&#160;<span class="preprocessor">#include 
&lt;tuple&gt;</span></div><div class="line"><a name="l00019"></a><span 
class="lineno">   19</span>&#160;</div><div class="line"><a 
name="l00020"></a><span class="lineno">   20</span>&#160;<span 
class="preprocessor">#include &lt;<a
  class="code" 
href="libprocess_2include_2process_2check_8hpp.html">process/check.hpp</a>&gt;</span></div><div
 class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="defer_8hpp.html">process/defer.hpp</a>&gt;</span></div><div 
class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="future_8hpp.html">process/future.hpp</a>&gt;</span></div><div 
class="line"><a name="l00023"></a><span class="lineno">   23</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="id_8hpp.html">process/id.hpp</a>&gt;</span></div><div class="line"><a 
name="l00024"></a><span class="lineno">   24</span>&#160;<span 
class="preprocessor">#include &lt;<a class="code" 
href="owned_8hpp.html">process/owned.hpp</a>&gt;</span></div><div 
class="line"><a name="l00025"></a><span class="lineno">   25</span>&#160;<span 
class="preprocessor">#include &l
 t;<a class="code" 
href="libprocess_2include_2process_2process_8hpp.html">process/process.hpp</a>&gt;</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="preprocessor">#include &lt;<a 
class="code" href="lambda_8hpp.html">stout/lambda.hpp</a>&gt;</span></div><div 
class="line"><a name="l00028"></a><span class="lineno">   
28</span>&#160;</div><div class="line"><a name="l00029"></a><span 
class="lineno">   29</span>&#160;<span class="comment">// TODO(bmahler): Move 
these into a futures.hpp header to group Future</span></div><div 
class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;<span 
class="comment">// related utilities.</span></div><div class="line"><a 
name="l00031"></a><span class="lineno">   31</span>&#160;</div><div 
class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;<span 
class="keyword">namespace </span><a 
 class="code" href="namespaceprocess.html">process</a> {</div><div 
class="line"><a name="l00033"></a><span class="lineno">   
33</span>&#160;</div><div class="line"><a name="l00034"></a><span 
class="lineno">   34</span>&#160;<span class="comment">// Waits on each future 
in the specified list and returns the list of</span></div><div class="line"><a 
name="l00035"></a><span class="lineno">   35</span>&#160;<span 
class="comment">// resulting values in the same order. If any future is 
discarded then</span></div><div class="line"><a name="l00036"></a><span 
class="lineno">   36</span>&#160;<span class="comment">// the result will be a 
failure. Likewise, if any future fails then</span></div><div class="line"><a 
name="l00037"></a><span class="lineno">   37</span>&#160;<span 
class="comment">// the result future will be a failure.</span></div><div 
class="line"><a name="l00038"></a><span class="lineno">   38</span>&#160;<span 
class="keyword">template</span> &lt;<span class="keyword">typename</spa
 n> T&gt;</div><div class="line"><a name="l00039"></a><span class="lineno">   
39</span>&#160;Future&lt;std::list&lt;T&gt;&gt; <a class="code" 
href="namespaceprocess.html#a0f89a937c1caa20e3048e16aeb0c9736">collect</a>(<span
 class="keyword">const</span> <a class="code" 
href="namespacecgroups_1_1devices.html#a22494291bc2cb89697dcd2b5f288bdd3">std::list</a>&lt;Future&lt;T&gt;&gt;&amp;
 futures);</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;</div><div class="line"><a 
name="l00042"></a><span class="lineno">   42</span>&#160;<span 
class="comment">// Waits on each future specified and returns the wrapping 
future</span></div><div class="line"><a name="l00043"></a><span class="lineno"> 
  43</span>&#160;<span class="comment">// typed of a tuple of 
values.</span></div><div class="line"><a name="l00044"></a><span 
class="lineno">   44</span>&#160;<span class="keyword">template</
 span> &lt;<span class="keyword">typename</span>... Ts&gt;</div><div 
class="line"><a name="l00045"></a><span class="lineno">   
45</span>&#160;Future&lt;std::tuple&lt;Ts...&gt;&gt; <a class="code" 
href="namespaceprocess.html#a0f89a937c1caa20e3048e16aeb0c9736">collect</a>(<span
 class="keyword">const</span> Future&lt;Ts&gt;&amp;... futures);</div><div 
class="line"><a name="l00046"></a><span class="lineno">   
46</span>&#160;</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="comment">// Waits on each future in the specified set and returns the 
list of</span></div><div class="line"><a name="l00049"></a><span 
class="lineno">   49</span>&#160;<span class="comment">// non-pending 
futures.</span></div><div class="line"><a name="l00050"></a><span 
class="lineno">   50</span>&#160;<span class="keyword">template</span> 
&lt;<span class="keyword">typename</span> T&gt;</di
 v><div class="line"><a name="l00051"></a><span class="lineno">   
51</span>&#160;Future&lt;std::list&lt;Future&lt;T&gt;&gt;&gt; <a class="code" 
href="namespaceprocess.html#a9244f063b856adbc7182f8620b01034c">await</a>(<span 
class="keyword">const</span> <a class="code" 
href="namespacecgroups_1_1devices.html#a22494291bc2cb89697dcd2b5f288bdd3">std::list</a>&lt;Future&lt;T&gt;&gt;&amp;
 futures);</div><div class="line"><a name="l00052"></a><span class="lineno">   
52</span>&#160;</div><div class="line"><a name="l00053"></a><span 
class="lineno">   53</span>&#160;</div><div class="line"><a 
name="l00054"></a><span class="lineno">   54</span>&#160;<span 
class="comment">// Waits on each future specified and returns the wrapping 
future</span></div><div class="line"><a name="l00055"></a><span class="lineno"> 
  55</span>&#160;<span class="comment">// typed of a tuple of 
futures.</span></div><div class="line"><a name="l00056"></a><span 
class="lineno">   56</span>&#160;<span class="keyword">template<
 /span> &lt;<span class="keyword">typename</span>... Ts&gt;</div><div 
class="line"><a name="l00057"></a><span class="lineno">   
57</span>&#160;Future&lt;std::tuple&lt;Future&lt;Ts&gt;...&gt;&gt; <a 
class="code" 
href="namespaceprocess.html#a9244f063b856adbc7182f8620b01034c">await</a>(<span 
class="keyword">const</span> Future&lt;Ts&gt;&amp;... futures);</div><div 
class="line"><a name="l00058"></a><span class="lineno">   
58</span>&#160;</div><div class="line"><a name="l00059"></a><span 
class="lineno">   59</span>&#160;</div><div class="line"><a 
name="l00060"></a><span class="lineno">   60</span>&#160;<span 
class="comment">// Waits on the future specified and returns after the future 
has been</span></div><div class="line"><a name="l00061"></a><span 
class="lineno">   61</span>&#160;<span class="comment">// completed or the 
await has been discarded. This is useful when</span></div><div class="line"><a 
name="l00062"></a><span class="lineno">   62</span>&#160;<span 
class="comment">// wanting
  to &quot;break out&quot; of a future chain if a discard occurs 
but</span></div><div class="line"><a name="l00063"></a><span class="lineno">   
63</span>&#160;<span class="comment">// the underlying future has not been 
discarded. For example:</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">//   
Future&lt;string&gt; foo()</span></div><div class="line"><a 
name="l00066"></a><span class="lineno">   66</span>&#160;<span 
class="comment">//   {</span></div><div class="line"><a name="l00067"></a><span 
class="lineno">   67</span>&#160;<span class="comment">//     return 
bar()</span></div><div class="line"><a name="l00068"></a><span class="lineno">  
 68</span>&#160;<span class="comment">//       .then([](int i) 
{</span></div><div class="line"><a name="l00069"></a><span class="lineno">   
69</span>&#160;<span class="com
 ment">//         return stringify(i);</span></div><div class="line"><a 
name="l00070"></a><span class="lineno">   70</span>&#160;<span 
class="comment">//       });</span></div><div class="line"><a 
name="l00071"></a><span class="lineno">   71</span>&#160;<span 
class="comment">//   }</span></div><div class="line"><a name="l00072"></a><span 
class="lineno">   72</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;<span 
class="comment">//   Future&lt;stringify&gt; future = foo();</span></div><div 
class="line"><a name="l00074"></a><span class="lineno">   74</span>&#160;<span 
class="comment">//   future.discard();</span></div><div class="line"><a 
name="l00075"></a><span class="lineno">   75</span>&#160;<span 
class="comment">//</span></div><div class="line"><a name="l00076"></a><span 
class="lineno">   76</span>&#160;<span class="comment">// In the above code 
we&#39;ll propagate the discard to `bar()` but might</span><
 /div><div class="line"><a name="l00077"></a><span class="lineno">   
77</span>&#160;<span class="comment">// wait forever if `bar()` can&#39;t 
discard their computation. In some</span></div><div class="line"><a 
name="l00078"></a><span class="lineno">   78</span>&#160;<span 
class="comment">// circumstances you might want to break out early and you can 
do that</span></div><div class="line"><a name="l00079"></a><span 
class="lineno">   79</span>&#160;<span class="comment">// by using `await`, 
because if we discard an `await` that function</span></div><div class="line"><a 
name="l00080"></a><span class="lineno">   80</span>&#160;<span 
class="comment">// will return even though all of the future&#39;s it is 
waiting on have</span></div><div class="line"><a name="l00081"></a><span 
class="lineno">   81</span>&#160;<span class="comment">// not been discarded 
(in other words, the `await` can be properly</span></div><div class="line"><a 
name="l00082"></a><span class="lineno">   82</span>&#160;<sp
 an class="comment">// discarded even if the underlying futures have not been 
discarded).</span></div><div class="line"><a name="l00083"></a><span 
class="lineno">   83</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;<span 
class="comment">//   Future&lt;string&gt; foo()</span></div><div 
class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;<span 
class="comment">//   {</span></div><div class="line"><a name="l00086"></a><span 
class="lineno">   86</span>&#160;<span class="comment">//     return 
await(bar())</span></div><div class="line"><a name="l00087"></a><span 
class="lineno">   87</span>&#160;<span class="comment">//       
.recover([](const Future&lt;Future&lt;string&gt;&gt;&amp; future) 
{</span></div><div class="line"><a name="l00088"></a><span class="lineno">   
88</span>&#160;<span class="comment">//         if (future.isDiscarded()) 
{</span></div><div class="line"><a name="l00089"></a>
 <span class="lineno">   89</span>&#160;<span class="comment">//           
cleanup();</span></div><div class="line"><a name="l00090"></a><span 
class="lineno">   90</span>&#160;<span class="comment">//         
}</span></div><div class="line"><a name="l00091"></a><span class="lineno">   
91</span>&#160;<span class="comment">//         return Failure(&quot;Discarded 
waiting&quot;);</span></div><div class="line"><a name="l00092"></a><span 
class="lineno">   92</span>&#160;<span class="comment">//       
})</span></div><div class="line"><a name="l00093"></a><span class="lineno">   
93</span>&#160;<span class="comment">//       .then([](const 
Future&lt;int&gt;&amp; future) {</span></div><div class="line"><a 
name="l00094"></a><span class="lineno">   94</span>&#160;<span 
class="comment">//         return future</span></div><div class="line"><a 
name="l00095"></a><span class="lineno">   95</span>&#160;<span 
class="comment">//           .then([](int i) {</span></div><div class="line"><a 
name="l0009
 6"></a><span class="lineno">   96</span>&#160;<span class="comment">//         
    return stringify(i);</span></div><div class="line"><a 
name="l00097"></a><span class="lineno">   97</span>&#160;<span 
class="comment">//           });</span></div><div class="line"><a 
name="l00098"></a><span class="lineno">   98</span>&#160;<span 
class="comment">//       });</span></div><div class="line"><a 
name="l00099"></a><span class="lineno">   99</span>&#160;<span 
class="comment">//   }</span></div><div class="line"><a name="l00100"></a><span 
class="lineno">  100</span>&#160;<span class="comment">//</span></div><div 
class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;<span 
class="comment">//   Future&lt;string&gt; future = foo();</span></div><div 
class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;<span 
class="comment">//   future.discard();</span></div><div class="line"><a 
name="l00103"></a><span class="lineno">  103</span>&#160;<span 
class="comment">//</
 span></div><div class="line"><a name="l00104"></a><span class="lineno">  
104</span>&#160;<span class="comment">// Using `await` will enable you to 
continue execution even if `bar()`</span></div><div class="line"><a 
name="l00105"></a><span class="lineno">  105</span>&#160;<span 
class="comment">// does not (or can not) discard their 
execution.</span></div><div class="line"><a name="l00106"></a><span 
class="lineno">  106</span>&#160;<span class="keyword">template</span> 
&lt;<span class="keyword">typename</span> T&gt;</div><div class="line"><a 
name="l00107"></a><span class="lineno"><a class="line" 
href="namespaceprocess.html#a9d64abf575bde6dc82f9d915b33743c8">  
107</a></span>&#160;<a class="code" 
href="classprocess_1_1Future.html">Future&lt;Future&lt;T&gt;</a>&gt; <a 
class="code" 
href="namespaceprocess.html#a9244f063b856adbc7182f8620b01034c">await</a>(<span 
class="keyword">const</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&amp; future)</div><div 
class="l
 ine"><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="keywordflow">return</span> <a class="code" 
href="namespaceprocess.html#a9244f063b856adbc7182f8620b01034c">await</a>(<a 
class="code" 
href="namespacecgroups_1_1devices.html#a22494291bc2cb89697dcd2b5f288bdd3">std::list</a>&lt;<a
 class="code" 
href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&gt;{future})</div><div 
class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;    
.<a class="code" 
href="namespaceprocess_1_1internal.html#a7885011cf6470b707294a6ef4ec7a0a6">then</a>([=]()
 {</div><div class="line"><a name="l00111"></a><span class="lineno">  
111</span>&#160;      <span class="keywordflow">return</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;Future&lt;T&gt;</a>&gt;(future);</div><div
 class="line"><a name="l00112"></a><span class="lineno">  112</span>&#160;    
});</div><div class
 ="line"><a name="l00113"></a><span class="lineno">  
113</span>&#160;}</div><div class="line"><a name="l00114"></a><span 
class="lineno">  114</span>&#160;</div><div class="line"><a 
name="l00115"></a><span class="lineno">  115</span>&#160;</div><div 
class="line"><a name="l00116"></a><span class="lineno"><a class="line" 
href="namespaceprocess_1_1internal.html">  116</a></span>&#160;<span 
class="keyword">namespace </span><a class="code" 
href="namespaceinternal.html">internal</a> {</div><div class="line"><a 
name="l00117"></a><span class="lineno">  117</span>&#160;</div><div 
class="line"><a name="l00118"></a><span class="lineno">  118</span>&#160;<span 
class="keyword">template</span> &lt;<span class="keyword">typename</span> 
T&gt;</div><div class="line"><a name="l00119"></a><span class="lineno"><a 
class="line" href="classprocess_1_1internal_1_1CollectProcess.html">  
119</a></span>&#160;<span class="keyword">class </span><a class="code" 
href="classprocess_1_1internal_1_1CollectProcess.html
 ">CollectProcess</a> : <span class="keyword">public</span> <a class="code" 
href="classprocess_1_1Process.html">Process</a>&lt;CollectProcess&lt;T&gt;&gt;</div><div
 class="line"><a name="l00120"></a><span class="lineno">  
120</span>&#160;{</div><div class="line"><a name="l00121"></a><span 
class="lineno">  121</span>&#160;<span class="keyword">public</span>:</div><div 
class="line"><a name="l00122"></a><span class="lineno"><a class="line" 
href="classprocess_1_1internal_1_1CollectProcess.html#aeae1fffc984af46ddb3b0570408c5ee0">
  122</a></span>&#160;  <a class="code" 
href="classprocess_1_1internal_1_1CollectProcess.html#aeae1fffc984af46ddb3b0570408c5ee0">CollectProcess</a>(</div><div
 class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;      
<span class="keyword">const</span> <a class="code" 
href="namespacecgroups_1_1devices.html#a22494291bc2cb89697dcd2b5f288bdd3">std::list</a>&lt;<a
 class="code" href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&gt;&amp; 
_futures
 ,</div><div class="line"><a name="l00124"></a><span class="lineno">  
124</span>&#160;      <a class="code" 
href="classprocess_1_1Promise.html">Promise</a>&lt;std::list&lt;T&gt;&gt;* 
_promise)</div><div class="line"><a name="l00125"></a><span class="lineno">  
125</span>&#160;    : <a class="code" 
href="classprocess_1_1ProcessBase.html">ProcessBase</a>(ID::<a class="code" 
href="namespaceprocess_1_1ID.html#aeb11a48c9def1da169d8455a30d0ee39">generate</a>(<span
 class="stringliteral">&quot;__collect__&quot;</span>)),</div><div 
class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;      
futures(_futures.begin(), _futures.end()),</div><div class="line"><a 
name="l00127"></a><span class="lineno">  127</span>&#160;      
promise(_promise),</div><div class="line"><a name="l00128"></a><span 
class="lineno">  128</span>&#160;      ready(0) {}</div><div class="line"><a 
name="l00129"></a><span class="lineno">  129</span>&#160;</div><div 
class="line"><a name="l00130"></a><span class
 ="lineno"><a class="line" 
href="classprocess_1_1internal_1_1CollectProcess.html#aef71c5f6f3c016b544805111417573a8">
  130</a></span>&#160;  <span class="keyword">virtual</span> <a class="code" 
href="classprocess_1_1internal_1_1CollectProcess.html#aef71c5f6f3c016b544805111417573a8">~CollectProcess</a>()</div><div
 class="line"><a name="l00131"></a><span class="lineno">  131</span>&#160;  
{</div><div class="line"><a name="l00132"></a><span class="lineno">  
132</span>&#160;    <span class="keyword">delete</span> promise;</div><div 
class="line"><a name="l00133"></a><span class="lineno">  133</span>&#160;  
}</div><div class="line"><a name="l00134"></a><span class="lineno">  
134</span>&#160;</div><div class="line"><a name="l00135"></a><span 
class="lineno">  135</span>&#160;<span 
class="keyword">protected</span>:</div><div class="line"><a 
name="l00136"></a><span class="lineno"><a class="line" 
href="classprocess_1_1internal_1_1CollectProcess.html#a6e13d430bd37e93903d3f0b4201b8e31">
  136</a></
 span>&#160;  <span class="keyword">virtual</span> <span 
class="keywordtype">void</span> <a class="code" 
href="classprocess_1_1internal_1_1CollectProcess.html#a6e13d430bd37e93903d3f0b4201b8e31">initialize</a>()</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">// Stop this nonsense if nobody 
cares.</span></div><div class="line"><a name="l00139"></a><span class="lineno"> 
 139</span>&#160;    promise-&gt;<a class="code" 
href="classprocess_1_1Promise.html#a8aef752d6c90cb11e58e3166b7592ef1">future</a>().<a
 class="code" 
href="classprocess_1_1Future.html#a1b80bf321358be44880d9c6bae5d9a2d">onDiscard</a>(<a
 class="code" 
href="namespaceprocess.html#a8b27a2ef76eb133bf0ce7a5eea4fb77c">defer</a>(<span 
class="keyword">this</span>, &amp;CollectProcess::discarded));</div><div 
class="line"><a name="l00140"></a><span class="lineno">  140</span>&#160;</div><
 div class="line"><a name="l00141"></a><span class="lineno">  141</span>&#160;  
  <span class="keywordflow">foreach</span> (<span class="keyword">const</span> 
<a class="code" href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&amp; 
future, futures) {</div><div class="line"><a name="l00142"></a><span 
class="lineno">  142</span>&#160;      future.<a class="code" 
href="classprocess_1_1Future.html#a71bde220aed3c725cef2040f63adf42a">onAny</a>(<a
 class="code" 
href="namespaceprocess.html#a8b27a2ef76eb133bf0ce7a5eea4fb77c">defer</a>(<span 
class="keyword">this</span>, &amp;CollectProcess::waited, 
lambda::_1));</div><div class="line"><a name="l00143"></a><span class="lineno"> 
 143</span>&#160;      future.<a class="code" 
href="classprocess_1_1Future.html#a3ef51b1f7e70860758e47c39ed7660f1">onAbandoned</a>(<a
 class="code" 
href="namespaceprocess.html#a8b27a2ef76eb133bf0ce7a5eea4fb77c">defer</a>(<span 
class="keyword">this</span>, &amp;CollectProcess::abandoned));</div><div 
class="line"><a name=
 "l00144"></a><span class="lineno">  144</span>&#160;    }</div><div 
class="line"><a name="l00145"></a><span class="lineno">  145</span>&#160;  
}</div><div class="line"><a name="l00146"></a><span class="lineno">  
146</span>&#160;</div><div class="line"><a name="l00147"></a><span 
class="lineno">  147</span>&#160;<span 
class="keyword">private</span>:</div><div class="line"><a 
name="l00148"></a><span class="lineno">  148</span>&#160;  <span 
class="keywordtype">void</span> abandoned()</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="comment">// There is no use waiting because this future will never 
complete</span></div><div class="line"><a name="l00151"></a><span 
class="lineno">  151</span>&#160;    <span class="comment">// so terminate this 
process which will cause `promise` to get</span></div><div class="line"><a 
name="l00152"></a><span class="lineno
 ">  152</span>&#160;    <span class="comment">// deleted and our future to 
also be abandoned.</span></div><div class="line"><a name="l00153"></a><span 
class="lineno">  153</span>&#160;    <a class="code" 
href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 class="keyword">this</span>);</div><div class="line"><a 
name="l00154"></a><span class="lineno">  154</span>&#160;  }</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="keywordtype">void</span> 
discarded()</div><div class="line"><a name="l00157"></a><span class="lineno">  
157</span>&#160;  {</div><div class="line"><a name="l00158"></a><span 
class="lineno">  158</span>&#160;    <span class="keywordflow">foreach</span> 
(<a class="code" href="classprocess_1_1Future.html">Future&lt;T&gt;</a> future, 
futures) {</div><div class="line"><a name="l00159"></a><span class="lineno">  1
 59</span>&#160;      future.<a class="code" 
href="classprocess_1_1Future.html#a4012f3faa6191fc13874dca62c14ced0">discard</a>();</div><div
 class="line"><a name="l00160"></a><span class="lineno">  160</span>&#160;    
}</div><div class="line"><a name="l00161"></a><span class="lineno">  
161</span>&#160;</div><div class="line"><a name="l00162"></a><span 
class="lineno">  162</span>&#160;    <span class="comment">// NOTE: we discard 
the promise after we set discard on each of</span></div><div class="line"><a 
name="l00163"></a><span class="lineno">  163</span>&#160;    <span 
class="comment">// the futures so that there is a happens-before relationship 
that</span></div><div class="line"><a name="l00164"></a><span class="lineno">  
164</span>&#160;    <span class="comment">// can be assumed by 
callers.</span></div><div class="line"><a name="l00165"></a><span 
class="lineno">  165</span>&#160;    promise-&gt;<a class="code" 
href="classprocess_1_1Promise.html#a8f50fcfd7ddb6dd39ec2cd468377cd5d">di
 scard</a>();</div><div class="line"><a name="l00166"></a><span class="lineno"> 
 166</span>&#160;</div><div class="line"><a name="l00167"></a><span 
class="lineno">  167</span>&#160;    <a class="code" 
href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 class="keyword">this</span>);</div><div class="line"><a 
name="l00168"></a><span class="lineno">  168</span>&#160;  }</div><div 
class="line"><a name="l00169"></a><span class="lineno">  
169</span>&#160;</div><div class="line"><a name="l00170"></a><span 
class="lineno">  170</span>&#160;  <span class="keywordtype">void</span> 
waited(<span class="keyword">const</span> <a class="code" 
href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&amp; future)</div><div 
class="line"><a name="l00171"></a><span class="lineno">  171</span>&#160;  
{</div><div class="line"><a name="l00172"></a><span class="lineno">  
172</span>&#160;    <span class="keywordflow">if</span> (future.<a class="code" 
href="classprocess_1_1Future.h
 tml#a493227e57f8848e37777b89c0f81e2ec">isFailed</a>()) {</div><div 
class="line"><a name="l00173"></a><span class="lineno">  173</span>&#160;      
promise-&gt;<a class="code" 
href="classprocess_1_1Promise.html#a2fc569c8bf99acb3e53a68ff3b266667">fail</a>(<span
 class="stringliteral">&quot;Collect failed: &quot;</span> + future.<a 
class="code" 
href="classprocess_1_1Future.html#ae649c56b07f44c05e4b7aa3620133ff9">failure</a>());</div><div
 class="line"><a name="l00174"></a><span class="lineno">  174</span>&#160;      
<a class="code" 
href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 class="keyword">this</span>);</div><div class="line"><a 
name="l00175"></a><span class="lineno">  175</span>&#160;    } <span 
class="keywordflow">else</span> <span class="keywordflow">if</span> (future.<a 
class="code" 
href="classprocess_1_1Future.html#abc89036db733a417b7b383b091efaf3c">isDiscarded</a>())
 {</div><div class="line"><a name="l00176"></a><span class="lineno">  176</spa
 n>&#160;      promise-&gt;<a class="code" 
href="classprocess_1_1Promise.html#a2fc569c8bf99acb3e53a68ff3b266667">fail</a>(<span
 class="stringliteral">&quot;Collect failed: future 
discarded&quot;</span>);</div><div class="line"><a name="l00177"></a><span 
class="lineno">  177</span>&#160;      <a class="code" 
href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 class="keyword">this</span>);</div><div class="line"><a 
name="l00178"></a><span class="lineno">  178</span>&#160;    } <span 
class="keywordflow">else</span> {</div><div class="line"><a 
name="l00179"></a><span class="lineno">  179</span>&#160;      <a class="code" 
href="libprocess_2include_2process_2check_8hpp.html#a55bf53e1f554470600774a6bf0c09140">CHECK_READY</a>(future);</div><div
 class="line"><a name="l00180"></a><span class="lineno">  180</span>&#160;      
ready += 1;</div><div class="line"><a name="l00181"></a><span class="lineno">  
181</span>&#160;      <span class="keywordflow">if</span> (rea
 dy == futures.size()) {</div><div class="line"><a name="l00182"></a><span 
class="lineno">  182</span>&#160;        std::list&lt;T&gt; values;</div><div 
class="line"><a name="l00183"></a><span class="lineno">  183</span>&#160;       
 <span class="keywordflow">foreach</span> (<span class="keyword">const</span> 
<a class="code" href="classprocess_1_1Future.html">Future&lt;T&gt;</a>&amp; 
future, futures) {</div><div class="line"><a name="l00184"></a><span 
class="lineno">  184</span>&#160;          values.push_back(future.<a 
class="code" 
href="classprocess_1_1Future.html#aa78977d3b585a5f5ccd682c1e9e2ddc4">get</a>());</div><div
 class="line"><a name="l00185"></a><span class="lineno">  185</span>&#160;      
  }</div><div class="line"><a name="l00186"></a><span class="lineno">  
186</span>&#160;        promise-&gt;<a class="code" 
href="classprocess_1_1Promise.html#a989b8dfa7eb2633de3f0f25ac2b87943">set</a>(values);</div><div
 class="line"><a name="l00187"></a><span class="lineno">  187</span>&#
 160;        <a class="code" 
href="namespaceprocess.html#a20443908afa3212215166e26065349e5">terminate</a>(<span
 class="keyword">this</span>);</div><div class="line"><a 
name="l00188"></a><span class="lineno">  188</span>&#160;      }</div><div 
class="line"><a name="l00189"></a><span class="lineno">  189</span>&#160;    
}</div><div class="line"><a name="l00190"></a><span class="lineno">  
190</span>&#160;  }</div><div class="line"><a name="l00191"></a><span 
class="lineno">  191</span>&#160;</div><div class="line"><a 
name="l00192"></a><span class="lineno">  192</span>&#160;  <span 
class="keyword">const</span> std::vector&lt;Future&lt;T&gt;&gt; 
futures;</div><div class="line"><a name="l00193"></a><span class="lineno">  
193</span>&#160;  <a class="code" 
href="classprocess_1_1Promise.html">Promise&lt;std::list&lt;T&gt;</a>&gt;* 
promise;</div><div class="line"><a name="l00194"></a><span class="lineno">  
194</span>&#160;  <span class="keywordtype">size_t</span> ready;</div><div 
class="line"><
 a name="l00195"></a><span class="lineno">  195</span>&#160;};</div><div 
class="line"><a name="l00196"></a><span class="lineno">  
196</span>&#160;</div><div class="line"><a name="l00197"></a><span 
class="lineno">  197</span>&#160;</div><div class="line"><a name="

<TRUNCATED>

Reply via email to