http://git-wip-us.apache.org/repos/asf/mesos-site/blob/63030bf4/content/api/latest/c++/v1_2resources_8hpp_source.html ---------------------------------------------------------------------- diff --git a/content/api/latest/c++/v1_2resources_8hpp_source.html b/content/api/latest/c++/v1_2resources_8hpp_source.html index 924bd75..7618baa 100644 --- a/content/api/latest/c++/v1_2resources_8hpp_source.html +++ b/content/api/latest/c++/v1_2resources_8hpp_source.html @@ -285,402 +285,409 @@ <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_1v1_1_1Resources.html#a7ed33a126401a10668cb4194f158eda0">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_1v1_1_1Resources.html#acae32482500bf65bd41786fe07a480c9"> 349</a></span>  <span class="keyword">static</span> <a class="code" href="classmesos_1_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#acae32482500bf65bd41786fe07a480c9">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_1v1_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_1v1_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_1v1_1_1Resources.html#ad4403987b8e06ee32c8a8053b64e6210">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_1v1_1_1Resources.html#acae32482500bf65bd41786fe07a480c9"> 356</a></span>  <span class="keyword">static</span> <a class="code" href="classmesos_1_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#acae32482500bf65bd41786fe07a480c9">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_1v1_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_1v1_1_1Resources.html#afb96448b026e8b78e338cf82bfc47e7a"> 360</a></span>  <a class="code" href="classmesos_1_1v1_1_1Resources.html#afb96448b026e8b78e338cf82bfc47e7a">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_1v1_1_1Resources.html#afb96448b026e8b78e338cf82bfc47e7a">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_1v1_1_1Resources.html#afb96448b026e8b78e338cf82bfc47e7a">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_1v1_1_1Resources.html#afb96448b026e8b78e338cf82bfc47e7a">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_1v1_1_1Resources.html#a5770adc8a5ab3730cc3eb34656907828"> 371</a></span>  <a class="code" href="classmesos_1_1v1_1_1Resources.html#a5770adc8a5ab3730cc3eb34656907828">Resources</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html#a67c9b3a515ef7ca50599151b7039ff5f"> 373</a></span>  <a class="code" href="classmesos_1_1v1_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1v1_1_1Resources.html#a67c9b3a515ef7ca50599151b7039ff5f">operator=</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html#a78a139b6c5f9277afd1521a65deced5e"> 381</a></span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a78a139b6c5f9277afd1521a65deced5e">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_1v1_1_1Resources.html#af83efda9ce0e171eeebc0741c5b63a2f"> 383</a></span>  <span class="keywordtype">size_t</span> <a class="code" href="classmesos_1_1v1_1_1Resources.html#af83efda9ce0e171eeebc0741c5b63a2f">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_1v1_1_1Resources.html#acc7fd5ead44f48cc44ad2169b5d0b5c3">contains</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_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_1v1_1_1Resources.html#afb96448b026e8b78e338cf82bfc47e7a"> 367</a></span>  <a class="code" href="classmesos_1_1v1_1_1Resources.html#afb96448b026e8b78e338cf82bfc47e7a">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_1v1_1_1Resources.html#afb96448b026e8b78e338cf82bfc47e7a">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_1v1_1_1Resources.html#afb96448b026e8b78e338cf82bfc47e7a">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_1v1_1_1Resources.html#afb96448b026e8b78e338cf82bfc47e7a">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_1v1_1_1Resources.html#a5770adc8a5ab3730cc3eb34656907828"> 378</a></span>  <a class="code" href="classmesos_1_1v1_1_1Resources.html#a5770adc8a5ab3730cc3eb34656907828">Resources</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html#a67c9b3a515ef7ca50599151b7039ff5f"> 380</a></span>  <a class="code" href="classmesos_1_1v1_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1v1_1_1Resources.html#a67c9b3a515ef7ca50599151b7039ff5f">operator=</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html#acc7fd5ead44f48cc44ad2169b5d0b5c3">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_1v1_1_1Resources.html#ad0b18d1969e50825f07aa3165875114e">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_1v1_1_1Resources.html#a34e9581de822e7174764be420ae6b967">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_1v1_1_1Resources.html#ac258ec47ef7d83bff7c52b2958608144">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a955c4d70ae7a7d1736a5af78b8365483">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_1v1_1_1Resources.html#a78a139b6c5f9277afd1521a65deced5e"> 388</a></span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a78a139b6c5f9277afd1521a65deced5e">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_1v1_1_1Resources.html#af83efda9ce0e171eeebc0741c5b63a2f"> 390</a></span>  <span class="keywordtype">size_t</span> <a class="code" href="classmesos_1_1v1_1_1Resources.html#af83efda9ce0e171eeebc0741c5b63a2f">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_1v1_1_1Resources.html#acc7fd5ead44f48cc44ad2169b5d0b5c3">contains</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html#acc7fd5ead44f48cc44ad2169b5d0b5c3">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_1v1_1_1Resources.html#ad0b18d1969e50825f07aa3165875114e">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_1v1_1_1Resources.html#a34e9581de822e7174764be420ae6b967">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_1v1_1_1Resources.html#a9d1776e435ec2e0bac48940f5d914ba2">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_1v1_1_1Resources.html#ac258ec47ef7d83bff7c52b2958608144">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a88bae7db4074589b0afcb756988be4f3">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a7bca1de6b4fcec3226d5ccc9cfb31d9e">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#ad49e676c9316fb456bf65516acb7c12d">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a955c4d70ae7a7d1736a5af78b8365483">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_1v1_1_1Resources.html#a9d1776e435ec2e0bac48940f5d914ba2">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a88bae7db4074589b0afcb756988be4f3">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#ac3cad813bf9a2979ad6dadb7f97bf45d">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a857302e3f08273a1ecee3395b437a965">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#afb2bb04c8e2228bc6d2e719bc13f9ac4">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a447b9a41f495889f1594bee5ebaf2d7a">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a9c81a237d913519f4b57f0709a93f650">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_1v1_1_1Resources.html#a544637fcc74401de333f75847632cc84">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a7bca1de6b4fcec3226d5ccc9cfb31d9e">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#ad49e676c9316fb456bf65516acb7c12d">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#ac3cad813bf9a2979ad6dadb7f97bf45d">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a857302e3f08273a1ecee3395b437a965">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#afb2bb04c8e2228bc6d2e719bc13f9ac4">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a447b9a41f495889f1594bee5ebaf2d7a">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#aec71b094a81644772eef454e8528f525">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a1be5df93f5ce1404c452bf0798af9967">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#af2b346b0ffb0ced0b18fc532ad1337d1">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a9c81a237d913519f4b57f0709a93f650">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_1v1_1_1Resources.html#a544637fcc74401de333f75847632cc84">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#aec71b094a81644772eef454e8528f525">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#ad2463a919987151047b605127a269e84">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_1v1_1_1Resources.html#a4bbeff06f7c6197ac143c6ace4311dc6">find</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html#a0f71adb1a8e92b4ab774355b10814717">apply</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html#a0f71adb1a8e92b4ab774355b10814717">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a1be5df93f5ce1404c452bf0798af9967">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#af2b346b0ffb0ced0b18fc532ad1337d1">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#ad2463a919987151047b605127a269e84">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_1v1_1_1Resources.html#a4bbeff06f7c6197ac143c6ace4311dc6">find</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html#a0f71adb1a8e92b4ab774355b10814717">apply</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html#a0eefe6f6c51e2af7fd680c3ed964dd6c"> 496</a></span>  <a class="code" href="classTry.html">Try<Resources></a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a0eefe6f6c51e2af7fd680c3ed964dd6c">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_1v1_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_1v1_1_1Resources.html#a0f71adb1a8e92b4ab774355b10814717">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_1v1_1_1Resources.html#a0f71adb1a8e92b4ab774355b10814717">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_1v1_1_1Resources.html#a0eefe6f6c51e2af7fd680c3ed964dd6c"> 503</a></span>  <a class="code" href="classTry.html">Try<Resources></a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a0eefe6f6c51e2af7fd680c3ed964dd6c">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_1v1_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_1v1_1_1Resources.html#a0f71adb1a8e92b4ab774355b10814717">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_1v1_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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a3ec21b3576457f38ba16292911ba60f0">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_1v1_1_1Resources.html#a8343b7e589b8499454edddf2aa95c76d">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_1v1_1_1Resources.html#afa01ce0359a9cd00f40753663f410b50">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_1v1_1_1Resources.html#a388bf0a6e067a2e29e6c02ddc8bd5f30">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_1v1_1_1Resources.html#a77bd749c9b8e90069b6aff41d617eb9c">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_1v1_1_1Resources.html#a20817b376bd759e713332344155fbb18">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_1v1_1_1Resources.html#a29248d8759863c4544ce372fef0b02c8">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_1v1_1_1Resources.html#a1ab96be4f854c93afefaa62802d46f0b">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_1v1_1_1Resources.html#a9b94e2fb14582077866ba77852645134">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_1v1_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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a3ec21b3576457f38ba16292911ba60f0">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_1v1_1_1Resources.html#a8343b7e589b8499454edddf2aa95c76d">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_1v1_1_1Resources.html#afa01ce0359a9cd00f40753663f410b50">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_1v1_1_1Resources.html#a388bf0a6e067a2e29e6c02ddc8bd5f30">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_1v1_1_1Resources.html#a77bd749c9b8e90069b6aff41d617eb9c">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_1v1_1_1Resources.html#a20817b376bd759e713332344155fbb18">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_1v1_1_1Resources.html#a29248d8759863c4544ce372fef0b02c8">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_1v1_1_1Resources.html#a7d595dbb779360ef854351a0b6d8095e"> 548</a></span>  <span class="keyword">typedef</span> std::vector<Resource_>::const_iterator <a class="code" href="classmesos_1_1v1_1_1Resources.html#a7d595dbb779360ef854351a0b6d8095e">iterator</a>;</div> -<div class="line"><a name="l00549"></a><span class="lineno"><a class="line" href="classmesos_1_1v1_1_1Resources.html#afd9c90fbd4faa76f9c83954ed8f4dc96"> 549</a></span>  <span class="keyword">typedef</span> std::vector<Resource_>::const_iterator <a class="code" href="classmesos_1_1v1_1_1Resources.html#afd9c90fbd4faa76f9c83954ed8f4dc96">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_1v1_1_1Resources.html#a9b8e38da3ee3aafcb83a1ec847e1a8e5"> 551</a></span>  <a class="code" href="classmesos_1_1v1_1_1Resources.html#afd9c90fbd4faa76f9c83954ed8f4dc96">const_iterator</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a9b8e38da3ee3aafcb83a1ec847e1a8e5">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_1v1_1_1Resources.html#a9b8e38da3ee3aafcb83a1ec847e1a8e5">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_1v1_1_1Resources.html#ae6ae804b1d0941acb28f99e020bdda10"> 556</a></span>  <a class="code" href="classmesos_1_1v1_1_1Resources.html#afd9c90fbd4faa76f9c83954ed8f4dc96">const_iterator</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#ae6ae804b1d0941acb28f99e020bdda10">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_1v1_1_1Resources.html#ae6ae804b1d0941acb28f99e020bdda10">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_1v1_1_1Resources.html#ac9cc77a6d6ecd961c5ba8e1b77890118"> 561</a></span>  <a class="code" href="classmesos_1_1v1_1_1Resources.html#afd9c90fbd4faa76f9c83954ed8f4dc96">const_iterator</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#ac9cc77a6d6ecd961c5ba8e1b77890118">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_1v1_1_1Resources.html#ac2d4dfbb981af8a9faa9acc09b50a674"> 562</a></span>  <a class="code" href="classmesos_1_1v1_1_1Resources.html#afd9c90fbd4faa76f9c83954ed8f4dc96">const_iterator</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#ac2d4dfbb981af8a9faa9acc09b50a674">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_1v1_1_1Resources.html#aebd5411e3ec8b4573de8e85e025178f1">operator==</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html#a5e80a4c0b065ceb6cd2f0d5445964213">operator!=</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#ad83dc3d47cc27f71b1a62fcc03ee4255">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#ad83dc3d47cc27f71b1a62fcc03ee4255">operator+</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1v1_1_1Resources.html#ad367ced251edfb414891e6c0d859f264">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_1v1_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1v1_1_1Resources.html#ad367ced251edfb414891e6c0d859f264">operator+=</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#af901f32a8e475d914eb8c82d4c3946f6">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_1v1_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1v1_1_1Resources.html#af901f32a8e475d914eb8c82d4c3946f6">operator-</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1v1_1_1Resources.html#ad31bd7470855a7691d10f0a4f73aa217">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_1v1_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1v1_1_1Resources.html#ad31bd7470855a7691d10f0a4f73aa217">operator-=</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1v1_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_1v1_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>  <sp
<TRUNCATED>
