You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by gi...@apache.org on 2018/06/21 17:37:44 UTC
[04/10] mesos-site git commit: Updated the website built from mesos
SHA: f0284a5.
http://git-wip-us.apache.org/repos/asf/mesos-site/blob/33e7b7a9/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 ed47c6b..7f57192 100644
--- a/content/api/latest/c++/resources_8hpp_source.html
+++ b/content/api/latest/c++/resources_8hpp_source.html
@@ -52,19 +52,19 @@
<div class="title">resources.hpp</div> </div>
</div><!--header-->
<div class="contents">
-<a href="resources_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">// Licensed to the Apache Software Foundation (ASF) under one</span></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment">// or more contributor license agreements. See the NOTICE file</span></div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment">// distributed with this work for additional information</span></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment">// regarding copyright ownership. The ASF licenses this file</span></div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment">// to you under the Apache License, Version 2.0 (the</span></div><div class="line"><a name="l00006"></a><span c
lass="lineno"> 6</span> <span class="comment">// "License"); you may not use this file except in compliance</span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment">// with the License. You may obtain a copy of the License at</span></div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment">//</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment">// http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment">//</span></div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment">// Unless required by applicable law or agreed to in writing, software</span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment">// distrib
uted under the License is distributed on an "AS IS" BASIS,</span></div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment">// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment">// See the License for the specific language governing permissions and</span></div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment">// limitations under the License.</span></div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> </div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="preprocessor">#ifndef __RESOURCES_HPP__</span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="preprocessor">#define __RESOURCES_HPP__</span></div><div class="line"><a name="l0
0019"></a><span class="lineno"> 19</span> </div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="preprocessor">#include <map></span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="preprocessor">#include <iosfwd></span></div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="preprocessor">#include <set></span></div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="preprocessor">#include <string></span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <vector></span></div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> </div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#include <google/protobuf/repeated_field.h></spa
n></div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> </div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#include <<a class="code" href="include_2mesos_2mesos_8hpp.html">mesos/mesos.hpp</a>></span></div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include <<a class="code" href="type__utils_8hpp.html">mesos/type_utils.hpp</a>></span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#include <<a class="code" href="include_2mesos_2values_8hpp.html">mesos/values.hpp</a>></span></div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> </div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include <<a class="code" href="bytes_8hpp.html">stout/bytes.hpp</a>></span></div><div
class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <<a class="code" href="stout_2include_2stout_2check_8hpp.html">stout/check.hpp</a>></span></div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#include <<a class="code" href="error_8hpp.html">stout/error.hpp</a>></span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">#include <<a class="code" href="foreach_8hpp.html">stout/foreach.hpp</a>></span></div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor">#include <<a class="code" href="hashmap_8hpp.html">stout/hashmap.hpp</a>></span></div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor">#include <<a class="code" href="json_8hpp.html">stout/json.hpp</a>></span></div><div cl
ass="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="preprocessor">#include <<a class="code" href="lambda_8hpp.html">stout/lambda.hpp</a>></span></div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="preprocessor">#include <<a class="code" href="nothing_8hpp.html">stout/nothing.hpp</a>></span></div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="preprocessor">#include <<a class="code" href="option_8hpp.html">stout/option.hpp</a>></span></div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="preprocessor">#include <<a class="code" href="try_8hpp.html">stout/try.hpp</a>></span></div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> </div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span> </div><div class="line"><a name="l00044"></a><span class="lineno">
44</span> <span class="comment">// Resources come in three types: scalar, ranges, and sets. These are</span></div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">// represented using protocol buffers. To make manipulation of</span></div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">// resources easier within the Mesos core and for scheduler writers,</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// we provide generic overloaded operators (see below) as well as a</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// general Resources class that encapsulates a collection of protocol</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">// buffer Resource objects. The Resources class also prov
ides a few</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">// static routines to allow parsing resources (e.g., from the command</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment">// line), as well as determining whether or not a Resource object is</span></div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// valid. Note that many of these operations have not been optimized</span></div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment">// but instead just written for correct semantics.</span></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> </div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="keyword">namespace </span><a class="code" href="namespacemesos.html">mesos</a> {</div><div c
lass="line"><a name="l00056"></a><span class="lineno"> 56</span> </div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment">// Forward declaration.</span></div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="keyword">class </span>ResourceConversion;</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span> </div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span> </div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="comment">// Helper functions.</span></div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="keywordtype">bool</span> <a class="code" href="namespacemesos.html#a112163aa7f26794e26b67dfc187dec7f">operator==</a>(</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  <span class="keyword">const</span> Resource::Res
ervationInfo& left,</div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  <span class="keyword">const</span> Resource::ReservationInfo& right);</div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span> </div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span> </div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span> <span class="keywordtype">bool</span> <a class="code" href="namespacemesos.html#a2a06d7d7b236205c27898eaeadc8af50">operator!=</a>(</div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  <span class="keyword">const</span> Resource::ReservationInfo& left,</div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  <span class="keyword">const</span> Resource::ReservationInfo& right);</div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span> </div><div class="line"><a
name="l00071"></a><span class="lineno"> 71</span> </div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="comment">// NOTE: Resource objects stored in the class are always valid, are in</span></div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="comment">// the "post-reservation-refinement" format, and kept combined if possible.</span></div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="comment">// It is the caller's responsibility to validate any Resource object or</span></div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span> <span class="comment">// repeated Resource protobufs before constructing a Resources object.</span></div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="comment">// Otherwise, invalid Resource objects will be silently stripped.</span></div><div
class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="comment">// Invalid Resource objects will also be silently ignored when used in</span></div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span> <span class="comment">// arithmetic operations (e.g., +=, -=, etc.).</span></div><div class="line"><a name="l00079"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html"> 79</a></span> <span class="keyword">class </span><a class="code" href="classmesos_1_1Resources.html">Resources</a></div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span> {</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span> <span class="keyword">private</span>:</div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  <span class="comment">// An internal abstraction to facilitate managing shared resources.</span></div><div class="line"><a name="l000
83"></a><span class="lineno"> 83</span>  <span class="comment">// It allows 'Resources' to group identical shared resource objects</span></div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  <span class="comment">// together into a single 'Resource_' object and tracked by its internal</span></div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  <span class="comment">// counter. Non-shared resource objects are not grouped.</span></div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span>  <span class="comment">//</span></div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  <span class="comment">// The rest of the private section is below the public section. We</span></div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="comment">// need to define Resource_ first because the public typedefs below</spa
n></div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  <span class="comment">// depend on it.</span></div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  <span class="keyword">class </span>Resource_</div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  {</div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  <span class="keyword">public</span>:</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  <span class="comment">/*implicit*/</span> Resource_(<span class="keyword">const</span> Resource& _resource)</div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  : resource(_resource),</div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  sharedCount(<a class="code" href="structNone.html">None</a>())</div><div class="line"><a name="l00096"></a><span class="li
neno"> 96</span>  {</div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  <span class="comment">// Setting the counter to 1 to denote "one copy" of the shared resource.</span></div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  <span class="keywordflow">if</span> (resource.has_shared()) {</div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  sharedCount = 1;</div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  }</div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  }</div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span> </div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  <span class="comment">// By implicitly converting to Resource we are able to keep Resource_</span></div><div class="line"><a name="l00104"></a><span class="
lineno"> 104</span>  <span class="comment">// logic internal and expose only the protobuf object.</span></div><div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  <span class="keyword">operator</span> <span class="keyword">const</span> Resource&() <span class="keyword">const</span> { <span class="keywordflow">return</span> resource; }</div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span> </div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <span class="comment">// Check whether this Resource_ object corresponds to a shared resource.</span></div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#a2543b70428e6d4546271615fc013776e">isShared</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> sharedCount.isSome(); }</div><div class="l
ine"><a name="l00109"></a><span class="lineno"> 109</span> </div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  <span class="comment">// Validates this Resource_ object.</span></div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  <a class="code" href="classOption.html">Option<Error></a> <a class="code" href="classmesos_1_1Resources.html#a14d213399957d701bc065e66e8881e39">validate</a>() <span class="keyword">const</span>;</div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span> </div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  <span class="comment">// Check whether this Resource_ object is empty.</span></div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#af80276e0925e9e48dbf816aae62a2bb8">isEmpty</a>() <span class="keyw
ord">const</span>;</div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span> </div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  <span class="comment">// The `Resource_` arithmetic, comparison operators and `contains()`</span></div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  <span class="comment">// method require the wrapped `resource` protobuf to have the same</span></div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span>  <span class="comment">// sharedness.</span></div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  <span class="comment">//</span></div><div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  <span class="comment">// For shared resources, the `resource` protobuf needs to be equal,</span></div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  <span
class="comment">// and only the shared counters are adjusted or compared.</span></div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  <span class="comment">// For non-shared resources, the shared counters are none and the</span></div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <span class="comment">// semantics of the Resource_ object's operators/contains() method</span></div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <span class="comment">// are the same as those of the Resource objects.</span></div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span> </div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  <span class="comment">// Checks if this Resource_ is a superset of the given Resource_.</span></div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  <span class="keywordtype">b
ool</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="l00128"></a><span class="lineno"> 128</span> </div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  <span class="comment">// The arithmetic operators, viz. += and -= assume that the corresponding</span></div><div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  <span class="comment">// Resource objects are addable or subtractable already.</span></div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  Resource_& <a class="code" href="classmesos_1_1Resources.html#a5e73184e5fd1818ec189fe5f7d432b25">operator+=</a>(<span class="keyword">const</span> Resource_& that);</div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  R
esource_& <a class="code" href="classmesos_1_1Resources.html#ad23628d37ce9834684a0873de2ff2cfd">operator-=</a>(<span class="keyword">const</span> Resource_& that);</div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span> </div><div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#ab5afedf0ab457c9298c251ca1ad0ce20">operator==</a>(<span class="keyword">const</span> Resource_& that) <span class="keyword">const</span>;</div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#ac992e85d674e3a1346dcce492f766588">operator!=</a>(<span class="keyword">const</span> Resource_& that) <span class="keyword">const</span>;</div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span> </div><div class="line
"><a name="l00137"></a><span class="lineno"> 137</span>  <span class="comment">// Friend classes and functions for access to private members.</span></div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classmesos_1_1Resources.html">Resources</a>;</div><div class="line"><a name="l00139"></a><span class="lineno"> 139</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="l00140"></a><span class="lineno"> 140</span>  std::ostream& stream, <span class="keyword">const</span> Resource_& resource_);</div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span> </div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  <span class="keyw
ord">private</span>:</div><div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  <span class="comment">// The protobuf Resource that is being managed.</span></div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  Resource resource;</div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span> </div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  <span class="comment">// The counter for grouping shared 'resource' objects, None if the</span></div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="comment">// 'resource' is non-shared. This is an int so as to support arithmetic</span></div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span>  <span class="comment">// operations involving subtraction.</span></div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span> 
; <a class="code" href="classOption.html">Option<int></a> sharedCount;</div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span>  };</div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span> </div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span> <span class="keyword">public</span>:</div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span>  <span class="keyword">static</span> <a class="code" href="classTry.html">Try<Resource></a> <a class="code" href="classmesos_1_1Resources.html#a6603b57f6aa4c3c4eb4ea73f88498f99">parse</a>(</div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  <span class="keyword">const</span> std::string& <a class="code" href="namespaceos_1_1Shell.html#acfe16ef2b1146ad49a8651c0a457ce46">name</a>,</div><div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <span class="keyword">c
onst</span> std::string& value,</div><div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  <span class="keyword">const</span> std::string& role);</div><div class="line"><a name="l00169"></a><span class="lineno"> 169</span> </div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  <span class="keyword">static</span> <a class="code" href="classTry.html">Try<Resources></a> <a class="code" href="classmesos_1_1Resources.html#a6603b57f6aa4c3c4eb4ea73f88498f99">parse</a>(</div><div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  <span class="keyword">const</span> std::string& text,</div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  <span class="keyword">const</span> std::string& defaultRole = <span class="stringliteral">"*"</span>);</div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span> </div><div cl
ass="line"><a name="l00207"></a><span class="lineno"> 207</span>  <span class="keyword">static</span> <a class="code" href="classTry.html">Try<std::vector<Resource></a>> <a class="code" href="classmesos_1_1Resources.html#ab3a8fed18db7526324f86902a142bbdd">fromJSON</a>(</div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span>  <span class="keyword">const</span> <a class="code" href="structJSON_1_1Array.html">JSON::Array</a>& resourcesJSON,</div><div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <span class="keyword">const</span> std::string& defaultRole = <span class="stringliteral">"*"</span>);</div><div class="line"><a name="l00210"></a><span class="lineno"> 210</span> </div><div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  <span class="keyword">static</span> <a class="code" href="classTry.html">Try<std::vector<Resource></a>> <a class=
"code" href="classmesos_1_1Resources.html#aa25b97988dd7fdaffdf1f6024a1d71a9">fromSimpleString</a>(</div><div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  <span class="keyword">const</span> std::string& text,</div><div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  <span class="keyword">const</span> std::string& defaultRole = <span class="stringliteral">"*"</span>);</div><div class="line"><a name="l00231"></a><span class="lineno"> 231</span> </div><div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  <span class="keyword">static</span> <a class="code" href="classTry.html">Try<std::vector<Resource></a>> <a class="code" href="classmesos_1_1Resources.html#afcb552571a61488ad12bb048ff16a56d">fromString</a>(</div><div class="line"><a name="l00245"></a><span class="lineno"> 245</span>  <span class="keyword">const</span> std::string& text,</div><div c
lass="line"><a name="l00246"></a><span class="lineno"> 246</span>  <span class="keyword">const</span> std::string& defaultRole = <span class="stringliteral">"*"</span>);</div><div class="line"><a name="l00247"></a><span class="lineno"> 247</span> </div><div class="line"><a name="l00260"></a><span class="lineno"> 260</span>  <span class="keyword">static</span> <a class="code" href="classOption.html">Option<Error></a> <a class="code" href="classmesos_1_1Resources.html#a14d213399957d701bc065e66e8881e39">validate</a>(<span class="keyword">const</span> Resource& resource);</div><div class="line"><a name="l00261"></a><span class="lineno"> 261</span> </div><div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  <span class="keyword">static</span> <a class="code" href="classOption.html">Option<Error></a> <a class="code" href="classmesos_1_1Resources.html#a14d213399957d701bc065e66e8881e39">validate</a>(</div>
<div class="line"><a name="l00280"></a><span class="lineno"> 280</span>  <span class="keyword">const</span> google::protobuf::RepeatedPtrField<Resource>& resources);</div><div class="line"><a name="l00281"></a><span class="lineno"> 281</span> </div><div class="line"><a name="l00282"></a><span class="lineno"> 282</span>  <span class="comment">// NOTE: The following predicate functions assume that the given resource is</span></div><div class="line"><a name="l00283"></a><span class="lineno"> 283</span>  <span class="comment">// validated, and is in the "post-reservation-refinement" format. That is,</span></div><div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  <span class="comment">// the reservation state is represented by `Resource.reservations` field,</span></div><div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  <span class="comment">// and `Resource.role` and `Resource.rese
rvation` fields are not set.</span></div><div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  <span class="comment">//</span></div><div class="line"><a name="l00287"></a><span class="lineno"> 287</span>  <span class="comment">// See 'Resource Format' section in `mesos.proto` for more details.</span></div><div class="line"><a name="l00288"></a><span class="lineno"> 288</span> </div><div class="line"><a name="l00289"></a><span class="lineno"> 289</span>  <span class="comment">// Tests if the given Resource object is empty.</span></div><div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#af80276e0925e9e48dbf816aae62a2bb8">isEmpty</a>(<span class="keyword">const</span> Resource& resource);</div><div class="line"><a name="l00291"></a><span class="lineno"> 291</span> </div><d
iv class="line"><a name="l00292"></a><span class="lineno"> 292</span>  <span class="comment">// Tests if the given Resource object is a persistent volume.</span></div><div class="line"><a name="l00293"></a><span class="lineno"> 293</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#a2854bcb8a35610e98a6ad0e559ea6213">isPersistentVolume</a>(<span class="keyword">const</span> Resource& resource);</div><div class="line"><a name="l00294"></a><span class="lineno"> 294</span> </div><div class="line"><a name="l00295"></a><span class="lineno"> 295</span>  <span class="comment">// Tests if the given Resource object is a disk of the specified type.</span></div><div class="line"><a name="l00296"></a><span class="lineno"> 296</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#ac122469e75b48787a955
348873218aeb">isDisk</a>(</div><div class="line"><a name="l00297"></a><span class="lineno"> 297</span>  <span class="keyword">const</span> Resource& resource,</div><div class="line"><a name="l00298"></a><span class="lineno"> 298</span>  <span class="keyword">const</span> <a class="code" href="namespacemesos_1_1internal_1_1capabilities.html#aaa5ec6d56ccbeba718b9e8fc6ec2f7c9">Resource::DiskInfo::Source::Type</a>& <a class="code" href="namespacemesos_1_1internal_1_1fs.html#a2343e2642db514496ba8380776487fba">type</a>);</div><div class="line"><a name="l00299"></a><span class="lineno"> 299</span> </div><div class="line"><a name="l00300"></a><span class="lineno"> 300</span>  <span class="comment">// Tests if the given Resource object is reserved. If the role is</span></div><div class="line"><a name="l00301"></a><span class="lineno"> 301</span>  <span class="comment">// specified, tests that it's reserved for the given role.</span></div>
<div class="line"><a name="l00302"></a><span class="lineno"> 302</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#adca79e207e34acac374fa48035ebfb55">isReserved</a>(</div><div class="line"><a name="l00303"></a><span class="lineno"> 303</span>  <span class="keyword">const</span> Resource& resource,</div><div class="line"><a name="l00304"></a><span class="lineno"> 304</span>  <span class="keyword">const</span> <a class="code" href="classOption.html">Option<std::string></a>& role = <a class="code" href="structNone.html">None</a>());</div><div class="line"><a name="l00305"></a><span class="lineno"> 305</span> </div><div class="line"><a name="l00306"></a><span class="lineno"> 306</span>  <span class="comment">// Tests if the given Resource object is allocatable to the given role.</span></div><div class="line"><a name="l00307"></a><span class="lineno">
307</span>  <span class="comment">// A resource object is allocatable to 'role' if:</span></div><div class="line"><a name="l00308"></a><span class="lineno"> 308</span>  <span class="comment">// * it is reserved to an ancestor of that role in the hierarchy, OR</span></div><div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  <span class="comment">// * it is reserved to 'role' itself, OR</span></div><div class="line"><a name="l00310"></a><span class="lineno"> 310</span>  <span class="comment">// * it is unreserved.</span></div><div class="line"><a name="l00311"></a><span class="lineno"> 311</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#a25673a3dfbad9b49fc7a67d6bab2494a">isAllocatableTo</a>(</div><div class="line"><a name="l00312"></a><span class="lineno"> 312</span>  <span class="keyword">const</span> Resource&am
p; resource,</div><div class="line"><a name="l00313"></a><span class="lineno"> 313</span>  <span class="keyword">const</span> std::string& role);</div><div class="line"><a name="l00314"></a><span class="lineno"> 314</span> </div><div class="line"><a name="l00315"></a><span class="lineno"> 315</span>  <span class="comment">// Tests if the given Resource object is unreserved.</span></div><div class="line"><a name="l00316"></a><span class="lineno"> 316</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#a342965af2e97bd1c5a78fbec5d9d65d8">isUnreserved</a>(<span class="keyword">const</span> Resource& resource);</div><div class="line"><a name="l00317"></a><span class="lineno"> 317</span> </div><div class="line"><a name="l00318"></a><span class="lineno"> 318</span>  <span class="comment">// Tests if the given Resource object is dynamically reserved.</span></d
iv><div class="line"><a name="l00319"></a><span class="lineno"> 319</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#a65426926427f541434634ab4b63597f5">isDynamicallyReserved</a>(<span class="keyword">const</span> Resource& resource);</div><div class="line"><a name="l00320"></a><span class="lineno"> 320</span> </div><div class="line"><a name="l00321"></a><span class="lineno"> 321</span>  <span class="comment">// Tests if the given Resource object is revocable.</span></div><div class="line"><a name="l00322"></a><span class="lineno"> 322</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#abb05dff78639303b244e9ffb0c765c14">isRevocable</a>(<span class="keyword">const</span> Resource& resource);</div><div class="line"><a name="l00323"></a><span class="lineno"> 323</span> </div><div cla
ss="line"><a name="l00324"></a><span class="lineno"> 324</span>  <span class="comment">// Tests if the given Resource object is shared.</span></div><div class="line"><a name="l00325"></a><span class="lineno"> 325</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#a2543b70428e6d4546271615fc013776e">isShared</a>(<span class="keyword">const</span> Resource& resource);</div><div class="line"><a name="l00326"></a><span class="lineno"> 326</span> </div><div class="line"><a name="l00327"></a><span class="lineno"> 327</span>  <span class="comment">// Tests if the given Resources object is a "pure" scalar quantity which</span></div><div class="line"><a name="l00328"></a><span class="lineno"> 328</span>  <span class="comment">// consists of resource objects with ONLY name, type (set to "Scalar")</span></div><div class="line"><a name="l00329"></a><span cla
ss="lineno"> 329</span>  <span class="comment">// and scalar fields set.</span></div><div class="line"><a name="l00330"></a><span class="lineno"> 330</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#a015aa5cbeb1f9bce6d50bf983b69b7c7">isScalarQuantity</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& resources);</div><div class="line"><a name="l00331"></a><span class="lineno"> 331</span> </div><div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  <span class="comment">// Tests if the given Resource object has refined reservations.</span></div><div class="line"><a name="l00333"></a><span class="lineno"> 333</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#aa68cbefaa4f5e4365783c370cd8dbc45">hasRefinedReservati
ons</a>(<span class="keyword">const</span> Resource& resource);</div><div class="line"><a name="l00334"></a><span class="lineno"> 334</span> </div><div class="line"><a name="l00335"></a><span class="lineno"> 335</span>  <span class="comment">// Tests if the given Resource object is provided by a resource provider.</span></div><div class="line"><a name="l00336"></a><span class="lineno"> 336</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1Resources.html#aa10cb7cd890230dabdd845ac17516ee6">hasResourceProvider</a>(<span class="keyword">const</span> Resource& resource);</div><div class="line"><a name="l00337"></a><span class="lineno"> 337</span> </div><div class="line"><a name="l00338"></a><span class="lineno"> 338</span>  <span class="comment">// Returns the role to which the given Resource object is reserved for.</span></div><div class="line"><a name="l00339"></a><span class="l
ineno"> 339</span>  <span class="comment">// This must be called only when the resource is reserved!</span></div><div class="line"><a name="l00340"></a><span class="lineno"> 340</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="l00341"></a><span class="lineno"> 341</span> </div><div class="line"><a name="l00342"></a><span class="lineno"> 342</span>  <span class="comment">// Shrinks a scalar type `resource` to the target size.</span></div><div class="line"><a name="l00343"></a><span class="lineno"> 343</span>  <span class="comment">// Returns true if the resource was shrunk to the target size,</span></div><div class="line"><a name="l00344"></a><span class="lineno"> 344</span>  <span class="comment">// or
the resource is already within the target size.</span></div><div class="line"><a name="l00345"></a><span class="lineno"> 345</span>  <span class="comment">// Returns false otherwise (i.e. the resource is indivisible.</span></div><div class="line"><a name="l00346"></a><span class="lineno"> 346</span>  <span class="comment">// E.g. MOUNT volume).</span></div><div class="line"><a name="l00347"></a><span class="lineno"> 347</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="l00348"></a><span class="lineno"> 348</span> </div><div class="line"><a name="l00349"></a><span class="lineno"> 349</span>  <span class="comment">// Returns the summed up Resources given a hashmap<Key, Resources>.</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">// NOTE: While scalar resources such as "cpus" sum correctly,</span></div><div class="line"><a name="l00352"></a><span class="lineno"> 352</span>  <span class="comment">// non-scalar resources such as "ports" do not.</span></div><div class="line"><a name="l00353"></a><span class="lineno"> 353</span>  <span class="comment">// e.g. "cpus:2" + "cpus:1" = "cpus:3"</span></div><div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  <span class="comment">// "ports:[0-100]" + "ports:[0-100]" = "ports:[0-100]"</span></div><div class="line"><a name="l00355"></a><span class="lineno"> 355</span>  <span class="comment">//</span></div><div class="line"><a name=
"l00356"></a><span class="lineno"> 356</span>  <span class="comment">// TODO(mpark): Deprecate this function once we introduce the</span></div><div class="line"><a name="l00357"></a><span class="lineno"> 357</span>  <span class="comment">// concept of "cluster-wide" resources which provides correct</span></div><div class="line"><a name="l00358"></a><span class="lineno"> 358</span>  <span class="comment">// semantics for summation over all types of resources. (e.g.</span></div><div class="line"><a name="l00359"></a><span class="lineno"> 359</span>  <span class="comment">// non-scalar)</span></div><div class="line"><a name="l00360"></a><span class="lineno"> 360</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> Key></div><div class="line"><a name="l00361"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a9753991686eca5e60ec5324a83535352"> 361</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="l00362"></a><span class="lineno"> 362</span>  {</div><div class="line"><a name="l00363"></a><span class="lineno"> 363</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> result;</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>  <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="l00366"></a>
<span class="lineno"> 366</span>  result += 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> </div><div class="line"><a name="l00369"></a><span class="lineno"> 369</span>  <span class="keywordflow">return</span> result;</div><div class="line"><a name="l00370"></a><span class="lineno"> 370</span>  }</div><div class="line"><a name="l00371"></a><span class="lineno"> 371</span> </div><div class="line"><a name="l00372"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#aed60247869278b5545227ddf7ca9536b"> 372</a></span>  <a class="code" href="classmesos_1_1Resources.html#aed60247869278b5545227ddf7ca9536b">Resources</a>() {}</div><div class="line"><a name="l00373"></a><span class="lineno"> 373</span> </div><div class="line"><a name="l00374"></a><span class="lineno"> 374</span>  <sp
an class="comment">// TODO(jieyu): Consider using C++11 initializer list.</span></div><div class="line"><a name="l00375"></a><span class="lineno"> 375</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="l00376"></a><span class="lineno"> 376</span> </div><div class="line"><a name="l00377"></a><span class="lineno"> 377</span>  <span class="comment">/*implicit*/</span></div><div class="line"><a name="l00378"></a><span class="lineno"> 378</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="l00379"></a><span class="lineno"> 379</span> </div><div class="line"><a name="l00380"></a><span class="lineno"> 3
80</span>  <span class="comment">/*implicit*/</span></div><div class="line"><a name="l00381"></a><span class="lineno"> 381</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="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#a54f4d215c4b8c70ecb9029c2103d3e86"> 383</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="l00384"></a><span class="lineno"> 384</span> </div><div class="line"><a name="l00385"></a><span class="lineno
"><a class="line" href="classmesos_1_1Resources.html#a44e5b29fbe67ba65c43a51331be2629b"> 385</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="l00386"></a><span class="lineno"> 386</span>  {</div><div class="line"><a name="l00387"></a><span class="lineno"> 387</span>  <span class="keywordflow">if</span> (<span class="keyword">this</span> != &that) {</div><div class="line"><a name="l00388"></a><span class="lineno"> 388</span>  resources = that.resources;</div><div class="line"><a name="l00389"></a><span class="lineno"> 389</span>  }</div><div class="line"><a name="l00390"></a><span class="lineno"> 390</span>  <span class="keywordflow">return</span> *<span c
lass="keyword">this</span>;</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> </div><div class="line"><a name="l00393"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#ab46b900ebe62b19390d9a2a82b46eb15"> 393</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.<a class="code" href="classmesos_1_1Resources.html#a941fe78c62de3a6fa7c7cf977960694a">size</a>() == 0; }</div><div class="line"><a name="l00394"></a><span class="lineno"> 394</span> </div><div class="line"><a name="l00395"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a941fe78c62de3a6fa7c7cf977960694a"> 395</a></span>  <span class="keywordtype">size_t</sp
an> <a class="code" href="classmesos_1_1Resources.html#a941fe78c62de3a6fa7c7cf977960694a">size</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> resources.<a class="code" href="classmesos_1_1Resources.html#a941fe78c62de3a6fa7c7cf977960694a">size</a>(); }</div><div class="line"><a name="l00396"></a><span class="lineno"> 396</span> </div><div class="line"><a name="l00397"></a><span class="lineno"> 397</span>  <span class="comment">// Checks if this Resources is a superset of the given Resources.</span></div><div class="line"><a name="l00398"></a><span class="lineno"> 398</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="l00399"></a><span class="lineno"> 399</spa
n> </div><div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  <span class="comment">// Checks if this Resources contains the given Resource.</span></div><div class="line"><a name="l00401"></a><span class="lineno"> 401</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="l00402"></a><span class="lineno"> 402</span> </div><div class="line"><a name="l00403"></a><span class="lineno"> 403</span>  <span class="comment">// Count the Resource objects that match the specified value.</span></div><div class="line"><a name="l00404"></a><span class="lineno"> 404</span>  <span class="comment">//</span></div><div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  <span class="comment">// NOTE:</span></div
><div class="line"><a name="l00406"></a><span class="lineno"> 406</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="l00407"></a><span class="lineno"> 407</span>  <span class="comment">// non-shared Resource objects in Resources are unique.</span></div><div class="line"><a name="l00408"></a><span class="lineno"> 408</span>  <span class="comment">// - For a shared resource the count can be greater than 1.</span></div><div class="line"><a name="l00409"></a><span class="lineno"> 409</span>  <span class="comment">// - If the resource is not in the Resources object, the count is 0.</span></div><div class="line"><a name="l00410"></a><span class="lineno"> 410</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="l00411"></a><span class="lineno"> 411</span> </div><div class="line"><a name="l00412"></a><span class="lineno"> 412</span>  <span class="comment">// Allocates the resources to the given role (by setting the</span></div><div class="line"><a name="l00413"></a><span class="lineno"> 413</span>  <span class="comment">// `AllocationInfo.role`). Any existing allocation will be</span></div><div class="line"><a name="l00414"></a><span class="lineno"> 414</span>  <span class="comment">// over-written.</span></div><div class="line"><a name="l00415"></a><span class="lineno"> 415</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="l00416"></a><span class="lineno"> 416</span> </div><div class="line"><a name="l00417"></a><
span class="lineno"> 417</span>  <span class="comment">// Unallocates the resources.</span></div><div class="line"><a name="l00418"></a><span class="lineno"> 418</span>  <span class="keywordtype">void</span> <a class="code" href="classmesos_1_1Resources.html#ae37d3b004781eb0f7b8d3676db9c6205">unallocate</a>();</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">// Filter resources based on the given predicate.</span></div><div class="line"><a name="l00421"></a><span class="lineno"> 421</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="l00422"></a><span class="lineno"> 422</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="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 reserved resources, by role.</span></div><div class="line"><a name="l00425"></a><span class="lineno"> 425</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="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 reserved resources for the role, if specified.</span></div><div class="line"><a name="l00428"></a><span class="lineno"> 428</
span>  <span class="comment">// Note that the "*" role represents unreserved resources,</span></div><div class="line"><a name="l00429"></a><span class="lineno"> 429</span>  <span class="comment">// and will be ignored.</span></div><div class="line"><a name="l00430"></a><span class="lineno"> 430</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="l00431"></a><span class="lineno"> 431</span> </div><div class="line"><a name="l00432"></a><span class="lineno"> 432</span>  <span class="comment">// Returns resources allocatable to role. See `isAllocatableTo` for the</span></div><div class="line"><
a name="l00433"></a><span class="lineno"> 433</span>  <span class="comment">// definition of 'allocatableTo'.</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#abe08f658e725b14aef800394d1b5f4a0">allocatableTo</a>(<span class="keyword">const</span> std::string& role) <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 unreserved 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#a643e177ab27dd9448ec1f3e8cbbc5634">unreserved</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 persistent volumes.</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#a1e0ae1441006e85f3f15ece5eb30d8dc">persistentVolumes</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 revocable resources.</span></div><div class="line"><a name="l00443"></a><span class="lineno"> 443</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#ab24fc44ad91b263500d27
36a54a9aea3">revocable</a>() <span class="keyword">const</span>;</div><div class="line"><a name="l00444"></a><span class="lineno"> 444</span> </div><div class="line"><a name="l00445"></a><span class="lineno"> 445</span>  <span class="comment">// Returns the non-revocable resources, effectively !revocable().</span></div><div class="line"><a name="l00446"></a><span class="lineno"> 446</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="l00447"></a><span class="lineno"> 447</span> </div><div class="line"><a name="l00448"></a><span class="lineno"> 448</span>  <span class="comment">// Returns the shared resources.</span></div><div class="line"><a name="l00449"></a><span class="lineno"> 449</span>  <a class="code" href="classmesos_1_1Resources.html">Resource
s</a> <a class="code" href="classmesos_1_1Resources.html#a1bf71a3804f142e92e0dd28884ea8f99">shared</a>() <span class="keyword">const</span>;</div><div class="line"><a name="l00450"></a><span class="lineno"> 450</span> </div><div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  <span class="comment">// Returns the non-shared resources.</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#a7422a6ffb5e5988b507d587de1aa3e66">nonShared</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 the per-role allocations within these resource objects.</span></div><div class="line"><a name="l00455"></a><span class="lineno">
455</span>  <span class="comment">// This must be called only when the resources are allocated!</span></div><div class="line"><a name="l00456"></a><span class="lineno"> 456</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="l00457"></a><span class="lineno"> 457</span> </div><div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  <span class="comment">// Returns a `Resources` object with the new reservation added to the back.</span></div><div class="line"><a name="l00459"></a><span class="lineno"> 459</span>  <span class="comment">// The new reservation must be a valid refinement of the current reservation.</span></div><div class="line"><a name="l00460"></a><span class="lineno"> 460</span>  <a class="code" href="classme
sos_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="l00461"></a><span class="lineno"> 461</span> </div><div class="line"><a name="l00462"></a><span class="lineno"> 462</span>  <span class="comment">// Returns a `Resources` object with the last reservation removed.</span></div><div class="line"><a name="l00463"></a><span class="lineno"> 463</span>  <span class="comment">// Every resource in `Resources` must have `resource.reservations_size() > 0`.</span></div><div class="line"><a name="l00464"></a><span class="lineno"> 464</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="l00465"></a><span class="lineno"> 465</span> </div><div class="line"><a name="l00466"></a><span class="lineno"> 466</span>  <span class="comment">// Returns a `Resources` object with all of the reservations removed.</span></div><div class="line"><a name="l00467"></a><span class="lineno"> 467</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="l00468"></a><span class="lineno"> 468</span> </div><div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  <span class="comment">// Returns a Resources object that contains all the scalar resources</span></div><div class="line"><a name="l00470"></a><span class="lineno"> 470</span>  <span class="comment">// in this object, but with their AllocationInf
o, ReservationInfo,</span></div><div class="line"><a name="l00471"></a><span class="lineno"> 471</span>  <span class="comment">// DiskInfo, and SharedInfo omitted. The `role` and RevocableInfo,</span></div><div class="line"><a name="l00472"></a><span class="lineno"> 472</span>  <span class="comment">// if any, are preserved. Because we clear ReservationInfo but</span></div><div class="line"><a name="l00473"></a><span class="lineno"> 473</span>  <span class="comment">// preserve `role`, this means that stripping a dynamically reserved</span></div><div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  <span class="comment">// resource makes it effectively statically reserved.</span></div><div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  <span class="comment">//</span></div><div class="line"><a name="l00476"></a><span class="lineno"> 476</span>  <span class="comment">// This is intended for code that wou
ld like to aggregate together</span></div><div class="line"><a name="l00477"></a><span class="lineno"> 477</span>  <span class="comment">// Resource values without regard for metadata like whether the</span></div><div class="line"><a name="l00478"></a><span class="lineno"> 478</span>  <span class="comment">// resource is reserved or the particular volume ID in use. For</span></div><div class="line"><a name="l00479"></a><span class="lineno"> 479</span>  <span class="comment">// example, when calculating the total resources in a cluster,</span></div><div class="line"><a name="l00480"></a><span class="lineno"> 480</span>  <span class="comment">// preserving such information has a major performance cost.</span></div><div class="line"><a name="l00481"></a><span class="lineno"> 481</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> <a class="code" href="classmesos_1_1Resources.html#a350c2c74774111e8b961127b7311fecc">createStrippedS
calarQuantity</a>() <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">// Finds a Resources object with the same amount of each resource</span></div><div class="line"><a name="l00484"></a><span class="lineno"> 484</span>  <span class="comment">// type as "targets" from these Resources. The roles specified in</span></div><div class="line"><a name="l00485"></a><span class="lineno"> 485</span>  <span class="comment">// "targets" set the preference order. For each resource type,</span></div><div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  <span class="comment">// resources are first taken from the specified role, then from '*',</span></div><div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  <span class="comment">//
then from any other role.</span></div><div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  <span class="comment">// TODO(jieyu): 'find' contains some allocation logic for scalars and</span></div><div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  <span class="comment">// fixed set / range elements. However, this is not sufficient for</span></div><div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  <span class="comment">// schedulers that want, say, any N available ports. We should</span></div><div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  <span class="comment">// consider moving this to an internal "allocation" library for our</span></div><div class="line"><a name="l00492"></a><span class="lineno"> 492</span>  <span class="comment">// example frameworks to leverage.</span></div><div class="line"><a name="l00493"></a><span class="lineno"> 493</
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="l00494"></a><span class="lineno"> 494</span> </div><div class="line"><a name="l00495"></a><span class="lineno"> 495</span>  <span class="comment">// Applies a resource conversion by taking out the `consumed`</span></div><div class="line"><a name="l00496"></a><span class="lineno"> 496</span>  <span class="comment">// resources and adding back the `converted` resources. Returns an</span></div><div class="line"><a name="l00497"></a><span class="lineno"> 497</span>  <span class="comment">// Error if the conversion cannot be applied.</span></div><div class="line"><a name="l00498"></a><span class="lineno"> 49
8</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="l00499"></a><span class="lineno"> 499</span> </div><div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  <span class="comment">// Finds a resource object with the same metadata (i.e. AllocationInfo,</span></div><div class="line"><a name="l00501"></a><span class="lineno"> 501</span>  <span class="comment">// ReservationInfo, etc.) as the given one, ignoring the actual value.</span></div><div class="line"><a name="l00502"></a><span class="lineno"> 502</span>  <span class="comment">// If multiple matching resources exist, the first match is returned.</span></div><div cl
ass="line"><a name="l00503"></a><span class="lineno"> 503</span>  <a class="code" href="classOption.html">Option<Resource></a> <a class="code" href="classmesos_1_1Resources.html#a0fd76eaac0f68b60671099fedf7ba27c">match</a>(<span class="keyword">const</span> Resource& resource) <span class="keyword">const</span>;</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>  <span class="comment">// Obtains the conversion from the given operation and applies the</span></div><div class="line"><a name="l00506"></a><span class="lineno"> 506</span>  <span class="comment">// conversion. This method serves a syntax sugar for applying a</span></div><div class="line"><a name="l00507"></a><span class="lineno"> 507</span>  <span class="comment">// resource conversion.</span></div><div class="line"><a name="l00508"></a><span class="lineno"> 508</span> 
<span class="comment">// TODO(jieyu): Consider remove this method once we updated all the</span></div><div class="line"><a name="l00509"></a><span class="lineno"> 509</span>  <span class="comment">// call sites.</span></div><div class="line"><a name="l00510"></a><span class="lineno"> 510</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="l00511"></a><span class="lineno"> 511</span> </div><div class="line"><a name="l00512"></a><span class="lineno"> 512</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> Iterable></div><div class="line"><a name="l00513"></a><span class="lineno"><a cl
ass="line" href="classmesos_1_1Resources.html#aa0307172aed9f2a8bf5ab9852808074b"> 513</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="l00514"></a><span class="lineno"> 514</span> <span class="keyword"> </span>{</div><div class="line"><a name="l00515"></a><span class="lineno"> 515</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a> result = *<span class="keyword">this</span>;</div><div class="line"><a name="l00516"></a><span class="lineno"> 516</span> </div><div class="line"><a name="l00517"></a><span class="lineno"> 517</span>  <span class="keywordflow">foreach</span> (<span class="keyword">const</span> <span class="keyword">auto</span>& t, iterable) {</div><div class="line"><
a name="l00518"></a><span class="lineno"> 518</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="l00519"></a><span class="lineno"> 519</span>  <span class="keywordflow">if</span> (converted.<a class="code" href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>()) {</div><div class="line"><a name="l00520"></a><span class="lineno"> 520</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="l00521"></a><span class="lineno"> 521</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>
  result = converted.<a class="code" href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>();</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> </div><div class="line"><a name="l00526"></a><span class="lineno"> 526</span>  <span class="keywordflow">return</span> result;</div><div class="line"><a name="l00527"></a><span class="lineno"> 527</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">// Helpers to get resource values. We consider all roles here.</span></div><div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  <span class="keyword">template</span> <<span class="keyword">typename</span> T></div><div class="line"><a name="l00531"></a><span class="
lineno"> 531</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="l00532"></a><span class="lineno"> 532</span> </div><div class="line"><a name="l00533"></a><span class="lineno"> 533</span>  <span class="comment">// Get resources of the given name.</span></div><div class="line"><a name="l00534"></a><span class="lineno"> 534</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="l00535"></a><span class="lineno"> 535</span> </div><div cl
ass="line"><a name="l00536"></a><span class="lineno"> 536</span>  <span class="comment">// Get all the resources that are scalars.</span></div><div class="line"><a name="l00537"></a><span class="lineno"> 537</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="l00538"></a><span class="lineno"> 538</span> </div><div class="line"><a name="l00539"></a><span class="lineno"> 539</span>  <span class="comment">// Get the set of unique resource names.</span></div><div class="line"><a name="l00540"></a><span class="lineno"> 540</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="l00541"></a><span class="lineno"> 541</span>&#
160;</div><div class="line"><a name="l00542"></a><span class="lineno"> 542</span>  <span class="comment">// Get the types of resources associated with each resource name.</span></div><div class="line"><a name="l00543"></a><span class="lineno"> 543</span>  <span class="comment">// NOTE: Resources of the same name must have the same type, as</span></div><div class="line"><a name="l00544"></a><span class="lineno"> 544</span>  <span class="comment">// enforced by Resources::parse().</span></div><div class="line"><a name="l00545"></a><span class="lineno"> 545</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="l00546"></a><span class="lineno"> 546</span> </div><div class="line"><a name="l00547"></a><span class="lineno"> 547</span>  <span class="comment">// Helpers to get known resource ty
pes.</span></div><div class="line"><a name="l00548"></a><span class="lineno"> 548</span>  <span class="comment">// TODO(vinod): Fix this when we make these types as first class</span></div><div class="line"><a name="l00549"></a><span class="lineno"> 549</span>  <span class="comment">// protobufs.</span></div><div class="line"><a name="l00550"></a><span class="lineno"> 550</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="l00551"></a><span class="lineno"> 551</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="l00552"></a><span class="lineno"> 552</span>  <a class="code" href="class
Option.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="l00553"></a><span class="lineno"> 553</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="l00554"></a><span class="lineno"> 554</span> </div><div class="line"><a name="l00555"></a><span class="lineno"> 555</span>  <span class="comment">// TODO(vinod): Provide a Ranges abstraction.</span></div><div class="line"><a name="l00556"></a><span class="lineno"> 556</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 c
lass="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="comment">// TODO(jieyu): Consider returning an EphemeralPorts abstraction</span></div><div class="line"><a name="l00559"></a><span class="lineno"> 559</span>  <span class="comment">// which holds the ephemeral ports allocation logic.</span></div><div class="line"><a name="l00560"></a><span class="lineno"> 560</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="l00561"></a><span class="lineno"> 561</span> </div><div class="line"><a name="l00562"></a><span class="lineno"> 562</span>  <span class="comment">// NOTE: Non-`const` `iterator`, `begin()` and `end()` are __intentionally__</span></d
iv><div class="line"><a name="l00563"></a><span class="lineno"> 563</span>  <span class="comment">// defined with `const` semantics in order to prevent mutable access to the</span></div><div class="line"><a name="l00564"></a><span class="lineno"> 564</span>  <span class="comment">// `Resource` objects within `resources`.</span></div><div class="line"><a name="l00565"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a2f4bcc0de9f40c0c947d355213aaac95"> 565</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="l00566"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#aead097c9cbf735bed75199745625d768"> 566</a></span>  <span class="keyword">typedef</span> std::vector<Resource_>::const_iterator <a class="code" href="classmesos_1_1Res
ources.html#aead097c9cbf735bed75199745625d768">const_iterator</a>;</div><div class="line"><a name="l00567"></a><span class="lineno"> 567</span> </div><div class="line"><a name="l00568"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a62a685bb22d0916e15e019602a36659f"> 568</a></span>  const_iterator <a class="code" href="classmesos_1_1Resources.html#a62a685bb22d0916e15e019602a36659f">begin</a>()</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="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="l00571"></a><span class="lineno"> 571</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"><a class="line" href="classmesos_1_1Resources.html#a07ff5813b931a26510a3343cb0c988e1"> 573</a></span>  const_iterator <a class="code" href="classmesos_1_1Resources.html#a07ff5813b931a26510a3343cb0c988e1">end</a>()</div><div class="line"><a name="l00574"></a><span class="lineno"> 574</span>  {</div><div class="line"><a name="l00575"></a><span class="lineno"> 575</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="l00576"></a><span class="lineno"> 576</span>  }</div><div class="line"><a name="l00577"></a><span class="lineno"> 577</s
pan> </div><div class="line"><a name="l00578"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#ae66c01db87b2a42cfee3e77c20687d56"> 578</a></span>  const_iterator <a class="code" href="classmesos_1_1Resources.html#ae66c01db87b2a42cfee3e77c20687d56">begin</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> resources.<a class="code" href="classmesos_1_1Resources.html#a62a685bb22d0916e15e019602a36659f">begin</a>(); }</div><div class="line"><a name="l00579"></a><span class="lineno"><a class="line" href="classmesos_1_1Resources.html#a09242ab54ec91f74c67b67c7ab44036f"> 579</a></span>  const_iterator <a class="code" href="classmesos_1_1Resources.html#a09242ab54ec91f74c67b67c7ab44036f">end</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> resources.<a class="code" href="classmesos_1_1Resources.html#a07ff5813b931a26510a3343cb0c988e1">end</a>(); }</div><div class="line"><a name="l00580
"></a><span class="lineno"> 580</span> </div><div class="line"><a name="l00581"></a><span class="lineno"> 581</span>  <span class="comment">// Using this operator makes it easy to copy a resources object into</span></div><div class="line"><a name="l00582"></a><span class="lineno"> 582</span>  <span class="comment">// a protocol buffer field.</span></div><div class="line"><a name="l00583"></a><span class="lineno"> 583</span>  <span class="comment">// Note that the google::protobuf::RepeatedPtrField<Resource> is</span></div><div class="line"><a name="l00584"></a><span class="lineno"> 584</span>  <span class="comment">// generated at runtime.</span></div><div class="line"><a name="l00585"></a><span class="lineno"> 585</span>  <span class="keyword">operator</span> google::protobuf::RepeatedPtrField<Resource>() <span class="keyword">const</span>;</div><div class="line"><a name="l00586"></a><span class="lineno"> 586</span> </div><
div class="line"><a name="l00587"></a><span class="lineno"> 587</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="l00588"></a><span class="lineno"> 588</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="l00589"></a><span class="lineno"> 589</span> </div><div class="line"><a name="l00590"></a><span class="lineno"> 590</span>  <span class="comment">// NOTE: If any error occurs (e.g., input Resource is not valid or</
span></div><div class="line"><a name="l00591"></a><span class="lineno"> 591</span>  <span class="comment">// the first operand is not a superset of the second operand while</span></div><div class="line"><a name="l00592"></a><span class="lineno"> 592</span>  <span class="comment">// doing subtraction), the semantics is as though the second operand</span></div><div class="line"><a name="l00593"></a><span class="lineno"> 593</span>  <span class="comment">// was actually just an empty resource (as though you didn't do the</span></div><div class="line"><a name="l00594"></a><span class="lineno"> 594</span>  <span class="comment">// operation at all).</span></div><div class="line"><a name="l00595"></a><span class="lineno"> 595</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="l00596"></a><span class="lineno"> 596</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="l00597"></a><span class="lineno"> 597</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="l00598"></a><span class="lineno"> 598</span>  <a class="code" href="classmesos_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1Resources.html#a5e73184e5fd1818ec189fe5f7d432b25">operat
or+=</a>(<span class="keyword">const</span> <a class="code" href="classmesos_1_1Resources.html">Resources</a>& that);</div><div class="line"><a name="l00599"></a><span class="lineno"> 599</span>
<TRUNCATED>