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 01:22:43 UTC
[03/19] mesos-site git commit: Updated the website built from mesos
SHA: 7954729.
http://git-wip-us.apache.org/repos/asf/mesos-site/blob/b8f812f2/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 309679a..058c79d 100644
--- a/content/api/latest/c++/v1_2resources_8hpp_source.html
+++ b/content/api/latest/c++/v1_2resources_8hpp_source.html
@@ -52,28 +52,29 @@
<div class="title">resources.hpp</div> </div>
</div><!--header-->
<div class="contents">
-<a href="v1_2resources_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><sp
an class="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">// dis
tributed 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 __MESOS_V1_RESOURCES_HPP__</span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="preprocessor">#define __MESOS_V1_RESOURCES_HPP__</span></div><div cl
ass="line"><a name="l00019"></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/rep
eated_field.h></span></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_2v1_2mesos_8hpp.html">mesos/v1/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="include_2mesos_2v1_2values_8hpp.html">mesos/v1/values.hpp</a>></span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> </div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">#include <<a class="code" href="bytes_8hpp.html">stout/bytes.hpp</a>></span></div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include <<a class="code" href="stout_2include_2stout_2check_8hp
p.html">stout/check.hpp</a>></span></div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <<a class="code" href="error_8hpp.html">stout/error.hpp</a>></span></div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#include <<a class="code" href="foreach_8hpp.html">stout/foreach.hpp</a>></span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">#include <<a class="code" href="hashmap_8hpp.html">stout/hashmap.hpp</a>></span></div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor">#include <<a class="code" href="json_8hpp.html">stout/json.hpp</a>></span></div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor">#include <<a class="code" href="lambda_8hpp.html">stout/lambda.hpp<
/a>></span></div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="preprocessor">#include <<a class="code" href="nothing_8hpp.html">stout/nothing.hpp</a>></span></div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="preprocessor">#include <<a class="code" href="option_8hpp.html">stout/option.hpp</a>></span></div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="preprocessor">#include <<a class="code" href="try_8hpp.html">stout/try.hpp</a>></span></div><div class="line"><a name="l00041"></a><span class="lineno"> 41</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> <span class="comment">// Resources come in three types: scalar, ranges, and sets. These are</span></div><div class="line"><a name="l00044"></a><span c
lass="lineno"> 44</span> <span class="comment">// represented using protocol buffers. To make manipulation of</span></div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">// resources easier within the Mesos core and for scheduler writers,</span></div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">// we provide generic overloaded operators (see below) as well as a</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// general Resources class that encapsulates a collection of protocol</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// buffer Resource objects. The Resources class also provides a few</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">// static routines to allow parsing resources
(e.g., from the command</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">// line), as well as determining whether or not a Resource object is</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment">// valid. Note that many of these operations have not been optimized</span></div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// but instead just written for correct semantics.</span></div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span> </div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="keyword">namespace </span><a class="code" href="namespacemesos.html">mesos</a> {</div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="keyword">namespace </span>v1 {</div><div class="line"><a name="l00056"></a><span cl
ass="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_1_1v1.html#ae8c8677520aa191d0ed76304408121db">operator==</a>(</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  <span class="keyword">const</span> Resource::ReservationInfo& left,</div><div c
lass="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_1_1v1.html#a97ffb2ddb401df1e9242ca3191836872">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_1v1_1_1Resources.html"> 79</a></span> <span class="keyword">class </span><a class="code" href="classmesos_1_1v1_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="l00083"></a><span cla
ss="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</span></div><div clas
s="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="lineno"> 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</sp
an>  <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_1v1_1_1Resources.html#a3b642920fe195dca5e142ba9f1bf0445">isShared</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> sharedCount.isSome(); }</div><div class="line"><a nam
e="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_1v1_1_1Resources.html#aa1501df2cd47829fcebb26410f38fa6e">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_1v1_1_1Resources.html#a1122b880d0a01c919a35a41be0fa7b94">isEmpty</a>() <span class="key
word">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>  <spa
n 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">
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="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_1v1_1_1Resources.html#ad367ced251edfb414891e6c0d859f264">operator+=</a>(<span class="keyword">const</span> Resource_& that);</div><div class="line"><a name="l00132"></a><span class="lineno"> 132</spa
n>  Resource_& <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="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_1v1_1_1Resources.html#aebd5411e3ec8b4573de8e85e025178f1">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_1v1_1_1Resources.html#a5e80a4c0b065ceb6cd2f0d5445964213">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</sp
an> </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_1v1_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_1v1_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="li
neno"> 142</span>  <span class="keyword">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_1v1_1_1Resources.html#ada21773cbd96e5163fd54711282d9d91">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">const</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_1v1_1_1Resources.html#ada21773cbd96e5163fd54711282d9d91">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 class="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_1v1_1_1Resources.html#a013a0925b3375ede1d90f76f29d2d12e">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="classT
ry.html">Try<std::vector<Resource></a>> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a4c8d1ca13522473ecbeaecf8f8b31f50">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_1v1_1_1Resources.html#ad46385859813ded1f902075c266410c2">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 class="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_1v1_1_1Resources.html#aa1501df2cd47829fcebb26410f38fa6e">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="clas
smesos_1_1v1_1_1Resources.html#aa1501df2cd47829fcebb26410f38fa6e">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.reservation` 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_1v1_1_1Resources.html#a1122b880d0a01c919a35a41be0fa7b94">isEmpty</a>(<span class="keyword">const</span> Resource& resource);<
/div><div class="line"><a name="l00291"></a><span class="lineno"> 291</span> </div><div 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_1v1_1_1Resources.html#ad2b1ead3063e0d52e43d93c3dc5fd070">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_1v1_1_1Resources.html#a01310b5316cfff0b6126115fc7f31046">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>&#
160; <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_1v1_1_1Resources.html#ae75dcd85eda5807cdf12e42d2e354291">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 obje
ct 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_1v1_1_1Resources.html#a4fa6fa4b4da9acbc04e8faa7ad9dc24a">isAllocatableTo</a>(</div><div class="lin
e"><a name="l00312"></a><span class="lineno"> 312</span>  <span class="keyword">const</span> Resource& 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_1v1_1_1Resources.html#a4ce7250b1e5eec3b0e3bc3a66fe4007b">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="l
ineno"> 318</span>  <span class="comment">// Tests if the given Resource object is dynamically reserved.</span></div><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_1v1_1_1Resources.html#ab691d1c2fa2629190347c19dcc6a385f">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_1v1_1_1Resources.html#aafe883992970766fad47c0f1bff39998">isRevocable</a>(<span class="keyword">co
nst</span> Resource& resource);</div><div class="line"><a name="l00323"></a><span class="lineno"> 323</span> </div><div class="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_1v1_1_1Resources.html#a3b642920fe195dca5e142ba9f1bf0445">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 Resource object has refined reservations.</span></div><div class="line"><a name="l00328"></a><span class="lineno"> 328</span>  <span class="keyword">static</span> <span c
lass="keywordtype">bool</span> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a497e25b377bf0b52d3356972f2f49df8">hasRefinedReservations</a>(<span class="keyword">const</span> Resource& resource);</div><div class="line"><a name="l00329"></a><span class="lineno"> 329</span> </div><div class="line"><a name="l00330"></a><span class="lineno"> 330</span>  <span class="comment">// Tests if the given Resource object is provided by a resource provider.</span></div><div class="line"><a name="l00331"></a><span class="lineno"> 331</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> <a class="code" href="classmesos_1_1v1_1_1Resources.html#a54217a6501a0f7fad946eacd893ecb67">hasResourceProvider</a>(<span class="keyword">const</span> Resource& resource);</div><div class="line"><a name="l00332"></a><span class="lineno"> 332</span> </div><div class="line"><a name="l00333"></a><span class="lineno"> 333</span>  <span class
="comment">// Returns the role to which the given Resource object is reserved for.</span></div><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">// 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 resou
rce 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]&q
uot;</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 na
me="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"> 360</span>  <a class="code" href="foreach_8hpp.html#a28670619e64a84270d76f07b0f6eb3b6">foreachva
lue</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#afb96448b026e8b78e338cf8
2bfc47e7a">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="keywor
d">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="c
lassmesos_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>&#
160; 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"><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 n
ame="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></di
v><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">// 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">// 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="lin
e"><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>  <sp
an 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 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="co
de" 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="lin
eno"> 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 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 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 eff
ectively 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 inf
ormation 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 typ
e,</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="comme
nt">// 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>  <sp
an 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="comment">// Obtains the conversion from the given operation and applies the</span></div><div class="line"><a name="l00496"></a><span cl
ass="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" h
ref="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#a8bc7f43e75a47111ea18e9c83b007be5">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="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">// 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="key
word">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 nam
e="l00545"></a><span class="lineno"> 545</span>  <span class="comment">// TODO(vinod): Provide a Ranges abstraction.</span></div><div class="line"><a name="l00546"></a><span class="lineno"> 546</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="l00547"></a><span class="lineno"> 547</span> </div><div class="line"><a name="l00548"></a><span class="lineno"> 548</span>  <span class="comment">// TODO(jieyu): Consider returning an EphemeralPorts abstraction</span></div><div class="line"><a name="l00549"></a><span class="lineno"> 549</span>  <span class="comment">// which holds the ephemeral ports allocation logic.</span></div><div class="line"><a name="l00550"></a><span class="lineno"> 550</span>  <a class="code" href="classOption.html">Option<Valu
e::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="l00551"></a><span class="lineno"> 551</span> </div><div class="line"><a name="l00552"></a><span class="lineno"> 552</span>  <span class="comment">// NOTE: Non-`const` `iterator`, `begin()` and `end()` are __intentionally__</span></div><div class="line"><a name="l00553"></a><span class="lineno"> 553</span>  <span class="comment">// defined with `const` semantics in order to prevent mutable access to the</span></div><div class="line"><a name="l00554"></a><span class="lineno"> 554</span>  <span class="comment">// `Resource` objects within `resources`.</span></div><div class="line"><a name="l00555"></a><span class="lineno"><a class="line" href="classmesos_1_1v1_1_1Resources.html#a7d595dbb779360ef854351a0b6d8095e"> 555</a></span>  <span class="keyword">typed
ef</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="l00556"></a><span class="lineno"><a class="line" href="classmesos_1_1v1_1_1Resources.html#afd9c90fbd4faa76f9c83954ed8f4dc96"> 556</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="l00557"></a><span class="lineno"> 557</span> </div><div class="line"><a name="l00558"></a><span class="lineno"><a class="line" href="classmesos_1_1v1_1_1Resources.html#a9b8e38da3ee3aafcb83a1ec847e1a8e5"> 558</a></span>  const_iterator <a class="code" href="classmesos_1_1v1_1_1Resources.html#a9b8e38da3ee3aafcb83a1ec847e1a8e5">begin</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>  <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="l00561"></a><span class="lineno"> 561</span>  }</div><div class="line"><a name="l00562"></a><span class="lineno"> 562</span> </div><div class="line"><a name="l00563"></a><span class="lineno"><a class="line" href="classmesos_1_1v1_1_1Resources.html#ae6ae804b1d0941acb28f99e020bdda10"> 563</a></span>  const_iterator <a class="code" href="classmesos_1_1v1_1_1Resources.html#ae6ae804b1d0941acb28f99e020bdda10">end</a>()</div><div class="line"><a name="l00564"></a><span class="lineno"> 564</span>  {</div><div class="line"><a name="l00565"></
a><span class="lineno"> 565</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="l00566"></a><span class="lineno"> 566</span>  }</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_1v1_1_1Resources.html#ac9cc77a6d6ecd961c5ba8e1b77890118"> 568</a></span>  const_iterator <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="l00569"></a><span class="lineno"><a class="line" hr
ef="classmesos_1_1v1_1_1Resources.html#ac2d4dfbb981af8a9faa9acc09b50a674"> 569</a></span>  const_iterator <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="l00570"></a><span class="lineno"> 570</span> </div><div class="line"><a name="l00571"></a><span class="lineno"> 571</span>  <span class="comment">// Using this operator makes it easy to copy a resources object into</span></div><div class="line"><a name="l00572"></a><span class="lineno"> 572</span>  <span class="comment">// a protocol buffer field.</span></div><div class="line"><a name="l00573"></a><span class="lineno"> 573</span>  <span class="comment">// Note that the google::protobuf::RepeatedPtrField<Resource> is</span></div><div class="line"><a name="l00574"></a><span class="lineno"> 574</span>  <span c
lass="comment">// generated at runtime.</span></div><div class="line"><a name="l00575"></a><span class="lineno"> 575</span>  <span class="keyword">operator</span> google::protobuf::RepeatedPtrField<Resource>() <span class="keyword">const</span>;</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</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="l00578"></a><span class="lineno"> 578</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 cl
ass="code" href="classmesos_1_1v1_1_1Resources.html">Resources</a>& that) <span class="keyword">const</span>;</div><div class="line"><a name="l00579"></a><span class="lineno"> 579</span> </div><div class="line"><a name="l00580"></a><span class="lineno"> 580</span>  <span class="comment">// NOTE: If any error occurs (e.g., input Resource is not valid or</span></div><div class="line"><a name="l00581"></a><span class="lineno"> 581</span>  <span class="comment">// the first operand is not a superset of the second operand while</span></div><div class="line"><a name="l00582"></a><span class="lineno"> 582</span>  <span class="comment">// doing subtraction), the semantics is as though the second operand</span></div><div class="line"><a name="l00583"></a><span class="lineno"> 583</span>  <span class="comment">// was actually just an empty resource (as though you didn't do the</span></div><div class="line"><a name="l00584"></a><span class="lineno"> 5
84</span>  <span class="comment">// operation at all).</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#ad83dc3d47cc27f71b1a62fcc03ee4255">operator+</a>(<span class="keyword">const</span> Resource& that) <span class="keyword">const</span>;</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#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="l00587"></a><span class="lineno"> 587</span>  <a class="code" href="classmesos_1_1v1_1_1Resources.html">Resources</a>&a
mp; <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="l00588"></a><span class="lineno"> 588</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="l00589"></a><span class="lineno"> 589</span> </div><div class="line"><a name="l00590"></a><span class="lineno"> 590</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="l00591"></a><span class="lineno"> 591</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="l00592"></a><span class="lineno"> 592</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="l00593"></a><span class="lineno"> 593</span>  <a class="code" href="classmesos_1_1v1_1_1Resources.html">Resources</a>& <a class="code" href="classmesos_1_1v1_1_1Resources.html#ad31bd7470855a7691d10f0a4f73aa217">opera
tor-=</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="l00594"></a><span
<TRUNCATED>