http://git-wip-us.apache.org/repos/asf/mesos-site/blob/63030bf4/content/api/latest/c++/resources_8hpp_source.html ---------------------------------------------------------------------- diff --git a/content/api/latest/c++/resources_8hpp_source.html b/content/api/latest/c++/resources_8hpp_source.html index 5cfad9e..5b65ce5 100644 --- a/content/api/latest/c++/resources_8hpp_source.html +++ b/content/api/latest/c++/resources_8hpp_source.html @@ -285,392 +285,399 @@ <div class="line"><a name="l00334"></a><span class="lineno"> 334</span>  <span class="comment">// This must be called only when the resource is reserved!</span></div> <div class="line"><a name="l00335"></a><span class="lineno"> 335</span>  <span class="keyword">static</span> <span class="keyword">const</span> std::string& <a class="code" href="classmesos_1_1Resources.html#af45f5789dd4c9d7345e47a072b37f9b4">reservationRole</a>(<span class="keyword">const</span> Resource& resource);</div> <div class="line"><a name="l00336"></a><span class="lineno"> 336</span> </div> -<div class="line"><a name="l00337"></a><span class="lineno"> 337</span>  <span class="comment">// Returns the summed up Resources given a hashmap<Key, Resources>.</span></div> -<div class="line"><a name="l00338"></a><span class="lineno"> 338</span>  <span class="comment">//</span></div> -<div class="line"><a name="l00339"></a><span class="lineno"> 339</span>  <span class="comment">// NOTE: While scalar resources such as "cpus" sum correctly,</span></div> -<div class="line"><a name="l00340"></a><span class="lineno"> 340</span>  <span class="comment">// non-scalar resources such as "ports" do not.</span></div> -<div class="line"><a name="l00341"></a><span class="lineno"> 341</span>  <span class="comment">// e.g. "cpus:2" + "cpus:1" = "cpus:3"</span></div> -<div class="line"><a name="l00342"></a><span class="lineno"> 342</span>  <span class="comment">// "ports:[0-100]" + "ports:[0-100]" = "ports:[0-100]"</span></div> -<div class="line"><a name="l00343"></a><span class="lineno"> 343</span>  <span class="comment">//</span></div> -<div class="line"><a name="l00344"></a><span class="lineno"> 344</span>  <span class="comment">// TODO(mpark): Deprecate this function once we introduce the</span></div> -<div class="line"><a name="l00345"></a><span class="lineno"> 345</span>  <span class="comment">// concept of "cluster-wide" resources which provides correct</span></div> -<div class="line"><a name="l00346"></a><span class="lineno"> 346</span>  <span class="comment">// semantics for summation over all types of resources. (e.g.</span></div> -<div class="line"><a name="l00347"></a><span class="lineno"> 347</span>  <span class="comment">// non-scalar)</span></div> -<div class="line"><a name="l00348"></a><span class="lineno"> 348</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> Key></div> -<div class="line"><a name="l00349"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a9753991686eca5e60ec5324a83535352"> 349</a></span>  <span class="keyword">static</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a9753991686eca5e60ec5324a83535352">sum</a>(<span class="keyword">const</span> <a class="code" href="classhashmap.html">hashmap<Key, Resources></a>& _resources)</div> -<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>  {</div> -<div class="line"><a name="l00351"></a><span class="lineno"> 351</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> result;</div> -<div class="line"><a name="l00352"></a><span class="lineno"> 352</span> </div> -<div class="line"><a name="l00353"></a><span class="lineno"> 353</span>  <a class="code" href="foreach_8hpp.html#a28670619e64a84270d76f07b0f6eb3b6">foreachvalue</a> (<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& resources, _resources) {</div> -<div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  result += resources;</div> -<div class="line"><a name="l00355"></a><span class="lineno"> 355</span>  }</div> -<div class="line"><a name="l00356"></a><span class="lineno"> 356</span> </div> -<div class="line"><a name="l00357"></a><span class="lineno"> 357</span>  <span class="keywordflow">return</span> result;</div> -<div class="line"><a name="l00358"></a><span class="lineno"> 358</span>  }</div> +<div class="line"><a name="l00337"></a><span class="lineno"> 337</span>  <span class="comment">// Shrinks a scalar type `resource` to the target size.</span></div> +<div class="line"><a name="l00338"></a><span class="lineno"> 338</span>  <span class="comment">// Returns true if the resource was shrunk to the target size,</span></div> +<div class="line"><a name="l00339"></a><span class="lineno"> 339</span>  <span class="comment">// or the resource is already within the target size.</span></div> +<div class="line"><a name="l00340"></a><span class="lineno"> 340</span>  <span class="comment">// Returns false otherwise (i.e. the resource is indivisible.</span></div> +<div class="line"><a name="l00341"></a><span class="lineno"> 341</span>  <span class="comment">// E.g. MOUNT volume).</span></div> +<div class="line"><a name="l00342"></a><span class="lineno"> 342</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#a1f3cdedd4148ab72cee6dd6283526c73">shrink</a>(Resource* resource, <span class="keyword">const</span> Value::Scalar& target);</div> +<div class="line"><a name="l00343"></a><span class="lineno"> 343</span> </div> +<div class="line"><a name="l00344"></a><span class="lineno"> 344</span>  <span class="comment">// Returns the summed up Resources given a hashmap<Key, Resources>.</span></div> +<div class="line"><a name="l00345"></a><span class="lineno"> 345</span>  <span class="comment">//</span></div> +<div class="line"><a name="l00346"></a><span class="lineno"> 346</span>  <span class="comment">// NOTE: While scalar resources such as "cpus" sum correctly,</span></div> +<div class="line"><a name="l00347"></a><span class="lineno"> 347</span>  <span class="comment">// non-scalar resources such as "ports" do not.</span></div> +<div class="line"><a name="l00348"></a><span class="lineno"> 348</span>  <span class="comment">// e.g. "cpus:2" + "cpus:1" = "cpus:3"</span></div> +<div class="line"><a name="l00349"></a><span class="lineno"> 349</span>  <span class="comment">// "ports:[0-100]" + "ports:[0-100]" = "ports:[0-100]"</span></div> +<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>  <span class="comment">//</span></div> +<div class="line"><a name="l00351"></a><span class="lineno"> 351</span>  <span class="comment">// TODO(mpark): Deprecate this function once we introduce the</span></div> +<div class="line"><a name="l00352"></a><span class="lineno"> 352</span>  <span class="comment">// concept of "cluster-wide" resources which provides correct</span></div> +<div class="line"><a name="l00353"></a><span class="lineno"> 353</span>  <span class="comment">// semantics for summation over all types of resources. (e.g.</span></div> +<div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  <span class="comment">// non-scalar)</span></div> +<div class="line"><a name="l00355"></a><span class="lineno"> 355</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> Key></div> +<div class="line"><a name="l00356"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a9753991686eca5e60ec5324a83535352"> 356</a></span>  <span class="keyword">static</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a9753991686eca5e60ec5324a83535352">sum</a>(<span class="keyword">const</span> <a class="code" href="classhashmap.html">hashmap<Key, Resources></a>& _resources)</div> +<div class="line"><a name="l00357"></a><span class="lineno"> 357</span>  {</div> +<div class="line"><a name="l00358"></a><span class="lineno"> 358</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> result;</div> <div class="line"><a name="l00359"></a><span class="lineno"> 359</span> </div> -<div class="line"><a name="l00360"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#aed60247869278b5545227ddf7ca9536b"> 360</a></span>  <a class="code" href="classmesos_1_1Resources.html#aed60247869278b5545227ddf7ca9536b">Resources</a>() {}</div> -<div class="line"><a name="l00361"></a><span class="lineno"> 361</span> </div> -<div class="line"><a name="l00362"></a><span class="lineno"> 362</span>  <span class="comment">// TODO(jieyu): Consider using C++11 initializer list.</span></div> -<div class="line"><a name="l00363"></a><span class="lineno"> 363</span>  <span class="comment">/*implicit*/</span> <a class="code" href="classmesos_1_1Resources.html#aed60247869278b5545227ddf7ca9536b">Resources</a>(<span class="keyword">const</span> Resource& resource);</div> -<div class="line"><a name="l00364"></a><span class="lineno"> 364</span> </div> -<div class="line"><a name="l00365"></a><span class="lineno"> 365</span>  <span class="comment">/*implicit*/</span></div> -<div class="line"><a name="l00366"></a><span class="lineno"> 366</span>  <a class="code" href="classmesos_1_1Resources.html#aed60247869278b5545227ddf7ca9536b">Resources</a>(<span class="keyword">const</span> std::vector<Resource>& _resources);</div> -<div class="line"><a name="l00367"></a><span class="lineno"> 367</span> </div> -<div class="line"><a name="l00368"></a><span class="lineno"> 368</span>  <span class="comment">/*implicit*/</span></div> -<div class="line"><a name="l00369"></a><span class="lineno"> 369</span>  <a class="code" href="classmesos_1_1Resources.html#aed60247869278b5545227ddf7ca9536b">Resources</a>(<span class="keyword">const</span> google::protobuf::RepeatedPtrField<Resource>& _resources);</div> -<div class="line"><a name="l00370"></a><span class="lineno"> 370</span> </div> -<div class="line"><a name="l00371"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a54f4d215c4b8c70ecb9029c2103d3e86"> 371</a></span>  <a class="code" href="classmesos_1_1Resources.html#a54f4d215c4b8c70ecb9029c2103d3e86">Resources</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that) : resources(that.resources) {}</div> -<div class="line"><a name="l00372"></a><span class="lineno"> 372</span> </div> -<div class="line"><a name="l00373"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a44e5b29fbe67ba65c43a51331be2629b"> 373</a></span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1Resources.html#a44e5b29fbe67ba65c43a51331be2629b">operator=</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that)</div> -<div class="line"><a name="l00374"></a><span class="lineno"> 374</span>  {</div> -<div class="line"><a name="l00375"></a><span class="lineno"> 375</span>  <span class="keywordflow">if</span> (<span class="keyword">this</span> != &that) {</div> -<div class="line"><a name="l00376"></a><span class="lineno"> 376</span>  resources = that.resources;</div> -<div class="line"><a name="l00377"></a><span class="lineno"> 377</span>  }</div> -<div class="line"><a name="l00378"></a><span class="lineno"> 378</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div> -<div class="line"><a name="l00379"></a><span class="lineno"> 379</span>  }</div> -<div class="line"><a name="l00380"></a><span class="lineno"> 380</span> </div> -<div class="line"><a name="l00381"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#ab46b900ebe62b19390d9a2a82b46eb15"> 381</a></span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#ab46b900ebe62b19390d9a2a82b46eb15">empty</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> resources.size() == 0; }</div> -<div class="line"><a name="l00382"></a><span class="lineno"> 382</span> </div> -<div class="line"><a name="l00383"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a941fe78c62de3a6fa7c7cf977960694a"> 383</a></span>  <span class="keywordtype">size_t</span> <a class="code" href="classmesos_1_1Resources.html#a941fe78c62de3a6fa7c7cf977960694a">size</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> resources.size(); }</div> -<div class="line"><a name="l00384"></a><span class="lineno"> 384</span> </div> -<div class="line"><a name="l00385"></a><span class="lineno"> 385</span>  <span class="comment">// Checks if this Resources is a superset of the given Resources.</span></div> -<div class="line"><a name="l00386"></a><span class="lineno"> 386</span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#a30fc4fe000da99818bfcee5bb780e5d4">contains</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00360"></a><span class="lineno"> 360</span>  <a class="code" href="foreach_8hpp.html#a28670619e64a84270d76f07b0f6eb3b6">foreachvalue</a> (<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& resources, _resources) {</div> +<div class="line"><a name="l00361"></a><span class="lineno"> 361</span>  result += resources;</div> +<div class="line"><a name="l00362"></a><span class="lineno"> 362</span>  }</div> +<div class="line"><a name="l00363"></a><span class="lineno"> 363</span> </div> +<div class="line"><a name="l00364"></a><span class="lineno"> 364</span>  <span class="keywordflow">return</span> result;</div> +<div class="line"><a name="l00365"></a><span class="lineno"> 365</span>  }</div> +<div class="line"><a name="l00366"></a><span class="lineno"> 366</span> </div> +<div class="line"><a name="l00367"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#aed60247869278b5545227ddf7ca9536b"> 367</a></span>  <a class="code" href="classmesos_1_1Resources.html#aed60247869278b5545227ddf7ca9536b">Resources</a>() {}</div> +<div class="line"><a name="l00368"></a><span class="lineno"> 368</span> </div> +<div class="line"><a name="l00369"></a><span class="lineno"> 369</span>  <span class="comment">// TODO(jieyu): Consider using C++11 initializer list.</span></div> +<div class="line"><a name="l00370"></a><span class="lineno"> 370</span>  <span class="comment">/*implicit*/</span> <a class="code" href="classmesos_1_1Resources.html#aed60247869278b5545227ddf7ca9536b">Resources</a>(<span class="keyword">const</span> Resource& resource);</div> +<div class="line"><a name="l00371"></a><span class="lineno"> 371</span> </div> +<div class="line"><a name="l00372"></a><span class="lineno"> 372</span>  <span class="comment">/*implicit*/</span></div> +<div class="line"><a name="l00373"></a><span class="lineno"> 373</span>  <a class="code" href="classmesos_1_1Resources.html#aed60247869278b5545227ddf7ca9536b">Resources</a>(<span class="keyword">const</span> std::vector<Resource>& _resources);</div> +<div class="line"><a name="l00374"></a><span class="lineno"> 374</span> </div> +<div class="line"><a name="l00375"></a><span class="lineno"> 375</span>  <span class="comment">/*implicit*/</span></div> +<div class="line"><a name="l00376"></a><span class="lineno"> 376</span>  <a class="code" href="classmesos_1_1Resources.html#aed60247869278b5545227ddf7ca9536b">Resources</a>(<span class="keyword">const</span> google::protobuf::RepeatedPtrField<Resource>& _resources);</div> +<div class="line"><a name="l00377"></a><span class="lineno"> 377</span> </div> +<div class="line"><a name="l00378"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a54f4d215c4b8c70ecb9029c2103d3e86"> 378</a></span>  <a class="code" href="classmesos_1_1Resources.html#a54f4d215c4b8c70ecb9029c2103d3e86">Resources</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that) : resources(that.resources) {}</div> +<div class="line"><a name="l00379"></a><span class="lineno"> 379</span> </div> +<div class="line"><a name="l00380"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a44e5b29fbe67ba65c43a51331be2629b"> 380</a></span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1Resources.html#a44e5b29fbe67ba65c43a51331be2629b">operator=</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that)</div> +<div class="line"><a name="l00381"></a><span class="lineno"> 381</span>  {</div> +<div class="line"><a name="l00382"></a><span class="lineno"> 382</span>  <span class="keywordflow">if</span> (<span class="keyword">this</span> != &that) {</div> +<div class="line"><a name="l00383"></a><span class="lineno"> 383</span>  resources = that.resources;</div> +<div class="line"><a name="l00384"></a><span class="lineno"> 384</span>  }</div> +<div class="line"><a name="l00385"></a><span class="lineno"> 385</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div> +<div class="line"><a name="l00386"></a><span class="lineno"> 386</span>  }</div> <div class="line"><a name="l00387"></a><span class="lineno"> 387</span> </div> -<div class="line"><a name="l00388"></a><span class="lineno"> 388</span>  <span class="comment">// Checks if this Resources contains the given Resource.</span></div> -<div class="line"><a name="l00389"></a><span class="lineno"> 389</span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#a30fc4fe000da99818bfcee5bb780e5d4">contains</a>(<span class="keyword">const</span> Resource& that) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00390"></a><span class="lineno"> 390</span> </div> -<div class="line"><a name="l00391"></a><span class="lineno"> 391</span>  <span class="comment">// Count the Resource objects that match the specified value.</span></div> -<div class="line"><a name="l00392"></a><span class="lineno"> 392</span>  <span class="comment">//</span></div> -<div class="line"><a name="l00393"></a><span class="lineno"> 393</span>  <span class="comment">// NOTE:</span></div> -<div class="line"><a name="l00394"></a><span class="lineno"> 394</span>  <span class="comment">// - For a non-shared resource the count can be at most 1 because all</span></div> -<div class="line"><a name="l00395"></a><span class="lineno"> 395</span>  <span class="comment">// non-shared Resource objects in Resources are unique.</span></div> -<div class="line"><a name="l00396"></a><span class="lineno"> 396</span>  <span class="comment">// - For a shared resource the count can be greater than 1.</span></div> -<div class="line"><a name="l00397"></a><span class="lineno"> 397</span>  <span class="comment">// - If the resource is not in the Resources object, the count is 0.</span></div> -<div class="line"><a name="l00398"></a><span class="lineno"> 398</span>  <span class="keywordtype">size_t</span> <a class="code" href="classmesos_1_1Resources.html#a0c2f42000d8bc6c2bc050be8b48b1e3c">count</a>(<span class="keyword">const</span> Resource& that) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00399"></a><span class="lineno"> 399</span> </div> -<div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  <span class="comment">// Allocates the resources to the given role (by setting the</span></div> -<div class="line"><a name="l00401"></a><span class="lineno"> 401</span>  <span class="comment">// `AllocationInfo.role`). Any existing allocation will be</span></div> -<div class="line"><a name="l00402"></a><span class="lineno"> 402</span>  <span class="comment">// over-written.</span></div> -<div class="line"><a name="l00403"></a><span class="lineno"> 403</span>  <span class="keywordtype">void</span> <a class="code" href="classmesos_1_1Resources.html#a4c6b7ba1b907eb21ddb20f4c14940634">allocate</a>(<span class="keyword">const</span> std::string& role);</div> -<div class="line"><a name="l00404"></a><span class="lineno"> 404</span> </div> -<div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  <span class="comment">// Unallocates the resources.</span></div> -<div class="line"><a name="l00406"></a><span class="lineno"> 406</span>  <span class="keywordtype">void</span> <a class="code" href="classmesos_1_1Resources.html#ae37d3b004781eb0f7b8d3676db9c6205">unallocate</a>();</div> -<div class="line"><a name="l00407"></a><span class="lineno"> 407</span> </div> -<div class="line"><a name="l00408"></a><span class="lineno"> 408</span>  <span class="comment">// Filter resources based on the given predicate.</span></div> -<div class="line"><a name="l00409"></a><span class="lineno"> 409</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a62ae547c0d24fdfb139549e9b8126fdf">filter</a>(</div> -<div class="line"><a name="l00410"></a><span class="lineno"> 410</span>  <span class="keyword">const</span> lambda::function<<span class="keywordtype">bool</span>(<span class="keyword">const</span> Resource&)>& predicate) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00388"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#ab46b900ebe62b19390d9a2a82b46eb15"> 388</a></span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#ab46b900ebe62b19390d9a2a82b46eb15">empty</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> resources.size() == 0; }</div> +<div class="line"><a name="l00389"></a><span class="lineno"> 389</span> </div> +<div class="line"><a name="l00390"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a941fe78c62de3a6fa7c7cf977960694a"> 390</a></span>  <span class="keywordtype">size_t</span> <a class="code" href="classmesos_1_1Resources.html#a941fe78c62de3a6fa7c7cf977960694a">size</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> resources.size(); }</div> +<div class="line"><a name="l00391"></a><span class="lineno"> 391</span> </div> +<div class="line"><a name="l00392"></a><span class="lineno"> 392</span>  <span class="comment">// Checks if this Resources is a superset of the given Resources.</span></div> +<div class="line"><a name="l00393"></a><span class="lineno"> 393</span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#a30fc4fe000da99818bfcee5bb780e5d4">contains</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00394"></a><span class="lineno"> 394</span> </div> +<div class="line"><a name="l00395"></a><span class="lineno"> 395</span>  <span class="comment">// Checks if this Resources contains the given Resource.</span></div> +<div class="line"><a name="l00396"></a><span class="lineno"> 396</span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#a30fc4fe000da99818bfcee5bb780e5d4">contains</a>(<span class="keyword">const</span> Resource& that) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00397"></a><span class="lineno"> 397</span> </div> +<div class="line"><a name="l00398"></a><span class="lineno"> 398</span>  <span class="comment">// Count the Resource objects that match the specified value.</span></div> +<div class="line"><a name="l00399"></a><span class="lineno"> 399</span>  <span class="comment">//</span></div> +<div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  <span class="comment">// NOTE:</span></div> +<div class="line"><a name="l00401"></a><span class="lineno"> 401</span>  <span class="comment">// - For a non-shared resource the count can be at most 1 because all</span></div> +<div class="line"><a name="l00402"></a><span class="lineno"> 402</span>  <span class="comment">// non-shared Resource objects in Resources are unique.</span></div> +<div class="line"><a name="l00403"></a><span class="lineno"> 403</span>  <span class="comment">// - For a shared resource the count can be greater than 1.</span></div> +<div class="line"><a name="l00404"></a><span class="lineno"> 404</span>  <span class="comment">// - If the resource is not in the Resources object, the count is 0.</span></div> +<div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  <span class="keywordtype">size_t</span> <a class="code" href="classmesos_1_1Resources.html#a0c2f42000d8bc6c2bc050be8b48b1e3c">count</a>(<span class="keyword">const</span> Resource& that) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00406"></a><span class="lineno"> 406</span> </div> +<div class="line"><a name="l00407"></a><span class="lineno"> 407</span>  <span class="comment">// Allocates the resources to the given role (by setting the</span></div> +<div class="line"><a name="l00408"></a><span class="lineno"> 408</span>  <span class="comment">// `AllocationInfo.role`). Any existing allocation will be</span></div> +<div class="line"><a name="l00409"></a><span class="lineno"> 409</span>  <span class="comment">// over-written.</span></div> +<div class="line"><a name="l00410"></a><span class="lineno"> 410</span>  <span class="keywordtype">void</span> <a class="code" href="classmesos_1_1Resources.html#a4c6b7ba1b907eb21ddb20f4c14940634">allocate</a>(<span class="keyword">const</span> std::string& role);</div> <div class="line"><a name="l00411"></a><span class="lineno"> 411</span> </div> -<div class="line"><a name="l00412"></a><span class="lineno"> 412</span>  <span class="comment">// Returns the reserved resources, by role.</span></div> -<div class="line"><a name="l00413"></a><span class="lineno"> 413</span>  <a class="code" href="classhashmap.html">hashmap<std::string, Resources></a> <a class="code" href="classmesos_1_1Resources.html#ade04c622a0b1ef1cf9dc88ac4007d958">reservations</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00412"></a><span class="lineno"> 412</span>  <span class="comment">// Unallocates the resources.</span></div> +<div class="line"><a name="l00413"></a><span class="lineno"> 413</span>  <span class="keywordtype">void</span> <a class="code" href="classmesos_1_1Resources.html#ae37d3b004781eb0f7b8d3676db9c6205">unallocate</a>();</div> <div class="line"><a name="l00414"></a><span class="lineno"> 414</span> </div> -<div class="line"><a name="l00415"></a><span class="lineno"> 415</span>  <span class="comment">// Returns the reserved resources for the role, if specified.</span></div> -<div class="line"><a name="l00416"></a><span class="lineno"> 416</span>  <span class="comment">// Note that the "*" role represents unreserved resources,</span></div> -<div class="line"><a name="l00417"></a><span class="lineno"> 417</span>  <span class="comment">// and will be ignored.</span></div> -<div class="line"><a name="l00418"></a><span class="lineno"> 418</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a5deaa3422ebd3b42b012ace9e7802748">reserved</a>(<span class="keyword">const</span> <a class="code" href="classOption.html">Option<std::string></a>& role = <a class="code" href="structNone.html">None</a>()) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00419"></a><span class="lineno"> 419</span> </div> -<div class="line"><a name="l00420"></a><span class="lineno"> 420</span>  <span class="comment">// Returns resources allocatable to role. See `isAllocatableTo` for the</span></div> -<div class="line"><a name="l00421"></a><span class="lineno"> 421</span>  <span class="comment">// definition of 'allocatableTo'.</span></div> -<div class="line"><a name="l00422"></a><span class="lineno"> 422</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#abe08f658e725b14aef800394d1b5f4a0">allocatableTo</a>(<span class="keyword">const</span> std::string& role) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00423"></a><span class="lineno"> 423</span> </div> -<div class="line"><a name="l00424"></a><span class="lineno"> 424</span>  <span class="comment">// Returns the unreserved resources.</span></div> -<div class="line"><a name="l00425"></a><span class="lineno"> 425</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a643e177ab27dd9448ec1f3e8cbbc5634">unreserved</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00415"></a><span class="lineno"> 415</span>  <span class="comment">// Filter resources based on the given predicate.</span></div> +<div class="line"><a name="l00416"></a><span class="lineno"> 416</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a62ae547c0d24fdfb139549e9b8126fdf">filter</a>(</div> +<div class="line"><a name="l00417"></a><span class="lineno"> 417</span>  <span class="keyword">const</span> lambda::function<<span class="keywordtype">bool</span>(<span class="keyword">const</span> Resource&)>& predicate) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00418"></a><span class="lineno"> 418</span> </div> +<div class="line"><a name="l00419"></a><span class="lineno"> 419</span>  <span class="comment">// Returns the reserved resources, by role.</span></div> +<div class="line"><a name="l00420"></a><span class="lineno"> 420</span>  <a class="code" href="classhashmap.html">hashmap<std::string, Resources></a> <a class="code" href="classmesos_1_1Resources.html#ade04c622a0b1ef1cf9dc88ac4007d958">reservations</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00421"></a><span class="lineno"> 421</span> </div> +<div class="line"><a name="l00422"></a><span class="lineno"> 422</span>  <span class="comment">// Returns the reserved resources for the role, if specified.</span></div> +<div class="line"><a name="l00423"></a><span class="lineno"> 423</span>  <span class="comment">// Note that the "*" role represents unreserved resources,</span></div> +<div class="line"><a name="l00424"></a><span class="lineno"> 424</span>  <span class="comment">// and will be ignored.</span></div> +<div class="line"><a name="l00425"></a><span class="lineno"> 425</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a5deaa3422ebd3b42b012ace9e7802748">reserved</a>(<span class="keyword">const</span> <a class="code" href="classOption.html">Option<std::string></a>& role = <a class="code" href="structNone.html">None</a>()) <span class="keyword">const</span>;</div> <div class="line"><a name="l00426"></a><span class="lineno"> 426</span> </div> -<div class="line"><a name="l00427"></a><span class="lineno"> 427</span>  <span class="comment">// Returns the persistent volumes.</span></div> -<div class="line"><a name="l00428"></a><span class="lineno"> 428</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a1e0ae1441006e85f3f15ece5eb30d8dc">persistentVolumes</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00429"></a><span class="lineno"> 429</span> </div> -<div class="line"><a name="l00430"></a><span class="lineno"> 430</span>  <span class="comment">// Returns the revocable resources.</span></div> -<div class="line"><a name="l00431"></a><span class="lineno"> 431</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#ab24fc44ad91b263500d2736a54a9aea3">revocable</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00432"></a><span class="lineno"> 432</span> </div> -<div class="line"><a name="l00433"></a><span class="lineno"> 433</span>  <span class="comment">// Returns the non-revocable resources, effectively !revocable().</span></div> -<div class="line"><a name="l00434"></a><span class="lineno"> 434</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#ae5cbdd78bfaf5de8ad74463b3a9bd5f5">nonRevocable</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00435"></a><span class="lineno"> 435</span> </div> -<div class="line"><a name="l00436"></a><span class="lineno"> 436</span>  <span class="comment">// Returns the shared resources.</span></div> -<div class="line"><a name="l00437"></a><span class="lineno"> 437</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a1bf71a3804f142e92e0dd28884ea8f99">shared</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00438"></a><span class="lineno"> 438</span> </div> -<div class="line"><a name="l00439"></a><span class="lineno"> 439</span>  <span class="comment">// Returns the non-shared resources.</span></div> -<div class="line"><a name="l00440"></a><span class="lineno"> 440</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a7422a6ffb5e5988b507d587de1aa3e66">nonShared</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00441"></a><span class="lineno"> 441</span> </div> -<div class="line"><a name="l00442"></a><span class="lineno"> 442</span>  <span class="comment">// Returns the per-role allocations within these resource objects.</span></div> -<div class="line"><a name="l00443"></a><span class="lineno"> 443</span>  <span class="comment">// This must be called only when the resources are allocated!</span></div> -<div class="line"><a name="l00444"></a><span class="lineno"> 444</span>  <a class="code" href="classhashmap.html">hashmap<std::string, Resources></a> <a class="code" href="classmesos_1_1Resources.html#ab2c34cf1de471159a32b8e9c9d8cbe79">allocations</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00427"></a><span class="lineno"> 427</span>  <span class="comment">// Returns resources allocatable to role. See `isAllocatableTo` for the</span></div> +<div class="line"><a name="l00428"></a><span class="lineno"> 428</span>  <span class="comment">// definition of 'allocatableTo'.</span></div> +<div class="line"><a name="l00429"></a><span class="lineno"> 429</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#abe08f658e725b14aef800394d1b5f4a0">allocatableTo</a>(<span class="keyword">const</span> std::string& role) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00430"></a><span class="lineno"> 430</span> </div> +<div class="line"><a name="l00431"></a><span class="lineno"> 431</span>  <span class="comment">// Returns the unreserved resources.</span></div> +<div class="line"><a name="l00432"></a><span class="lineno"> 432</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a643e177ab27dd9448ec1f3e8cbbc5634">unreserved</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00433"></a><span class="lineno"> 433</span> </div> +<div class="line"><a name="l00434"></a><span class="lineno"> 434</span>  <span class="comment">// Returns the persistent volumes.</span></div> +<div class="line"><a name="l00435"></a><span class="lineno"> 435</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a1e0ae1441006e85f3f15ece5eb30d8dc">persistentVolumes</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00436"></a><span class="lineno"> 436</span> </div> +<div class="line"><a name="l00437"></a><span class="lineno"> 437</span>  <span class="comment">// Returns the revocable resources.</span></div> +<div class="line"><a name="l00438"></a><span class="lineno"> 438</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#ab24fc44ad91b263500d2736a54a9aea3">revocable</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00439"></a><span class="lineno"> 439</span> </div> +<div class="line"><a name="l00440"></a><span class="lineno"> 440</span>  <span class="comment">// Returns the non-revocable resources, effectively !revocable().</span></div> +<div class="line"><a name="l00441"></a><span class="lineno"> 441</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#ae5cbdd78bfaf5de8ad74463b3a9bd5f5">nonRevocable</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00442"></a><span class="lineno"> 442</span> </div> +<div class="line"><a name="l00443"></a><span class="lineno"> 443</span>  <span class="comment">// Returns the shared resources.</span></div> +<div class="line"><a name="l00444"></a><span class="lineno"> 444</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a1bf71a3804f142e92e0dd28884ea8f99">shared</a>() <span class="keyword">const</span>;</div> <div class="line"><a name="l00445"></a><span class="lineno"> 445</span> </div> -<div class="line"><a name="l00446"></a><span class="lineno"> 446</span>  <span class="comment">// Returns a `Resources` object with the new reservation added to the back.</span></div> -<div class="line"><a name="l00447"></a><span class="lineno"> 447</span>  <span class="comment">// The new reservation must be a valid refinement of the current reservation.</span></div> -<div class="line"><a name="l00448"></a><span class="lineno"> 448</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a0128e578d26c22934e888a66b9424717">pushReservation</a>(<span class="keyword">const</span> Resource::ReservationInfo& reservation) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00449"></a><span class="lineno"> 449</span> </div> -<div class="line"><a name="l00450"></a><span class="lineno"> 450</span>  <span class="comment">// Returns a `Resources` object with the last reservation removed.</span></div> -<div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  <span class="comment">// Every resource in `Resources` must have `resource.reservations_size() > 0`.</span></div> -<div class="line"><a name="l00452"></a><span class="lineno"> 452</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a8a0ecdc2adae018a61f437a1275faa3b">popReservation</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00453"></a><span class="lineno"> 453</span> </div> -<div class="line"><a name="l00454"></a><span class="lineno"> 454</span>  <span class="comment">// Returns a `Resources` object with all of the reservations removed.</span></div> -<div class="line"><a name="l00455"></a><span class="lineno"> 455</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a1e1245295d0792d35f4ef441aa8a313a">toUnreserved</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00446"></a><span class="lineno"> 446</span>  <span class="comment">// Returns the non-shared resources.</span></div> +<div class="line"><a name="l00447"></a><span class="lineno"> 447</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a7422a6ffb5e5988b507d587de1aa3e66">nonShared</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00448"></a><span class="lineno"> 448</span> </div> +<div class="line"><a name="l00449"></a><span class="lineno"> 449</span>  <span class="comment">// Returns the per-role allocations within these resource objects.</span></div> +<div class="line"><a name="l00450"></a><span class="lineno"> 450</span>  <span class="comment">// This must be called only when the resources are allocated!</span></div> +<div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  <a class="code" href="classhashmap.html">hashmap<std::string, Resources></a> <a class="code" href="classmesos_1_1Resources.html#ab2c34cf1de471159a32b8e9c9d8cbe79">allocations</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00452"></a><span class="lineno"> 452</span> </div> +<div class="line"><a name="l00453"></a><span class="lineno"> 453</span>  <span class="comment">// Returns a `Resources` object with the new reservation added to the back.</span></div> +<div class="line"><a name="l00454"></a><span class="lineno"> 454</span>  <span class="comment">// The new reservation must be a valid refinement of the current reservation.</span></div> +<div class="line"><a name="l00455"></a><span class="lineno"> 455</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a0128e578d26c22934e888a66b9424717">pushReservation</a>(<span class="keyword">const</span> Resource::ReservationInfo& reservation) <span class="keyword">const</span>;</div> <div class="line"><a name="l00456"></a><span class="lineno"> 456</span> </div> -<div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  <span class="comment">// Returns a Resources object that contains all the scalar resources</span></div> -<div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  <span class="comment">// in this object, but with their AllocationInfo, ReservationInfo,</span></div> -<div class="line"><a name="l00459"></a><span class="lineno"> 459</span>  <span class="comment">// DiskInfo, and SharedInfo omitted. The `role` and RevocableInfo,</span></div> -<div class="line"><a name="l00460"></a><span class="lineno"> 460</span>  <span class="comment">// if any, are preserved. Because we clear ReservationInfo but</span></div> -<div class="line"><a name="l00461"></a><span class="lineno"> 461</span>  <span class="comment">// preserve `role`, this means that stripping a dynamically reserved</span></div> -<div class="line"><a name="l00462"></a><span class="lineno"> 462</span>  <span class="comment">// resource makes it effectively statically reserved.</span></div> -<div class="line"><a name="l00463"></a><span class="lineno"> 463</span>  <span class="comment">//</span></div> -<div class="line"><a name="l00464"></a><span class="lineno"> 464</span>  <span class="comment">// This is intended for code that would like to aggregate together</span></div> -<div class="line"><a name="l00465"></a><span class="lineno"> 465</span>  <span class="comment">// Resource values without regard for metadata like whether the</span></div> -<div class="line"><a name="l00466"></a><span class="lineno"> 466</span>  <span class="comment">// resource is reserved or the particular volume ID in use. For</span></div> -<div class="line"><a name="l00467"></a><span class="lineno"> 467</span>  <span class="comment">// example, when calculating the total resources in a cluster,</span></div> -<div class="line"><a name="l00468"></a><span class="lineno"> 468</span>  <span class="comment">// preserving such information has a major performance cost.</span></div> -<div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a350c2c74774111e8b961127b7311fecc">createStrippedScalarQuantity</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00470"></a><span class="lineno"> 470</span> </div> -<div class="line"><a name="l00471"></a><span class="lineno"> 471</span>  <span class="comment">// Finds a Resources object with the same amount of each resource</span></div> -<div class="line"><a name="l00472"></a><span class="lineno"> 472</span>  <span class="comment">// type as "targets" from these Resources. The roles specified in</span></div> -<div class="line"><a name="l00473"></a><span class="lineno"> 473</span>  <span class="comment">// "targets" set the preference order. For each resource type,</span></div> -<div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  <span class="comment">// resources are first taken from the specified role, then from '*',</span></div> -<div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  <span class="comment">// then from any other role.</span></div> -<div class="line"><a name="l00476"></a><span class="lineno"> 476</span>  <span class="comment">// TODO(jieyu): 'find' contains some allocation logic for scalars and</span></div> -<div class="line"><a name="l00477"></a><span class="lineno"> 477</span>  <span class="comment">// fixed set / range elements. However, this is not sufficient for</span></div> -<div class="line"><a name="l00478"></a><span class="lineno"> 478</span>  <span class="comment">// schedulers that want, say, any N available ports. We should</span></div> -<div class="line"><a name="l00479"></a><span class="lineno"> 479</span>  <span class="comment">// consider moving this to an internal "allocation" library for our</span></div> -<div class="line"><a name="l00480"></a><span class="lineno"> 480</span>  <span class="comment">// example frameworks to leverage.</span></div> -<div class="line"><a name="l00481"></a><span class="lineno"> 481</span>  <a class="code" href="classOption.html">Option<Resources></a> <a class="code" href="classmesos_1_1Resources.html#a531f3b2cf4318aa421a2c9a9134992d1">find</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& targets) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00482"></a><span class="lineno"> 482</span> </div> -<div class="line"><a name="l00483"></a><span class="lineno"> 483</span>  <span class="comment">// Applies a resource conversion by taking out the `consumed`</span></div> -<div class="line"><a name="l00484"></a><span class="lineno"> 484</span>  <span class="comment">// resources and adding back the `converted` resources. Returns an</span></div> -<div class="line"><a name="l00485"></a><span class="lineno"> 485</span>  <span class="comment">// Error if the conversion cannot be applied.</span></div> -<div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  <a class="code" href="classTry.html">Try<Resources></a> <a class="code" href="classmesos_1_1Resources.html#acebab4e58f4f5073389a5e077e72fece">apply</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1ResourceConversion.html">ResourceConversion</a>& conversion) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00487"></a><span class="lineno"> 487</span> </div> -<div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  <span class="comment">// Obtains the conversion from the given operation and applies the</span></div> -<div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  <span class="comment">// conversion. This method serves a syntax sugar for applying a</span></div> -<div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  <span class="comment">// resource conversion.</span></div> -<div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  <span class="comment">// TODO(jieyu): Consider remove this method once we updated all the</span></div> -<div class="line"><a name="l00492"></a><span class="lineno"> 492</span>  <span class="comment">// call sites.</span></div> -<div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  <a class="code" href="classTry.html">Try<Resources></a> <a class="code" href="classmesos_1_1Resources.html#acebab4e58f4f5073389a5e077e72fece">apply</a>(<span class="keyword">const</span> <a class="code" href="namespacecgroups_1_1blkio.html#a350b1eb57318afaea7700ab7786b55ef">Offer::Operation</a>& operation) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  <span class="comment">// Returns a `Resources` object with the last reservation removed.</span></div> +<div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  <span class="comment">// Every resource in `Resources` must have `resource.reservations_size() > 0`.</span></div> +<div class="line"><a name="l00459"></a><span class="lineno"> 459</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a8a0ecdc2adae018a61f437a1275faa3b">popReservation</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00460"></a><span class="lineno"> 460</span> </div> +<div class="line"><a name="l00461"></a><span class="lineno"> 461</span>  <span class="comment">// Returns a `Resources` object with all of the reservations removed.</span></div> +<div class="line"><a name="l00462"></a><span class="lineno"> 462</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a1e1245295d0792d35f4ef441aa8a313a">toUnreserved</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00463"></a><span class="lineno"> 463</span> </div> +<div class="line"><a name="l00464"></a><span class="lineno"> 464</span>  <span class="comment">// Returns a Resources object that contains all the scalar resources</span></div> +<div class="line"><a name="l00465"></a><span class="lineno"> 465</span>  <span class="comment">// in this object, but with their AllocationInfo, ReservationInfo,</span></div> +<div class="line"><a name="l00466"></a><span class="lineno"> 466</span>  <span class="comment">// DiskInfo, and SharedInfo omitted. The `role` and RevocableInfo,</span></div> +<div class="line"><a name="l00467"></a><span class="lineno"> 467</span>  <span class="comment">// if any, are preserved. Because we clear ReservationInfo but</span></div> +<div class="line"><a name="l00468"></a><span class="lineno"> 468</span>  <span class="comment">// preserve `role`, this means that stripping a dynamically reserved</span></div> +<div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  <span class="comment">// resource makes it effectively statically reserved.</span></div> +<div class="line"><a name="l00470"></a><span class="lineno"> 470</span>  <span class="comment">//</span></div> +<div class="line"><a name="l00471"></a><span class="lineno"> 471</span>  <span class="comment">// This is intended for code that would like to aggregate together</span></div> +<div class="line"><a name="l00472"></a><span class="lineno"> 472</span>  <span class="comment">// Resource values without regard for metadata like whether the</span></div> +<div class="line"><a name="l00473"></a><span class="lineno"> 473</span>  <span class="comment">// resource is reserved or the particular volume ID in use. For</span></div> +<div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  <span class="comment">// example, when calculating the total resources in a cluster,</span></div> +<div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  <span class="comment">// preserving such information has a major performance cost.</span></div> +<div class="line"><a name="l00476"></a><span class="lineno"> 476</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a350c2c74774111e8b961127b7311fecc">createStrippedScalarQuantity</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00477"></a><span class="lineno"> 477</span> </div> +<div class="line"><a name="l00478"></a><span class="lineno"> 478</span>  <span class="comment">// Finds a Resources object with the same amount of each resource</span></div> +<div class="line"><a name="l00479"></a><span class="lineno"> 479</span>  <span class="comment">// type as "targets" from these Resources. The roles specified in</span></div> +<div class="line"><a name="l00480"></a><span class="lineno"> 480</span>  <span class="comment">// "targets" set the preference order. For each resource type,</span></div> +<div class="line"><a name="l00481"></a><span class="lineno"> 481</span>  <span class="comment">// resources are first taken from the specified role, then from '*',</span></div> +<div class="line"><a name="l00482"></a><span class="lineno"> 482</span>  <span class="comment">// then from any other role.</span></div> +<div class="line"><a name="l00483"></a><span class="lineno"> 483</span>  <span class="comment">// TODO(jieyu): 'find' contains some allocation logic for scalars and</span></div> +<div class="line"><a name="l00484"></a><span class="lineno"> 484</span>  <span class="comment">// fixed set / range elements. However, this is not sufficient for</span></div> +<div class="line"><a name="l00485"></a><span class="lineno"> 485</span>  <span class="comment">// schedulers that want, say, any N available ports. We should</span></div> +<div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  <span class="comment">// consider moving this to an internal "allocation" library for our</span></div> +<div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  <span class="comment">// example frameworks to leverage.</span></div> +<div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  <a class="code" href="classOption.html">Option<Resources></a> <a class="code" href="classmesos_1_1Resources.html#a531f3b2cf4318aa421a2c9a9134992d1">find</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& targets) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00489"></a><span class="lineno"> 489</span> </div> +<div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  <span class="comment">// Applies a resource conversion by taking out the `consumed`</span></div> +<div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  <span class="comment">// resources and adding back the `converted` resources. Returns an</span></div> +<div class="line"><a name="l00492"></a><span class="lineno"> 492</span>  <span class="comment">// Error if the conversion cannot be applied.</span></div> +<div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  <a class="code" href="classTry.html">Try<Resources></a> <a class="code" href="classmesos_1_1Resources.html#acebab4e58f4f5073389a5e077e72fece">apply</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1ResourceConversion.html">ResourceConversion</a>& conversion) <span class="keyword">const</span>;</div> <div class="line"><a name="l00494"></a><span class="lineno"> 494</span> </div> -<div class="line"><a name="l00495"></a><span class="lineno"> 495</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> Iterable></div> -<div class="line"><a name="l00496"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#aa0307172aed9f2a8bf5ab9852808074b"> 496</a></span>  <a class="code" href="classTry.html">Try<Resources></a> <a class="code" href="classmesos_1_1Resources.html#aa0307172aed9f2a8bf5ab9852808074b">apply</a>(<span class="keyword">const</span> Iterable& iterable)<span class="keyword"> const</span></div> -<div class="line"><a name="l00497"></a><span class="lineno"> 497</span> <span class="keyword"> </span>{</div> -<div class="line"><a name="l00498"></a><span class="lineno"> 498</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> result = *<span class="keyword">this</span>;</div> -<div class="line"><a name="l00499"></a><span class="lineno"> 499</span> </div> -<div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  <span class="keywordflow">foreach</span> (<span class="keyword">const</span> <span class="keyword">auto</span>& t, iterable) {</div> -<div class="line"><a name="l00501"></a><span class="lineno"> 501</span>  <a class="code" href="classTry.html">Try<Resources></a> converted = result.<a class="code" href="classmesos_1_1Resources.html#acebab4e58f4f5073389a5e077e72fece">apply</a>(t);</div> -<div class="line"><a name="l00502"></a><span class="lineno"> 502</span>  <span class="keywordflow">if</span> (converted.<a class="code" href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) {</div> -<div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(converted.<a class="code" href="classTry.html#aec4a11ddd3c036e889d90b7eb6258ba7">error</a>());</div> -<div class="line"><a name="l00504"></a><span class="lineno"> 504</span>  }</div> -<div class="line"><a name="l00505"></a><span class="lineno"> 505</span> </div> -<div class="line"><a name="l00506"></a><span class="lineno"> 506</span>  result = converted.<a class="code" href="classTry.html#a7be0768038e0628632492edf6cc1515a">get</a>();</div> -<div class="line"><a name="l00507"></a><span class="lineno"> 507</span>  }</div> -<div class="line"><a name="l00508"></a><span class="lineno"> 508</span> </div> -<div class="line"><a name="l00509"></a><span class="lineno"> 509</span>  <span class="keywordflow">return</span> result;</div> -<div class="line"><a name="l00510"></a><span class="lineno"> 510</span>  }</div> -<div class="line"><a name="l00511"></a><span class="lineno"> 511</span> </div> -<div class="line"><a name="l00512"></a><span class="lineno"> 512</span>  <span class="comment">// Helpers to get resource values. We consider all roles here.</span></div> -<div class="line"><a name="l00513"></a><span class="lineno"> 513</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T></div> -<div class="line"><a name="l00514"></a><span class="lineno"> 514</span>  <a class="code" href="classOption.html">Option<T></a> <span class="keyword">get</span>(<span class="keyword">const</span> std::string& <a class="code" href="namespaceos_1_1Shell.html#acfe16ef2b1146ad49a8651c0a457ce46">name</a>) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00495"></a><span class="lineno"> 495</span>  <span class="comment">// Obtains the conversion from the given operation and applies the</span></div> +<div class="line"><a name="l00496"></a><span class="lineno"> 496</span>  <span class="comment">// conversion. This method serves a syntax sugar for applying a</span></div> +<div class="line"><a name="l00497"></a><span class="lineno"> 497</span>  <span class="comment">// resource conversion.</span></div> +<div class="line"><a name="l00498"></a><span class="lineno"> 498</span>  <span class="comment">// TODO(jieyu): Consider remove this method once we updated all the</span></div> +<div class="line"><a name="l00499"></a><span class="lineno"> 499</span>  <span class="comment">// call sites.</span></div> +<div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  <a class="code" href="classTry.html">Try<Resources></a> <a class="code" href="classmesos_1_1Resources.html#acebab4e58f4f5073389a5e077e72fece">apply</a>(<span class="keyword">const</span> <a class="code" href="namespacecgroups_1_1blkio.html#a350b1eb57318afaea7700ab7786b55ef">Offer::Operation</a>& operation) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00501"></a><span class="lineno"> 501</span> </div> +<div class="line"><a name="l00502"></a><span class="lineno"> 502</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> Iterable></div> +<div class="line"><a name="l00503"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#aa0307172aed9f2a8bf5ab9852808074b"> 503</a></span>  <a class="code" href="classTry.html">Try<Resources></a> <a class="code" href="classmesos_1_1Resources.html#aa0307172aed9f2a8bf5ab9852808074b">apply</a>(<span class="keyword">const</span> Iterable& iterable)<span class="keyword"> const</span></div> +<div class="line"><a name="l00504"></a><span class="lineno"> 504</span> <span class="keyword"> </span>{</div> +<div class="line"><a name="l00505"></a><span class="lineno"> 505</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> result = *<span class="keyword">this</span>;</div> +<div class="line"><a name="l00506"></a><span class="lineno"> 506</span> </div> +<div class="line"><a name="l00507"></a><span class="lineno"> 507</span>  <span class="keywordflow">foreach</span> (<span class="keyword">const</span> <span class="keyword">auto</span>& t, iterable) {</div> +<div class="line"><a name="l00508"></a><span class="lineno"> 508</span>  <a class="code" href="classTry.html">Try<Resources></a> converted = result.<a class="code" href="classmesos_1_1Resources.html#acebab4e58f4f5073389a5e077e72fece">apply</a>(t);</div> +<div class="line"><a name="l00509"></a><span class="lineno"> 509</span>  <span class="keywordflow">if</span> (converted.<a class="code" href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) {</div> +<div class="line"><a name="l00510"></a><span class="lineno"> 510</span>  <span class="keywordflow">return</span> <a class="code" href="classError.html">Error</a>(converted.<a class="code" href="classTry.html#aec4a11ddd3c036e889d90b7eb6258ba7">error</a>());</div> +<div class="line"><a name="l00511"></a><span class="lineno"> 511</span>  }</div> +<div class="line"><a name="l00512"></a><span class="lineno"> 512</span> </div> +<div class="line"><a name="l00513"></a><span class="lineno"> 513</span>  result = converted.<a class="code" href="classTry.html#a7be0768038e0628632492edf6cc1515a">get</a>();</div> +<div class="line"><a name="l00514"></a><span class="lineno"> 514</span>  }</div> <div class="line"><a name="l00515"></a><span class="lineno"> 515</span> </div> -<div class="line"><a name="l00516"></a><span class="lineno"> 516</span>  <span class="comment">// Get resources of the given name.</span></div> -<div class="line"><a name="l00517"></a><span class="lineno"> 517</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <span class="keyword">get</span>(<span class="keyword">const</span> std::string& <a class="code" href="namespaceos_1_1Shell.html#acfe16ef2b1146ad49a8651c0a457ce46">name</a>) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00516"></a><span class="lineno"> 516</span>  <span class="keywordflow">return</span> result;</div> +<div class="line"><a name="l00517"></a><span class="lineno"> 517</span>  }</div> <div class="line"><a name="l00518"></a><span class="lineno"> 518</span> </div> -<div class="line"><a name="l00519"></a><span class="lineno"> 519</span>  <span class="comment">// Get all the resources that are scalars.</span></div> -<div class="line"><a name="l00520"></a><span class="lineno"> 520</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a19c38bf426688c0fb1fcc5552b29a729">scalars</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00521"></a><span class="lineno"> 521</span> </div> -<div class="line"><a name="l00522"></a><span class="lineno"> 522</span>  <span class="comment">// Get the set of unique resource names.</span></div> -<div class="line"><a name="l00523"></a><span class="lineno"> 523</span>  std::set<std::string> <a class="code" href="classmesos_1_1Resources.html#a376ffdcf83696b9a957b8a24ce596649">names</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00524"></a><span class="lineno"> 524</span> </div> -<div class="line"><a name="l00525"></a><span class="lineno"> 525</span>  <span class="comment">// Get the types of resources associated with each resource name.</span></div> -<div class="line"><a name="l00526"></a><span class="lineno"> 526</span>  <span class="comment">// NOTE: Resources of the same name must have the same type, as</span></div> -<div class="line"><a name="l00527"></a><span class="lineno"> 527</span>  <span class="comment">// enforced by Resources::parse().</span></div> -<div class="line"><a name="l00528"></a><span class="lineno"> 528</span>  std::map<std::string, Value_Type> <a class="code" href="classmesos_1_1Resources.html#a6c4d4a889c254fb4241644c6557d511e">types</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00529"></a><span class="lineno"> 529</span> </div> -<div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  <span class="comment">// Helpers to get known resource types.</span></div> -<div class="line"><a name="l00531"></a><span class="lineno"> 531</span>  <span class="comment">// TODO(vinod): Fix this when we make these types as first class</span></div> -<div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  <span class="comment">// protobufs.</span></div> -<div class="line"><a name="l00533"></a><span class="lineno"> 533</span>  <a class="code" href="classOption.html">Option<double></a> <a class="code" href="classmesos_1_1Resources.html#a127e7442993f5b86d03625c4ab1e8271">cpus</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00534"></a><span class="lineno"> 534</span>  <a class="code" href="classOption.html">Option<double></a> <a class="code" href="classmesos_1_1Resources.html#ab7efb90fdd329ee238af86013584480d">gpus</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00535"></a><span class="lineno"> 535</span>  <a class="code" href="classOption.html">Option<Bytes></a> <a class="code" href="classmesos_1_1Resources.html#afdf2dfb4dd2c53acf5cd96bb6f02140c">mem</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00536"></a><span class="lineno"> 536</span>  <a class="code" href="classOption.html">Option<Bytes></a> <a class="code" href="classmesos_1_1Resources.html#a25edbf9ca3dc21aec283b25e48308794">disk</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00537"></a><span class="lineno"> 537</span> </div> -<div class="line"><a name="l00538"></a><span class="lineno"> 538</span>  <span class="comment">// TODO(vinod): Provide a Ranges abstraction.</span></div> -<div class="line"><a name="l00539"></a><span class="lineno"> 539</span>  <a class="code" href="classOption.html">Option<Value::Ranges></a> <a class="code" href="classmesos_1_1Resources.html#af9c888191c3f7408ab11bb064e881507">ports</a>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00540"></a><span class="lineno"> 540</span> </div> -<div class="line"><a name="l00541"></a><span class="lineno"> 541</span>  <span class="comment">// TODO(jieyu): Consider returning an EphemeralPorts abstraction</span></div> -<div class="line"><a name="l00542"></a><span class="lineno"> 542</span>  <span class="comment">// which holds the ephemeral ports allocation logic.</span></div> -<div class="line"><a name="l00543"></a><span class="lineno"> 543</span>  <a class="code" href="classOption.html">Option<Value::Ranges></a> <a class="code" href="classmesos_1_1Resources.html#a88a531c0e331b9a6b26ab5cedd2c87d2">ephemeral_ports</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00519"></a><span class="lineno"> 519</span>  <span class="comment">// Helpers to get resource values. We consider all roles here.</span></div> +<div class="line"><a name="l00520"></a><span class="lineno"> 520</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T></div> +<div class="line"><a name="l00521"></a><span class="lineno"> 521</span>  <a class="code" href="classOption.html">Option<T></a> <span class="keyword">get</span>(<span class="keyword">const</span> std::string& <a class="code" href="namespaceos_1_1Shell.html#acfe16ef2b1146ad49a8651c0a457ce46">name</a>) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00522"></a><span class="lineno"> 522</span> </div> +<div class="line"><a name="l00523"></a><span class="lineno"> 523</span>  <span class="comment">// Get resources of the given name.</span></div> +<div class="line"><a name="l00524"></a><span class="lineno"> 524</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <span class="keyword">get</span>(<span class="keyword">const</span> std::string& <a class="code" href="namespaceos_1_1Shell.html#acfe16ef2b1146ad49a8651c0a457ce46">name</a>) <span class="keyword">const</span>;</div> +<div class="line"><a name="l00525"></a><span class="lineno"> 525</span> </div> +<div class="line"><a name="l00526"></a><span class="lineno"> 526</span>  <span class="comment">// Get all the resources that are scalars.</span></div> +<div class="line"><a name="l00527"></a><span class="lineno"> 527</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a19c38bf426688c0fb1fcc5552b29a729">scalars</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00528"></a><span class="lineno"> 528</span> </div> +<div class="line"><a name="l00529"></a><span class="lineno"> 529</span>  <span class="comment">// Get the set of unique resource names.</span></div> +<div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  std::set<std::string> <a class="code" href="classmesos_1_1Resources.html#a376ffdcf83696b9a957b8a24ce596649">names</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00531"></a><span class="lineno"> 531</span> </div> +<div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  <span class="comment">// Get the types of resources associated with each resource name.</span></div> +<div class="line"><a name="l00533"></a><span class="lineno"> 533</span>  <span class="comment">// NOTE: Resources of the same name must have the same type, as</span></div> +<div class="line"><a name="l00534"></a><span class="lineno"> 534</span>  <span class="comment">// enforced by Resources::parse().</span></div> +<div class="line"><a name="l00535"></a><span class="lineno"> 535</span>  std::map<std::string, Value_Type> <a class="code" href="classmesos_1_1Resources.html#a6c4d4a889c254fb4241644c6557d511e">types</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00536"></a><span class="lineno"> 536</span> </div> +<div class="line"><a name="l00537"></a><span class="lineno"> 537</span>  <span class="comment">// Helpers to get known resource types.</span></div> +<div class="line"><a name="l00538"></a><span class="lineno"> 538</span>  <span class="comment">// TODO(vinod): Fix this when we make these types as first class</span></div> +<div class="line"><a name="l00539"></a><span class="lineno"> 539</span>  <span class="comment">// protobufs.</span></div> +<div class="line"><a name="l00540"></a><span class="lineno"> 540</span>  <a class="code" href="classOption.html">Option<double></a> <a class="code" href="classmesos_1_1Resources.html#a127e7442993f5b86d03625c4ab1e8271">cpus</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00541"></a><span class="lineno"> 541</span>  <a class="code" href="classOption.html">Option<double></a> <a class="code" href="classmesos_1_1Resources.html#ab7efb90fdd329ee238af86013584480d">gpus</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00542"></a><span class="lineno"> 542</span>  <a class="code" href="classOption.html">Option<Bytes></a> <a class="code" href="classmesos_1_1Resources.html#afdf2dfb4dd2c53acf5cd96bb6f02140c">mem</a>() <span class="keyword">const</span>;</div> +<div class="line"><a name="l00543"></a><span class="lineno"> 543</span>  <a class="code" href="classOption.html">Option<Bytes></a> <a class="code" href="classmesos_1_1Resources.html#a25edbf9ca3dc21aec283b25e48308794">disk</a>() <span class="keyword">const</span>;</div> <div class="line"><a name="l00544"></a><span class="lineno"> 544</span> </div> -<div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  <span class="comment">// NOTE: Non-`const` `iterator`, `begin()` and `end()` are __intentionally__</span></div> -<div class="line"><a name="l00546"></a><span class="lineno"> 546</span>  <span class="comment">// defined with `const` semantics in order to prevent mutable access to the</span></div> -<div class="line"><a name="l00547"></a><span class="lineno"> 547</span>  <span class="comment">// `Resource` objects within `resources`.</span></div> -<div class="line"><a name="l00548"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a2f4bcc0de9f40c0c947d355213aaac95"> 548</a></span>  <span class="keyword">typedef</span> std::vector<Resource_>::const_iterator <a class="code" href="classmesos_1_1Resources.html#a2f4bcc0de9f40c0c947d355213aaac95">iterator</a>;</div> -<div class="line"><a name="l00549"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#aead097c9cbf735bed75199745625d768"> 549</a></span>  <span class="keyword">typedef</span> std::vector<Resource_>::const_iterator <a class="code" href="classmesos_1_1Resources.html#aead097c9cbf735bed75199745625d768">const_iterator</a>;</div> -<div class="line"><a name="l00550"></a><span class="lineno"> 550</span> </div> -<div class="line"><a name="l00551"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a62a685bb22d0916e15e019602a36659f"> 551</a></span>  <a class="code" href="classmesos_1_1Resources.html#aead097c9cbf735bed75199745625d768">const_iterator</a> <a class="code" href="classmesos_1_1Resources.html#a62a685bb22d0916e15e019602a36659f">begin</a>()</div> -<div class="line"><a name="l00552"></a><span class="lineno"> 552</span>  {</div> -<div class="line"><a name="l00553"></a><span class="lineno"> 553</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast<</span><span class="keyword">const </span>std::vector<Resource_>&<span class="keyword">></span>(resources).<a class="code" href="classmesos_1_1Resources.html#a62a685bb22d0916e15e019602a36659f">begin</a>();</div> -<div class="line"><a name="l00554"></a><span class="lineno"> 554</span>  }</div> -<div class="line"><a name="l00555"></a><span class="lineno"> 555</span> </div> -<div class="line"><a name="l00556"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a07ff5813b931a26510a3343cb0c988e1"> 556</a></span>  <a class="code" href="classmesos_1_1Resources.html#aead097c9cbf735bed75199745625d768">const_iterator</a> <a class="code" href="classmesos_1_1Resources.html#a07ff5813b931a26510a3343cb0c988e1">end</a>()</div> -<div class="line"><a name="l00557"></a><span class="lineno"> 557</span>  {</div> -<div class="line"><a name="l00558"></a><span class="lineno"> 558</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast<</span><span class="keyword">const </span>std::vector<Resource_>&<span class="keyword">></span>(resources).<a class="code" href="classmesos_1_1Resources.html#a07ff5813b931a26510a3343cb0c988e1">end</a>();</div> -<div class="line"><a name="l00559"></a><span class="lineno"> 559</span>  }</div> -<div class="line"><a name="l00560"></a><span class="lineno"> 560</span> </div> -<div class="line"><a name="l00561"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#ae66c01db87b2a42cfee3e77c20687d56"> 561</a></span>  <a class="code" href="classmesos_1_1Resources.html#aead097c9cbf735bed75199745625d768">const_iterator</a> <a class="code" href="classmesos_1_1Resources.html#ae66c01db87b2a42cfee3e77c20687d56">begin</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> resources.begin(); }</div> -<div class="line"><a name="l00562"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a09242ab54ec91f74c67b67c7ab44036f"> 562</a></span>  <a class="code" href="classmesos_1_1Resources.html#aead097c9cbf735bed75199745625d768">const_iterator</a> <a class="code" href="classmesos_1_1Resources.html#a09242ab54ec91f74c67b67c7ab44036f">end</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> resources.end(); }</div> -<div class="line"><a name="l00563"></a><span class="lineno"> 563</span> </div> -<div class="line"><a name="l00564"></a><span class="lineno"> 564</span>  <span class="comment">// Using this operator makes it easy to copy a resources object into</span></div> -<div class="line"><a name="l00565"></a><span class="lineno"> 565</span>  <span class="comment">// a protocol buffer field.</span></div> -<div class="line"><a name="l00566"></a><span class="lineno"> 566</span>  <span class="comment">// Note that the google::protobuf::RepeatedPtrField<Resource> is</span></div> -<div class="line"><a name="l00567"></a><span class="lineno"> 567</span>  <span class="comment">// generated at runtime.</span></div> -<div class="line"><a name="l00568"></a><span class="lineno"> 568</span>  <span class="keyword">operator</span> google::protobuf::RepeatedPtrField<Resource>() <span class="keyword">const</span>;</div> -<div class="line"><a name="l00569"></a><span class="lineno"> 569</span> </div> -<div class="line"><a name="l00570"></a><span class="lineno"> 570</span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#ab5afedf0ab457c9298c251ca1ad0ce20">operator==</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00571"></a><span class="lineno"> 571</span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#ac992e85d674e3a1346dcce492f766588">operator!=</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00572"></a><span class="lineno"> 572</span> </div> -<div class="line"><a name="l00573"></a><span class="lineno"> 573</span>  <span class="comment">// NOTE: If any error occurs (e.g., input Resource is not valid or</span></div> -<div class="line"><a name="l00574"></a><span class="lineno"> 574</span>  <span class="comment">// the first operand is not a superset of the second operand while</span></div> -<div class="line"><a name="l00575"></a><span class="lineno"> 575</span>  <span class="comment">// doing subtraction), the semantics is as though the second operand</span></div> -<div class="line"><a name="l00576"></a><span class="lineno"> 576</span>  <span class="comment">// was actually just an empty resource (as though you didn't do the</span></div> -<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>  <span class="comment">// operation at all).</span></div> -<div class="line"><a name="l00578"></a><span class="lineno"> 578</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a1bb96b91999835ce867a3a895bd7bd08">operator+</a>(<span class="keyword">const</span> Resource& that) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00579"></a><span class="lineno"> 579</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a1bb96b91999835ce867a3a895bd7bd08">operator+</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00580"></a><span class="lineno"> 580</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1Resources.html#a5e73184e5fd1818ec189fe5f7d432b25">operator+=</a>(<span class="keyword">const</span> Resource& that);</div> -<div class="line"><a name="l00581"></a><span class="lineno"> 581</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1Resources.html#a5e73184e5fd1818ec189fe5f7d432b25">operator+=</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that);</div> -<div class="line"><a name="l00582"></a><span class="lineno"> 582</span> </div> -<div class="line"><a name="l00583"></a><span class="lineno"> 583</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a2233c5eae93c7bd8629495f19346575e">operator-</a>(<span class="keyword">const</span> Resource& that) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00584"></a><span class="lineno"> 584</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a2233c5eae93c7bd8629495f19346575e">operator-</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00585"></a><span class="lineno"> 585</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1Resources.html#ad23628d37ce9834684a0873de2ff2cfd">operator-=</a>(<span class="keyword">const</span> Resource& that);</div> -<div class="line"><a name="l00586"></a><span class="lineno"> 586</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1Resources.html#ad23628d37ce9834684a0873de2ff2cfd">operator-=</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that);</div> -<div class="line"><a name="l00587"></a><span class="lineno"> 587</span> </div> -<div class="line"><a name="l00588"></a><span class="lineno"> 588</span>  <span class="keyword">friend</span> std::ostream& <a class="code" href="classmesos_1_1Resources.html#ae280811800456648b43c902fa7a42d46">operator<<</a>(</div> -<div class="line"><a name="l00589"></a><span class="lineno"> 589</span>  std::ostream& stream, <span class="keyword">const</span> Resource_& resource_);</div> -<div class="line"><a name="l00590"></a><span class="lineno"> 590</span> </div> -<div class="line"><a name="l00591"></a><span class="lineno"> 591</span> <span class="keyword">private</span>:</div> -<div class="line"><a name="l00592"></a><span class="lineno"> 592</span>  <span class="comment">// Similar to 'contains(const Resource&)' but skips the validity</span></div> -<div class="line"><a name="l00593"></a><span class="lineno"> 593</span>  <span class="comment">// check. This can be used to avoid the performance overhead of</span></div> -<div class="line"><a name="l00594"></a><span class="lineno"> 594</span>  <span class="comment">// calling 'contains(const Resource&)' when the resource can be</span></div> -<div class="line"><a name="l00595"></a><span class="lineno"> 595</span>  <span class="comment">// assumed valid (e.g. it's inside a Resources).</span></div> -<div class="line"><a name="l00596"></a><span class="lineno"> 596</span>  <span class="comment">//</span></div> -<div class="line"><a name="l00597"></a><span class="lineno"> 597</span>  <span class="comment">// TODO(jieyu): Measure performance overhead of validity check to</span></div> -<div class="line"><a name="l00598"></a><span class="lineno"> 598</span>  <span class="comment">// ensure this is warranted.</span></div> -<div class="line"><a name="l00599"></a><span class="lineno"> 599</span>  <span class="keywordtype">bool</span> _contains(<span class="keyword">const</span> Resource_& that) <span class="keyword">const</span>;</div> -<div class="line"><a name="l00600"></a><span class="lineno"> 600</span> </div> -<div class="line"><a name="l00601"></a><span class="lineno"> 601</span>  <span class="comment">// Similar to the public 'find', but only for a single Resource</span></div> -<div class="line"><a name="l00602"></a><span class="lineno"> 602</span>  <span class="comment">// object. The target resource may span multiple roles, so this</span></div> -<div class="line"><a name="l00603"></a><span class="lineno"> 603</span>  <span class="comment">// returns Resources.</span></div> -<div class="line"><a name="l00604"></a><span class="lineno"> 604</span>  <a class="code" href="classOption.html">Option<Resources></a> <a class="code" href="classmesos_1_1Resources.html#a531f3b2cf4318aa421a2c9a9134992d1">find</a>(<span class="keyword">const</span> Resource& targe
<TRUNCATED>
