blob: e8b72fc3b838d8796c048bc96f394c9e1fabc934 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>mxnet: /work/mxnet/3rdparty/dmlc-core/include/dmlc/parameter.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">mxnet
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_8cab8f464681f7cc51cee77e79a434cd.html">3rdparty</a></li><li class="navelem"><a class="el" href="dir_82e31a22178767beedddc7597fd1ecb6.html">dmlc-core</a></li><li class="navelem"><a class="el" href="dir_7dd5b88db83ff474628c03c453739a90.html">include</a></li><li class="navelem"><a class="el" href="dir_e30967e3ab51f65ad4b50dd298ccf4e7.html">dmlc</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">parameter.h</div> </div>
</div><!--header-->
<div class="contents">
<a href="parameter_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span>&#160;</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span>&#160;<span class="preprocessor">#ifndef DMLC_PARAMETER_H_</span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span>&#160;<span class="preprocessor">#define DMLC_PARAMETER_H_</span></div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span>&#160;</div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span>&#160;<span class="preprocessor">#include &lt;cstddef&gt;</span></div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span>&#160;<span class="preprocessor">#include &lt;cstdlib&gt;</span></div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span>&#160;<span class="preprocessor">#include &lt;cmath&gt;</span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span>&#160;<span class="preprocessor">#include &lt;sstream&gt;</span></div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span>&#160;<span class="preprocessor">#include &lt;limits&gt;</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span>&#160;<span class="preprocessor">#include &lt;map&gt;</span></div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span>&#160;<span class="preprocessor">#include &lt;set&gt;</span></div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span>&#160;<span class="preprocessor">#include &lt;typeinfo&gt;</span></div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span>&#160;<span class="preprocessor">#include &lt;string&gt;</span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span>&#160;<span class="preprocessor">#include &lt;vector&gt;</span></div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span>&#160;<span class="preprocessor">#include &lt;algorithm&gt;</span></div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span>&#160;<span class="preprocessor">#include &lt;utility&gt;</span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span>&#160;<span class="preprocessor">#include &lt;stdexcept&gt;</span></div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span>&#160;<span class="preprocessor">#include &lt;iostream&gt;</span></div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span>&#160;<span class="preprocessor">#include &lt;iomanip&gt;</span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span>&#160;<span class="preprocessor">#include &lt;cerrno&gt;</span></div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="3rdparty_2dmlc-core_2include_2dmlc_2base_8h.html">./base.h</a>&quot;</span></div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="json_8h.html">./json.h</a>&quot;</span></div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span>&#160;<span class="preprocessor">#include &quot;./logging.h&quot;</span></div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="type__traits_8h.html">./type_traits.h</a>&quot;</span></div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="optional_8h.html">./optional.h</a>&quot;</span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="strtonum_8h.html">./strtonum.h</a>&quot;</span></div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span>&#160;</div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span>&#160;<span class="keyword">namespace </span><a class="code" href="namespacedmlc.html">dmlc</a> {</div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span>&#160;<span class="comment">// this file is backward compatible with non-c++11</span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span>&#160;<span class="comment"></span><span class="keyword">struct </span>ParamError : <span class="keyword">public</span> dmlc::Error {</div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span>&#160; <span class="keyword">explicit</span> ParamError(<span class="keyword">const</span> std::string &amp;msg)</div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span>&#160; : <a class="code" href="namespacedmlc.html">dmlc</a>::Error(msg) {}</div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span>&#160;};</div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span>&#160;</div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">typename</span> ValueType&gt;</div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span>&#160;<span class="keyword">inline</span> ValueType GetEnv(<span class="keyword">const</span> <span class="keywordtype">char</span> *key,</div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span>&#160; ValueType default_value);</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">typename</span> ValueType&gt;</div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span>&#160;<span class="keyword">inline</span> <span class="keywordtype">void</span> SetEnv(<span class="keyword">const</span> <span class="keywordtype">char</span> *key,</div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span>&#160; ValueType value);</div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span>&#160;</div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span>&#160;<span class="keyword">namespace </span>parameter {</div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span>&#160;<span class="comment">// forward declare ParamManager</span></div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span>&#160;<span class="keyword">class </span>ParamManager;</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span>&#160;<span class="comment">// forward declare FieldAccessEntry</span></div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span>&#160;<span class="keyword">class </span>FieldAccessEntry;</div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span>&#160;<span class="comment">// forward declare FieldEntry</span></div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">typename</span> DType&gt;</div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span>&#160;<span class="keyword">class </span>FieldEntry;</div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span>&#160;<span class="comment">// forward declare ParamManagerSingleton</span></div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">typename</span> PType&gt;</div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span>&#160;<span class="keyword">struct </span>ParamManagerSingleton;</div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span>&#160;</div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span>&#160;<span class="keyword">enum</span> ParamInitOption {</div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span>&#160; kAllowUnknown,</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span>&#160; kAllMatch,</div><div class="line"><a name="l00083"></a><span class="lineno"> 83</span>&#160; kAllowHidden</div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span>&#160;};</div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span>&#160;} <span class="comment">// namespace parameter</span></div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span>&#160;<span class="comment"></span><span class="keyword">struct </span>ParamFieldInfo {</div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span>&#160; std::string name;</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span>&#160; std::string type;</div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span>&#160; std::string type_info_str;</div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span>&#160; std::string description;</div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span>&#160;};</div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span>&#160;</div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">typename</span> PType&gt;</div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span>&#160;<span class="keyword">struct </span>Parameter {</div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span>&#160; <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Container&gt;</div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> Init(<span class="keyword">const</span> Container &amp;kwargs,</div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span>&#160; parameter::ParamInitOption option = parameter::kAllowHidden) {</div><div class="line"><a name="l00143"></a><span class="lineno"> 143</span>&#160; PType::__MANAGER__()-&gt;RunInit(static_cast&lt;PType*&gt;(<span class="keyword">this</span>),</div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span>&#160; kwargs.begin(), kwargs.end(),</div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span>&#160; NULL,</div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span>&#160; option);</div><div class="line"><a name="l00147"></a><span class="lineno"> 147</span>&#160; }</div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span>&#160; <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Container&gt;</div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span>&#160; <span class="keyword">inline</span> std::vector&lt;std::pair&lt;std::string, std::string&gt; &gt;</div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span>&#160; InitAllowUnknown(<span class="keyword">const</span> Container &amp;kwargs) {</div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span>&#160; std::vector&lt;std::pair&lt;std::string, std::string&gt; &gt; unknown;</div><div class="line"><a name="l00161"></a><span class="lineno"> 161</span>&#160; PType::__MANAGER__()-&gt;RunInit(static_cast&lt;PType*&gt;(<span class="keyword">this</span>),</div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span>&#160; kwargs.begin(), kwargs.end(),</div><div class="line"><a name="l00163"></a><span class="lineno"> 163</span>&#160; &amp;unknown, parameter::kAllowUnknown);</div><div class="line"><a name="l00164"></a><span class="lineno"> 164</span>&#160; <span class="keywordflow">return</span> unknown;</div><div class="line"><a name="l00165"></a><span class="lineno"> 165</span>&#160; }</div><div class="line"><a name="l00166"></a><span class="lineno"> 166</span>&#160;</div><div class="line"><a name="l00179"></a><span class="lineno"> 179</span>&#160; <span class="keyword">template</span> &lt;<span class="keyword">typename</span> Container&gt;</div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span>&#160; std::vector&lt;std::pair&lt;std::string, std::string&gt; &gt;</div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span>&#160; UpdateAllowUnknown(Container <span class="keyword">const</span>&amp; kwargs, <span class="keywordtype">bool</span>* out_changed = <span class="keyword">nullptr</span>) {</div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span>&#160; std::vector&lt;std::pair&lt;std::string, std::string&gt; &gt; unknown;</div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span>&#160; <span class="keywordtype">bool</span> changed {<span class="keyword">false</span>};</div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span>&#160; changed = PType::__MANAGER__()-&gt;RunUpdate(static_cast&lt;PType*&gt;(<span class="keyword">this</span>),</div><div class="line"><a name="l00185"></a><span class="lineno"> 185</span>&#160; kwargs.begin(), kwargs.end(),</div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span>&#160; parameter::kAllowUnknown, &amp;unknown, <span class="keyword">nullptr</span>);</div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span>&#160; <span class="keywordflow">if</span> (out_changed) { *out_changed = changed; }</div><div class="line"><a name="l00188"></a><span class="lineno"> 188</span>&#160; <span class="keywordflow">return</span> unknown;</div><div class="line"><a name="l00189"></a><span class="lineno"> 189</span>&#160; }</div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span>&#160;</div><div class="line"><a name="l00197"></a><span class="lineno"> 197</span>&#160; <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Container&gt;</div><div class="line"><a name="l00198"></a><span class="lineno"> 198</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> UpdateDict(Container *dict)<span class="keyword"> const </span>{</div><div class="line"><a name="l00199"></a><span class="lineno"> 199</span>&#160; PType::__MANAGER__()-&gt;UpdateDict(this-&gt;head(), dict);</div><div class="line"><a name="l00200"></a><span class="lineno"> 200</span>&#160; }</div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span>&#160; <span class="keyword">inline</span> std::map&lt;std::string, std::string&gt; __DICT__()<span class="keyword"> const </span>{</div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span>&#160; std::vector&lt;std::pair&lt;std::string, std::string&gt; &gt; vec</div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span>&#160; = PType::__MANAGER__()-&gt;GetDict(this-&gt;head());</div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span>&#160; <span class="keywordflow">return</span> std::map&lt;std::string, std::string&gt;(vec.begin(), vec.end());</div><div class="line"><a name="l00209"></a><span class="lineno"> 209</span>&#160; }</div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> Save(<a class="code" href="classdmlc_1_1JSONWriter.html">dmlc::JSONWriter</a> *writer)<span class="keyword"> const </span>{</div><div class="line"><a name="l00215"></a><span class="lineno"> 215</span>&#160; writer-&gt;<a class="code" href="classdmlc_1_1JSONWriter.html#ac16c9b279f64512117fdefb2ede8662d">Write</a>(this-&gt;__DICT__());</div><div class="line"><a name="l00216"></a><span class="lineno"> 216</span>&#160; }</div><div class="line"><a name="l00222"></a><span class="lineno"> 222</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> Load(<a class="code" href="classdmlc_1_1JSONReader.html">dmlc::JSONReader</a> *reader) {</div><div class="line"><a name="l00223"></a><span class="lineno"> 223</span>&#160; std::map&lt;std::string, std::string&gt; kwargs;</div><div class="line"><a name="l00224"></a><span class="lineno"> 224</span>&#160; reader-&gt;<a class="code" href="classdmlc_1_1JSONReader.html#a74487e106bca0cc16b676f539f69a4bf">Read</a>(&amp;kwargs);</div><div class="line"><a name="l00225"></a><span class="lineno"> 225</span>&#160; this-&gt;Init(kwargs);</div><div class="line"><a name="l00226"></a><span class="lineno"> 226</span>&#160; }</div><div class="line"><a name="l00231"></a><span class="lineno"> 231</span>&#160; <span class="keyword">inline</span> <span class="keyword">static</span> std::vector&lt;ParamFieldInfo&gt; __FIELDS__() {</div><div class="line"><a name="l00232"></a><span class="lineno"> 232</span>&#160; <span class="keywordflow">return</span> PType::__MANAGER__()-&gt;GetFieldInfo();</div><div class="line"><a name="l00233"></a><span class="lineno"> 233</span>&#160; }</div><div class="line"><a name="l00238"></a><span class="lineno"> 238</span>&#160; <span class="keyword">inline</span> <span class="keyword">static</span> std::string __DOC__() {</div><div class="line"><a name="l00239"></a><span class="lineno"> 239</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00240"></a><span class="lineno"> 240</span>&#160; PType::__MANAGER__()-&gt;PrintDocString(os);</div><div class="line"><a name="l00241"></a><span class="lineno"> 241</span>&#160; <span class="keywordflow">return</span> os.str();</div><div class="line"><a name="l00242"></a><span class="lineno"> 242</span>&#160; }</div><div class="line"><a name="l00243"></a><span class="lineno"> 243</span>&#160;</div><div class="line"><a name="l00244"></a><span class="lineno"> 244</span>&#160; <span class="keyword">protected</span>:</div><div class="line"><a name="l00251"></a><span class="lineno"> 251</span>&#160; <span class="keyword">template</span>&lt;<span class="keyword">typename</span> DType&gt;</div><div class="line"><a name="l00252"></a><span class="lineno"> 252</span>&#160; <span class="keyword">inline</span> parameter::FieldEntry&lt;DType&gt;&amp; DECLARE(</div><div class="line"><a name="l00253"></a><span class="lineno"> 253</span>&#160; parameter::ParamManagerSingleton&lt;PType&gt; *manager,</div><div class="line"><a name="l00254"></a><span class="lineno"> 254</span>&#160; <span class="keyword">const</span> std::string &amp;key, DType &amp;ref) { <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00255"></a><span class="lineno"> 255</span>&#160; parameter::FieldEntry&lt;DType&gt; *e =</div><div class="line"><a name="l00256"></a><span class="lineno"> 256</span>&#160; <span class="keyword">new</span> parameter::FieldEntry&lt;DType&gt;();</div><div class="line"><a name="l00257"></a><span class="lineno"> 257</span>&#160; e-&gt;Init(key, this-&gt;head(), ref);</div><div class="line"><a name="l00258"></a><span class="lineno"> 258</span>&#160; manager-&gt;manager.AddEntry(key, e);</div><div class="line"><a name="l00259"></a><span class="lineno"> 259</span>&#160; <span class="keywordflow">return</span> *e;</div><div class="line"><a name="l00260"></a><span class="lineno"> 260</span>&#160; }</div><div class="line"><a name="l00261"></a><span class="lineno"> 261</span>&#160;</div><div class="line"><a name="l00262"></a><span class="lineno"> 262</span>&#160; <span class="keyword">private</span>:</div><div class="line"><a name="l00264"></a><span class="lineno"> 264</span>&#160; <span class="keyword">inline</span> PType *head()<span class="keyword"> const </span>{</div><div class="line"><a name="l00265"></a><span class="lineno"> 265</span>&#160; <span class="keywordflow">return</span> <span class="keyword">static_cast&lt;</span>PType*<span class="keyword">&gt;</span>(<span class="keyword">const_cast&lt;</span>Parameter&lt;PType&gt;*<span class="keyword">&gt;</span>(<span class="keyword">this</span>));</div><div class="line"><a name="l00266"></a><span class="lineno"> 266</span>&#160; }</div><div class="line"><a name="l00267"></a><span class="lineno"> 267</span>&#160;};</div><div class="line"><a name="l00268"></a><span class="lineno"> 268</span>&#160;</div><div class="line"><a name="l00270"></a><span class="lineno"> 270</span>&#160;</div><div class="line"><a name="l00289"></a><span class="lineno"> 289</span>&#160;<span class="preprocessor">#define DMLC_DECLARE_PARAMETER(PType) \</span></div><div class="line"><a name="l00290"></a><span class="lineno"> 290</span>&#160;<span class="preprocessor"> static ::dmlc::parameter::ParamManager *__MANAGER__(); \</span></div><div class="line"><a name="l00291"></a><span class="lineno"> 291</span>&#160;<span class="preprocessor"> inline void __DECLARE__(::dmlc::parameter::ParamManagerSingleton&lt;PType&gt; *manager) \</span></div><div class="line"><a name="l00292"></a><span class="lineno"> 292</span>&#160;<span class="preprocessor"></span></div><div class="line"><a name="l00293"></a><span class="lineno"> 293</span>&#160;</div><div class="line"><a name="l00297"></a><span class="lineno"> 297</span>&#160;<span class="preprocessor">#define DMLC_DECLARE_FIELD(FieldName) this-&gt;DECLARE(manager, #FieldName, FieldName)</span></div><div class="line"><a name="l00298"></a><span class="lineno"> 298</span>&#160;</div><div class="line"><a name="l00304"></a><span class="lineno"> 304</span>&#160;<span class="preprocessor">#define DMLC_DECLARE_ALIAS(FieldName, AliasName) manager-&gt;manager.AddAlias(#FieldName, #AliasName)</span></div><div class="line"><a name="l00305"></a><span class="lineno"> 305</span>&#160;</div><div class="line"><a name="l00314"></a><span class="lineno"> 314</span>&#160;<span class="preprocessor">#define DMLC_REGISTER_PARAMETER(PType) \</span></div><div class="line"><a name="l00315"></a><span class="lineno"> 315</span>&#160;<span class="preprocessor"> ::dmlc::parameter::ParamManager *PType::__MANAGER__() { \</span></div><div class="line"><a name="l00316"></a><span class="lineno"> 316</span>&#160;<span class="preprocessor"> static ::dmlc::parameter::ParamManagerSingleton&lt;PType&gt; inst(#PType); \</span></div><div class="line"><a name="l00317"></a><span class="lineno"> 317</span>&#160;<span class="preprocessor"> return &amp;inst.manager; \</span></div><div class="line"><a name="l00318"></a><span class="lineno"> 318</span>&#160;<span class="preprocessor"> } \</span></div><div class="line"><a name="l00319"></a><span class="lineno"> 319</span>&#160;<span class="preprocessor"> static DMLC_ATTRIBUTE_UNUSED ::dmlc::parameter::ParamManager&amp; \</span></div><div class="line"><a name="l00320"></a><span class="lineno"> 320</span>&#160;<span class="preprocessor"> __make__ ## PType ## ParamManager__ = \</span></div><div class="line"><a name="l00321"></a><span class="lineno"> 321</span>&#160;<span class="preprocessor"> (*PType::__MANAGER__()) \</span></div><div class="line"><a name="l00322"></a><span class="lineno"> 322</span>&#160;<span class="preprocessor"></span></div><div class="line"><a name="l00323"></a><span class="lineno"> 323</span>&#160;</div><div class="line"><a name="l00328"></a><span class="lineno"> 328</span>&#160;<span class="keyword">namespace </span>parameter {</div><div class="line"><a name="l00335"></a><span class="lineno"> 335</span>&#160;<span class="keyword">class </span>FieldAccessEntry {</div><div class="line"><a name="l00336"></a><span class="lineno"> 336</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l00337"></a><span class="lineno"> 337</span>&#160; FieldAccessEntry()</div><div class="line"><a name="l00338"></a><span class="lineno"> 338</span>&#160; : has_default_(false), index_(0) {}</div><div class="line"><a name="l00340"></a><span class="lineno"> 340</span>&#160; <span class="keyword">virtual</span> ~FieldAccessEntry() {}</div><div class="line"><a name="l00346"></a><span class="lineno"> 346</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> SetDefault(<span class="keywordtype">void</span> *head) <span class="keyword">const</span> = 0;</div><div class="line"><a name="l00352"></a><span class="lineno"> 352</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> Set(<span class="keywordtype">void</span> *head, <span class="keyword">const</span> std::string &amp;value) <span class="keyword">const</span> = 0;</div><div class="line"><a name="l00358"></a><span class="lineno"> 358</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">bool</span> Same(<span class="keywordtype">void</span>* head, <span class="keyword">const</span> std::string&amp; value) <span class="keyword">const</span> = 0;</div><div class="line"><a name="l00359"></a><span class="lineno"> 359</span>&#160; <span class="comment">// check if value is OK</span></div><div class="line"><a name="l00360"></a><span class="lineno"> 360</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> Check(<span class="keywordtype">void</span> *head)<span class="keyword"> const </span>{}</div><div class="line"><a name="l00365"></a><span class="lineno"> 365</span>&#160; <span class="keyword">virtual</span> std::string GetStringValue(<span class="keywordtype">void</span> *head) <span class="keyword">const</span> = 0;</div><div class="line"><a name="l00370"></a><span class="lineno"> 370</span>&#160; <span class="keyword">virtual</span> ParamFieldInfo GetFieldInfo() <span class="keyword">const</span> = 0;</div><div class="line"><a name="l00371"></a><span class="lineno"> 371</span>&#160;</div><div class="line"><a name="l00372"></a><span class="lineno"> 372</span>&#160; <span class="keyword">protected</span>:</div><div class="line"><a name="l00374"></a><span class="lineno"> 374</span>&#160; <span class="keywordtype">bool</span> has_default_;</div><div class="line"><a name="l00376"></a><span class="lineno"> 376</span>&#160; <span class="keywordtype">size_t</span> index_;</div><div class="line"><a name="l00378"></a><span class="lineno"> 378</span>&#160; std::string key_;</div><div class="line"><a name="l00380"></a><span class="lineno"> 380</span>&#160; std::string type_;</div><div class="line"><a name="l00382"></a><span class="lineno"> 382</span>&#160; std::string description_;</div><div class="line"><a name="l00383"></a><span class="lineno"> 383</span>&#160; <span class="comment">// internal offset of the field</span></div><div class="line"><a name="l00384"></a><span class="lineno"> 384</span>&#160; ptrdiff_t offset_;</div><div class="line"><a name="l00386"></a><span class="lineno"> 386</span>&#160; <span class="keywordtype">char</span>* GetRawPtr(<span class="keywordtype">void</span>* head)<span class="keyword"> const </span>{</div><div class="line"><a name="l00387"></a><span class="lineno"> 387</span>&#160; <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast&lt;</span><span class="keywordtype">char</span>*<span class="keyword">&gt;</span>(head) + offset_;</div><div class="line"><a name="l00388"></a><span class="lineno"> 388</span>&#160; }</div><div class="line"><a name="l00393"></a><span class="lineno"> 393</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> PrintDefaultValueString(std::ostream &amp;os) <span class="keyword">const</span> = 0; <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00394"></a><span class="lineno"> 394</span>&#160; <span class="comment">// allow ParamManager to modify self</span></div><div class="line"><a name="l00395"></a><span class="lineno"> 395</span>&#160; <span class="keyword">friend</span> <span class="keyword">class </span>ParamManager;</div><div class="line"><a name="l00396"></a><span class="lineno"> 396</span>&#160;};</div><div class="line"><a name="l00397"></a><span class="lineno"> 397</span>&#160;</div><div class="line"><a name="l00402"></a><span class="lineno"> 402</span>&#160;<span class="keyword">class </span>ParamManager {</div><div class="line"><a name="l00403"></a><span class="lineno"> 403</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l00405"></a><span class="lineno"> 405</span>&#160; ~ParamManager() {</div><div class="line"><a name="l00406"></a><span class="lineno"> 406</span>&#160; <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i &lt; entry_.size(); ++i) {</div><div class="line"><a name="l00407"></a><span class="lineno"> 407</span>&#160; <span class="keyword">delete</span> entry_[i];</div><div class="line"><a name="l00408"></a><span class="lineno"> 408</span>&#160; }</div><div class="line"><a name="l00409"></a><span class="lineno"> 409</span>&#160; }</div><div class="line"><a name="l00415"></a><span class="lineno"> 415</span>&#160; <span class="keyword">inline</span> FieldAccessEntry *Find(<span class="keyword">const</span> std::string &amp;key)<span class="keyword"> const </span>{</div><div class="line"><a name="l00416"></a><span class="lineno"> 416</span>&#160; std::map&lt;std::string, FieldAccessEntry*&gt;::const_iterator it =</div><div class="line"><a name="l00417"></a><span class="lineno"> 417</span>&#160; entry_map_.find(key);</div><div class="line"><a name="l00418"></a><span class="lineno"> 418</span>&#160; <span class="keywordflow">if</span> (it == entry_map_.end()) <span class="keywordflow">return</span> NULL;</div><div class="line"><a name="l00419"></a><span class="lineno"> 419</span>&#160; <span class="keywordflow">return</span> it-&gt;second;</div><div class="line"><a name="l00420"></a><span class="lineno"> 420</span>&#160; }</div><div class="line"><a name="l00431"></a><span class="lineno"> 431</span>&#160; <span class="keyword">template</span>&lt;<span class="keyword">typename</span> RandomAccessIterator&gt;</div><div class="line"><a name="l00432"></a><span class="lineno"> 432</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> RunInit(<span class="keywordtype">void</span> *head,</div><div class="line"><a name="l00433"></a><span class="lineno"> 433</span>&#160; RandomAccessIterator begin,</div><div class="line"><a name="l00434"></a><span class="lineno"> 434</span>&#160; RandomAccessIterator end,</div><div class="line"><a name="l00435"></a><span class="lineno"> 435</span>&#160; std::vector&lt;std::pair&lt;std::string, std::string&gt; &gt; *unknown_args,</div><div class="line"><a name="l00436"></a><span class="lineno"> 436</span>&#160; parameter::ParamInitOption option)<span class="keyword"> const </span>{</div><div class="line"><a name="l00437"></a><span class="lineno"> 437</span>&#160; std::set&lt;FieldAccessEntry*&gt; selected_args;</div><div class="line"><a name="l00438"></a><span class="lineno"> 438</span>&#160; RunUpdate(head, begin, end, option, unknown_args, &amp;selected_args);</div><div class="line"><a name="l00439"></a><span class="lineno"> 439</span>&#160; <span class="keywordflow">for</span> (<span class="keyword">auto</span> <span class="keyword">const</span>&amp; kv : entry_map_) {</div><div class="line"><a name="l00440"></a><span class="lineno"> 440</span>&#160; <span class="keywordflow">if</span> (selected_args.find(kv.second) == selected_args.cend()) {</div><div class="line"><a name="l00441"></a><span class="lineno"> 441</span>&#160; kv.second-&gt;SetDefault(head);</div><div class="line"><a name="l00442"></a><span class="lineno"> 442</span>&#160; }</div><div class="line"><a name="l00443"></a><span class="lineno"> 443</span>&#160; }</div><div class="line"><a name="l00444"></a><span class="lineno"> 444</span>&#160; <span class="keywordflow">for</span> (std::map&lt;std::string, FieldAccessEntry*&gt;::const_iterator it = entry_map_.begin();</div><div class="line"><a name="l00445"></a><span class="lineno"> 445</span>&#160; it != entry_map_.end(); ++it) {</div><div class="line"><a name="l00446"></a><span class="lineno"> 446</span>&#160; <span class="keywordflow">if</span> (selected_args.count(it-&gt;second) == 0) {</div><div class="line"><a name="l00447"></a><span class="lineno"> 447</span>&#160; it-&gt;second-&gt;SetDefault(head);</div><div class="line"><a name="l00448"></a><span class="lineno"> 448</span>&#160; }</div><div class="line"><a name="l00449"></a><span class="lineno"> 449</span>&#160; }</div><div class="line"><a name="l00450"></a><span class="lineno"> 450</span>&#160; }</div><div class="line"><a name="l00463"></a><span class="lineno"> 463</span>&#160; <span class="keyword">template</span> &lt;<span class="keyword">typename</span> RandomAccessIterator&gt;</div><div class="line"><a name="l00464"></a><span class="lineno"> 464</span>&#160; <span class="keywordtype">bool</span> RunUpdate(<span class="keywordtype">void</span> *head,</div><div class="line"><a name="l00465"></a><span class="lineno"> 465</span>&#160; RandomAccessIterator begin,</div><div class="line"><a name="l00466"></a><span class="lineno"> 466</span>&#160; RandomAccessIterator end,</div><div class="line"><a name="l00467"></a><span class="lineno"> 467</span>&#160; parameter::ParamInitOption option,</div><div class="line"><a name="l00468"></a><span class="lineno"> 468</span>&#160; std::vector&lt;std::pair&lt;std::string, std::string&gt; &gt; *unknown_args,</div><div class="line"><a name="l00469"></a><span class="lineno"> 469</span>&#160; std::set&lt;FieldAccessEntry*&gt;* selected_args = <span class="keyword">nullptr</span>)<span class="keyword"> const </span>{</div><div class="line"><a name="l00470"></a><span class="lineno"> 470</span>&#160; <span class="keywordtype">bool</span> changed {<span class="keyword">false</span>};</div><div class="line"><a name="l00471"></a><span class="lineno"> 471</span>&#160; <span class="keywordflow">for</span> (RandomAccessIterator it = begin; it != end; ++it) {</div><div class="line"><a name="l00472"></a><span class="lineno"> 472</span>&#160; <span class="keywordflow">if</span> (FieldAccessEntry *e = Find(it-&gt;first)) {</div><div class="line"><a name="l00473"></a><span class="lineno"> 473</span>&#160; <span class="keywordflow">if</span> (!e-&gt;Same(head, it-&gt;second)) {</div><div class="line"><a name="l00474"></a><span class="lineno"> 474</span>&#160; changed = <span class="keyword">true</span>;</div><div class="line"><a name="l00475"></a><span class="lineno"> 475</span>&#160; }</div><div class="line"><a name="l00476"></a><span class="lineno"> 476</span>&#160; e-&gt;Set(head, it-&gt;second);</div><div class="line"><a name="l00477"></a><span class="lineno"> 477</span>&#160; e-&gt;Check(head);</div><div class="line"><a name="l00478"></a><span class="lineno"> 478</span>&#160; <span class="keywordflow">if</span> (selected_args) {</div><div class="line"><a name="l00479"></a><span class="lineno"> 479</span>&#160; selected_args-&gt;insert(e);</div><div class="line"><a name="l00480"></a><span class="lineno"> 480</span>&#160; }</div><div class="line"><a name="l00481"></a><span class="lineno"> 481</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00482"></a><span class="lineno"> 482</span>&#160; <span class="keywordflow">if</span> (unknown_args != NULL) {</div><div class="line"><a name="l00483"></a><span class="lineno"> 483</span>&#160; unknown_args-&gt;push_back(*it);</div><div class="line"><a name="l00484"></a><span class="lineno"> 484</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00485"></a><span class="lineno"> 485</span>&#160; <span class="keywordflow">if</span> (option != parameter::kAllowUnknown) {</div><div class="line"><a name="l00486"></a><span class="lineno"> 486</span>&#160; <span class="keywordflow">if</span> (option == parameter::kAllowHidden &amp;&amp;</div><div class="line"><a name="l00487"></a><span class="lineno"> 487</span>&#160; it-&gt;first.length() &gt; 4 &amp;&amp;</div><div class="line"><a name="l00488"></a><span class="lineno"> 488</span>&#160; it-&gt;first.find(<span class="stringliteral">&quot;__&quot;</span>) == 0 &amp;&amp;</div><div class="line"><a name="l00489"></a><span class="lineno"> 489</span>&#160; it-&gt;first.rfind(<span class="stringliteral">&quot;__&quot;</span>) == it-&gt;first.length()-2) {</div><div class="line"><a name="l00490"></a><span class="lineno"> 490</span>&#160; <span class="keywordflow">continue</span>;</div><div class="line"><a name="l00491"></a><span class="lineno"> 491</span>&#160; }</div><div class="line"><a name="l00492"></a><span class="lineno"> 492</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00493"></a><span class="lineno"> 493</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Cannot find argument \&#39;&quot;</span> &lt;&lt; it-&gt;first &lt;&lt; <span class="stringliteral">&quot;\&#39;, Possible Arguments:\n&quot;</span>;</div><div class="line"><a name="l00494"></a><span class="lineno"> 494</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;----------------\n&quot;</span>;</div><div class="line"><a name="l00495"></a><span class="lineno"> 495</span>&#160; PrintDocString(os);</div><div class="line"><a name="l00496"></a><span class="lineno"> 496</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l00497"></a><span class="lineno"> 497</span>&#160; }</div><div class="line"><a name="l00498"></a><span class="lineno"> 498</span>&#160; }</div><div class="line"><a name="l00499"></a><span class="lineno"> 499</span>&#160; }</div><div class="line"><a name="l00500"></a><span class="lineno"> 500</span>&#160; }</div><div class="line"><a name="l00501"></a><span class="lineno"> 501</span>&#160; <span class="keywordflow">return</span> changed;</div><div class="line"><a name="l00502"></a><span class="lineno"> 502</span>&#160; }</div><div class="line"><a name="l00509"></a><span class="lineno"> 509</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> AddEntry(<span class="keyword">const</span> std::string &amp;key, FieldAccessEntry *e) {</div><div class="line"><a name="l00510"></a><span class="lineno"> 510</span>&#160; e-&gt;index_ = entry_.size();</div><div class="line"><a name="l00511"></a><span class="lineno"> 511</span>&#160; <span class="comment">// TODO(bing) better error message</span></div><div class="line"><a name="l00512"></a><span class="lineno"> 512</span>&#160; <span class="keywordflow">if</span> (entry_map_.count(key) != 0) {</div><div class="line"><a name="l00513"></a><span class="lineno"> 513</span>&#160; LOG(FATAL) &lt;&lt; <span class="stringliteral">&quot;key &quot;</span> &lt;&lt; key &lt;&lt; <span class="stringliteral">&quot; has already been registered in &quot;</span> &lt;&lt; name_;</div><div class="line"><a name="l00514"></a><span class="lineno"> 514</span>&#160; }</div><div class="line"><a name="l00515"></a><span class="lineno"> 515</span>&#160; entry_.push_back(e);</div><div class="line"><a name="l00516"></a><span class="lineno"> 516</span>&#160; entry_map_[key] = e;</div><div class="line"><a name="l00517"></a><span class="lineno"> 517</span>&#160; }</div><div class="line"><a name="l00524"></a><span class="lineno"> 524</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> AddAlias(<span class="keyword">const</span> std::string&amp; field, <span class="keyword">const</span> std::string&amp; alias) {</div><div class="line"><a name="l00525"></a><span class="lineno"> 525</span>&#160; <span class="keywordflow">if</span> (entry_map_.count(field) == 0) {</div><div class="line"><a name="l00526"></a><span class="lineno"> 526</span>&#160; LOG(FATAL) &lt;&lt; <span class="stringliteral">&quot;key &quot;</span> &lt;&lt; field &lt;&lt; <span class="stringliteral">&quot; has not been registered in &quot;</span> &lt;&lt; name_;</div><div class="line"><a name="l00527"></a><span class="lineno"> 527</span>&#160; }</div><div class="line"><a name="l00528"></a><span class="lineno"> 528</span>&#160; <span class="keywordflow">if</span> (entry_map_.count(alias) != 0) {</div><div class="line"><a name="l00529"></a><span class="lineno"> 529</span>&#160; LOG(FATAL) &lt;&lt; <span class="stringliteral">&quot;Alias &quot;</span> &lt;&lt; alias &lt;&lt; <span class="stringliteral">&quot; has already been registered in &quot;</span> &lt;&lt; name_;</div><div class="line"><a name="l00530"></a><span class="lineno"> 530</span>&#160; }</div><div class="line"><a name="l00531"></a><span class="lineno"> 531</span>&#160; entry_map_[alias] = entry_map_[field];</div><div class="line"><a name="l00532"></a><span class="lineno"> 532</span>&#160; }</div><div class="line"><a name="l00537"></a><span class="lineno"> 537</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> set_name(<span class="keyword">const</span> std::string &amp;name) {</div><div class="line"><a name="l00538"></a><span class="lineno"> 538</span>&#160; name_ = name;</div><div class="line"><a name="l00539"></a><span class="lineno"> 539</span>&#160; }</div><div class="line"><a name="l00544"></a><span class="lineno"> 544</span>&#160; <span class="keyword">inline</span> std::vector&lt;ParamFieldInfo&gt; GetFieldInfo()<span class="keyword"> const </span>{</div><div class="line"><a name="l00545"></a><span class="lineno"> 545</span>&#160; std::vector&lt;ParamFieldInfo&gt; ret(entry_.size());</div><div class="line"><a name="l00546"></a><span class="lineno"> 546</span>&#160; <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i &lt; entry_.size(); ++i) {</div><div class="line"><a name="l00547"></a><span class="lineno"> 547</span>&#160; ret[i] = entry_[i]-&gt;GetFieldInfo();</div><div class="line"><a name="l00548"></a><span class="lineno"> 548</span>&#160; }</div><div class="line"><a name="l00549"></a><span class="lineno"> 549</span>&#160; <span class="keywordflow">return</span> ret;</div><div class="line"><a name="l00550"></a><span class="lineno"> 550</span>&#160; }</div><div class="line"><a name="l00555"></a><span class="lineno"> 555</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> PrintDocString(std::ostream &amp;os)<span class="keyword"> const </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00556"></a><span class="lineno"> 556</span>&#160; <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i &lt; entry_.size(); ++i) {</div><div class="line"><a name="l00557"></a><span class="lineno"> 557</span>&#160; ParamFieldInfo info = entry_[i]-&gt;GetFieldInfo();</div><div class="line"><a name="l00558"></a><span class="lineno"> 558</span>&#160; os &lt;&lt; info.name &lt;&lt; <span class="stringliteral">&quot; : &quot;</span> &lt;&lt; info.type_info_str &lt;&lt; <span class="charliteral">&#39;\n&#39;</span>;</div><div class="line"><a name="l00559"></a><span class="lineno"> 559</span>&#160; <span class="keywordflow">if</span> (info.description.length() != 0) {</div><div class="line"><a name="l00560"></a><span class="lineno"> 560</span>&#160; os &lt;&lt; <span class="stringliteral">&quot; &quot;</span> &lt;&lt; info.description &lt;&lt; <span class="charliteral">&#39;\n&#39;</span>;</div><div class="line"><a name="l00561"></a><span class="lineno"> 561</span>&#160; }</div><div class="line"><a name="l00562"></a><span class="lineno"> 562</span>&#160; }</div><div class="line"><a name="l00563"></a><span class="lineno"> 563</span>&#160; }</div><div class="line"><a name="l00570"></a><span class="lineno"> 570</span>&#160; <span class="keyword">inline</span> std::vector&lt;std::pair&lt;std::string, std::string&gt; &gt; GetDict(<span class="keywordtype">void</span> * head)<span class="keyword"> const </span>{</div><div class="line"><a name="l00571"></a><span class="lineno"> 571</span>&#160; std::vector&lt;std::pair&lt;std::string, std::string&gt; &gt; ret;</div><div class="line"><a name="l00572"></a><span class="lineno"> 572</span>&#160; <span class="keywordflow">for</span> (std::map&lt;std::string, FieldAccessEntry*&gt;::const_iterator</div><div class="line"><a name="l00573"></a><span class="lineno"> 573</span>&#160; it = entry_map_.begin(); it != entry_map_.end(); ++it) {</div><div class="line"><a name="l00574"></a><span class="lineno"> 574</span>&#160; ret.push_back(std::make_pair(it-&gt;first, it-&gt;second-&gt;GetStringValue(head)));</div><div class="line"><a name="l00575"></a><span class="lineno"> 575</span>&#160; }</div><div class="line"><a name="l00576"></a><span class="lineno"> 576</span>&#160; <span class="keywordflow">return</span> ret;</div><div class="line"><a name="l00577"></a><span class="lineno"> 577</span>&#160; }</div><div class="line"><a name="l00584"></a><span class="lineno"> 584</span>&#160; <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Container&gt;</div><div class="line"><a name="l00585"></a><span class="lineno"> 585</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> UpdateDict(<span class="keywordtype">void</span> * head, Container* dict)<span class="keyword"> const </span>{</div><div class="line"><a name="l00586"></a><span class="lineno"> 586</span>&#160; <span class="keywordflow">for</span> (std::map&lt;std::string, FieldAccessEntry*&gt;::const_iterator</div><div class="line"><a name="l00587"></a><span class="lineno"> 587</span>&#160; it = entry_map_.begin(); it != entry_map_.end(); ++it) {</div><div class="line"><a name="l00588"></a><span class="lineno"> 588</span>&#160; (*dict)[it-&gt;first] = it-&gt;second-&gt;GetStringValue(head);</div><div class="line"><a name="l00589"></a><span class="lineno"> 589</span>&#160; }</div><div class="line"><a name="l00590"></a><span class="lineno"> 590</span>&#160; }</div><div class="line"><a name="l00591"></a><span class="lineno"> 591</span>&#160;</div><div class="line"><a name="l00592"></a><span class="lineno"> 592</span>&#160; <span class="keyword">private</span>:</div><div class="line"><a name="l00594"></a><span class="lineno"> 594</span>&#160; std::string name_;</div><div class="line"><a name="l00596"></a><span class="lineno"> 596</span>&#160; std::vector&lt;FieldAccessEntry*&gt; entry_;</div><div class="line"><a name="l00598"></a><span class="lineno"> 598</span>&#160; std::map&lt;std::string, FieldAccessEntry*&gt; entry_map_;</div><div class="line"><a name="l00599"></a><span class="lineno"> 599</span>&#160;};</div><div class="line"><a name="l00600"></a><span class="lineno"> 600</span>&#160;</div><div class="line"><a name="l00602"></a><span class="lineno"> 602</span>&#160;</div><div class="line"><a name="l00603"></a><span class="lineno"> 603</span>&#160;<span class="comment">// The following piece of code will be template heavy and less documented</span></div><div class="line"><a name="l00604"></a><span class="lineno"> 604</span>&#160;<span class="comment">// singleton parameter manager for certain type, used for initialization</span></div><div class="line"><a name="l00605"></a><span class="lineno"> 605</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">typename</span> PType&gt;</div><div class="line"><a name="l00606"></a><span class="lineno"> 606</span>&#160;<span class="keyword">struct </span>ParamManagerSingleton {</div><div class="line"><a name="l00607"></a><span class="lineno"> 607</span>&#160; ParamManager manager;</div><div class="line"><a name="l00608"></a><span class="lineno"> 608</span>&#160; <span class="keyword">explicit</span> ParamManagerSingleton(<span class="keyword">const</span> std::string &amp;param_name) {</div><div class="line"><a name="l00609"></a><span class="lineno"> 609</span>&#160; PType param;</div><div class="line"><a name="l00610"></a><span class="lineno"> 610</span>&#160; manager.set_name(param_name);</div><div class="line"><a name="l00611"></a><span class="lineno"> 611</span>&#160; param.__DECLARE__(<span class="keyword">this</span>);</div><div class="line"><a name="l00612"></a><span class="lineno"> 612</span>&#160; }</div><div class="line"><a name="l00613"></a><span class="lineno"> 613</span>&#160;};</div><div class="line"><a name="l00614"></a><span class="lineno"> 614</span>&#160;</div><div class="line"><a name="l00615"></a><span class="lineno"> 615</span>&#160;<span class="comment">// Base class of FieldEntry</span></div><div class="line"><a name="l00616"></a><span class="lineno"> 616</span>&#160;<span class="comment">// implement set_default</span></div><div class="line"><a name="l00617"></a><span class="lineno"> 617</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">typename</span> TEntry, <span class="keyword">typename</span> DType&gt;</div><div class="line"><a name="l00618"></a><span class="lineno"> 618</span>&#160;<span class="keyword">class </span>FieldEntryBase : <span class="keyword">public</span> FieldAccessEntry {</div><div class="line"><a name="l00619"></a><span class="lineno"> 619</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l00620"></a><span class="lineno"> 620</span>&#160; <span class="comment">// entry type</span></div><div class="line"><a name="l00621"></a><span class="lineno"> 621</span>&#160; <span class="keyword">typedef</span> TEntry EntryType;</div><div class="line"><a name="l00622"></a><span class="lineno"> 622</span>&#160; <span class="comment">// implement set value</span></div><div class="line"><a name="l00623"></a><span class="lineno"> 623</span>&#160; <span class="keywordtype">void</span> Set(<span class="keywordtype">void</span> *head, <span class="keyword">const</span> std::string &amp;value)<span class="keyword"> const override </span>{</div><div class="line"><a name="l00624"></a><span class="lineno"> 624</span>&#160; std::istringstream is(value);</div><div class="line"><a name="l00625"></a><span class="lineno"> 625</span>&#160; is &gt;&gt; this-&gt;Get(head);</div><div class="line"><a name="l00626"></a><span class="lineno"> 626</span>&#160; <span class="keywordflow">if</span> (!is.fail()) {</div><div class="line"><a name="l00627"></a><span class="lineno"> 627</span>&#160; <span class="keywordflow">while</span> (!is.eof()) {</div><div class="line"><a name="l00628"></a><span class="lineno"> 628</span>&#160; <span class="keywordtype">int</span> ch = is.get();</div><div class="line"><a name="l00629"></a><span class="lineno"> 629</span>&#160; <span class="keywordflow">if</span> (ch == EOF) {</div><div class="line"><a name="l00630"></a><span class="lineno"> 630</span>&#160; is.clear(); <span class="keywordflow">break</span>;</div><div class="line"><a name="l00631"></a><span class="lineno"> 631</span>&#160; }</div><div class="line"><a name="l00632"></a><span class="lineno"> 632</span>&#160; <span class="keywordflow">if</span> (!<a class="code" href="namespacedmlc.html#a52dcf01c9ba22be9b08e455194fb2ab3">isspace</a>(ch)) {</div><div class="line"><a name="l00633"></a><span class="lineno"> 633</span>&#160; is.setstate(std::ios::failbit); <span class="keywordflow">break</span>;</div><div class="line"><a name="l00634"></a><span class="lineno"> 634</span>&#160; }</div><div class="line"><a name="l00635"></a><span class="lineno"> 635</span>&#160; }</div><div class="line"><a name="l00636"></a><span class="lineno"> 636</span>&#160; }</div><div class="line"><a name="l00637"></a><span class="lineno"> 637</span>&#160;</div><div class="line"><a name="l00638"></a><span class="lineno"> 638</span>&#160; <span class="keywordflow">if</span> (is.fail()) {</div><div class="line"><a name="l00639"></a><span class="lineno"> 639</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00640"></a><span class="lineno"> 640</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Invalid Parameter format for &quot;</span> &lt;&lt; key_</div><div class="line"><a name="l00641"></a><span class="lineno"> 641</span>&#160; &lt;&lt; <span class="stringliteral">&quot; expect &quot;</span> &lt;&lt; type_ &lt;&lt; <span class="stringliteral">&quot; but value=\&#39;&quot;</span> &lt;&lt; value&lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l00642"></a><span class="lineno"> 642</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l00643"></a><span class="lineno"> 643</span>&#160; }</div><div class="line"><a name="l00644"></a><span class="lineno"> 644</span>&#160; }</div><div class="line"><a name="l00645"></a><span class="lineno"> 645</span>&#160;</div><div class="line"><a name="l00646"></a><span class="lineno"> 646</span>&#160; <span class="comment">// Don&#39;t check this function for Undefined Behavior (UB), as the function</span></div><div class="line"><a name="l00647"></a><span class="lineno"> 647</span>&#160; <span class="comment">// reads from a possibly uninitialized field</span></div><div class="line"><a name="l00648"></a><span class="lineno"> 648</span>&#160; <a class="code" href="3rdparty_2dmlc-core_2include_2dmlc_2base_8h.html#ae48f57de53e5271fa1394e04cef5dd23">DMLC_SUPPRESS_UBSAN</a></div><div class="line"><a name="l00649"></a><span class="lineno"> 649</span>&#160; <span class="keywordtype">bool</span> Same(<span class="keywordtype">void</span>* head, std::string <span class="keyword">const</span>&amp; value)<span class="keyword"> const override </span>{</div><div class="line"><a name="l00650"></a><span class="lineno"> 650</span>&#160; DType old = this-&gt;Get(head);</div><div class="line"><a name="l00651"></a><span class="lineno"> 651</span>&#160; DType now;</div><div class="line"><a name="l00652"></a><span class="lineno"> 652</span>&#160; std::istringstream is(value);</div><div class="line"><a name="l00653"></a><span class="lineno"> 653</span>&#160; is &gt;&gt; now;</div><div class="line"><a name="l00654"></a><span class="lineno"> 654</span>&#160; <span class="comment">// don&#39;t require = operator</span></div><div class="line"><a name="l00655"></a><span class="lineno"> 655</span>&#160; <span class="keywordtype">bool</span> is_same = std::equal(</div><div class="line"><a name="l00656"></a><span class="lineno"> 656</span>&#160; reinterpret_cast&lt;char*&gt;(&amp;now), reinterpret_cast&lt;char*&gt;(&amp;now) + <span class="keyword">sizeof</span>(now),</div><div class="line"><a name="l00657"></a><span class="lineno"> 657</span>&#160; reinterpret_cast&lt;char*&gt;(&amp;old));</div><div class="line"><a name="l00658"></a><span class="lineno"> 658</span>&#160; <span class="keywordflow">return</span> is_same;</div><div class="line"><a name="l00659"></a><span class="lineno"> 659</span>&#160; }</div><div class="line"><a name="l00660"></a><span class="lineno"> 660</span>&#160; std::string GetStringValue(<span class="keywordtype">void</span> *head)<span class="keyword"> const override </span>{</div><div class="line"><a name="l00661"></a><span class="lineno"> 661</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00662"></a><span class="lineno"> 662</span>&#160; PrintValue(os, this-&gt;Get(head));</div><div class="line"><a name="l00663"></a><span class="lineno"> 663</span>&#160; <span class="keywordflow">return</span> os.str();</div><div class="line"><a name="l00664"></a><span class="lineno"> 664</span>&#160; }</div><div class="line"><a name="l00665"></a><span class="lineno"> 665</span>&#160; ParamFieldInfo GetFieldInfo()<span class="keyword"> const override </span>{</div><div class="line"><a name="l00666"></a><span class="lineno"> 666</span>&#160; ParamFieldInfo info;</div><div class="line"><a name="l00667"></a><span class="lineno"> 667</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00668"></a><span class="lineno"> 668</span>&#160; info.name = key_;</div><div class="line"><a name="l00669"></a><span class="lineno"> 669</span>&#160; info.type = type_;</div><div class="line"><a name="l00670"></a><span class="lineno"> 670</span>&#160; os &lt;&lt; type_;</div><div class="line"><a name="l00671"></a><span class="lineno"> 671</span>&#160; <span class="keywordflow">if</span> (has_default_) {</div><div class="line"><a name="l00672"></a><span class="lineno"> 672</span>&#160; os &lt;&lt; <span class="charliteral">&#39;,&#39;</span> &lt;&lt; <span class="stringliteral">&quot; optional, default=&quot;</span>;</div><div class="line"><a name="l00673"></a><span class="lineno"> 673</span>&#160; PrintDefaultValueString(os);</div><div class="line"><a name="l00674"></a><span class="lineno"> 674</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00675"></a><span class="lineno"> 675</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;, required&quot;</span>;</div><div class="line"><a name="l00676"></a><span class="lineno"> 676</span>&#160; }</div><div class="line"><a name="l00677"></a><span class="lineno"> 677</span>&#160; info.type_info_str = os.str();</div><div class="line"><a name="l00678"></a><span class="lineno"> 678</span>&#160; info.description = description_;</div><div class="line"><a name="l00679"></a><span class="lineno"> 679</span>&#160; <span class="keywordflow">return</span> info;</div><div class="line"><a name="l00680"></a><span class="lineno"> 680</span>&#160; }</div><div class="line"><a name="l00681"></a><span class="lineno"> 681</span>&#160; <span class="comment">// implement set head to default value</span></div><div class="line"><a name="l00682"></a><span class="lineno"> 682</span>&#160; <span class="keywordtype">void</span> SetDefault(<span class="keywordtype">void</span> *head)<span class="keyword"> const override </span>{</div><div class="line"><a name="l00683"></a><span class="lineno"> 683</span>&#160; <span class="keywordflow">if</span> (!has_default_) {</div><div class="line"><a name="l00684"></a><span class="lineno"> 684</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00685"></a><span class="lineno"> 685</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Required parameter &quot;</span> &lt;&lt; key_</div><div class="line"><a name="l00686"></a><span class="lineno"> 686</span>&#160; &lt;&lt; <span class="stringliteral">&quot; of &quot;</span> &lt;&lt; type_ &lt;&lt; <span class="stringliteral">&quot; is not presented&quot;</span>;</div><div class="line"><a name="l00687"></a><span class="lineno"> 687</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l00688"></a><span class="lineno"> 688</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00689"></a><span class="lineno"> 689</span>&#160; this-&gt;Get(head) = default_value_;</div><div class="line"><a name="l00690"></a><span class="lineno"> 690</span>&#160; }</div><div class="line"><a name="l00691"></a><span class="lineno"> 691</span>&#160; }</div><div class="line"><a name="l00692"></a><span class="lineno"> 692</span>&#160; <span class="comment">// return reference of self as derived type</span></div><div class="line"><a name="l00693"></a><span class="lineno"> 693</span>&#160; <span class="keyword">inline</span> TEntry &amp;<span class="keyword">self</span>() {</div><div class="line"><a name="l00694"></a><span class="lineno"> 694</span>&#160; <span class="keywordflow">return</span> *(<span class="keyword">static_cast&lt;</span>TEntry*<span class="keyword">&gt;</span>(<span class="keyword">this</span>));</div><div class="line"><a name="l00695"></a><span class="lineno"> 695</span>&#160; }</div><div class="line"><a name="l00696"></a><span class="lineno"> 696</span>&#160; <span class="comment">// implement set_default</span></div><div class="line"><a name="l00697"></a><span class="lineno"> 697</span>&#160; <span class="keyword">inline</span> TEntry &amp;set_default(<span class="keyword">const</span> DType &amp;default_value) {</div><div class="line"><a name="l00698"></a><span class="lineno"> 698</span>&#160; default_value_ = default_value;</div><div class="line"><a name="l00699"></a><span class="lineno"> 699</span>&#160; has_default_ = <span class="keyword">true</span>;</div><div class="line"><a name="l00700"></a><span class="lineno"> 700</span>&#160; <span class="comment">// return self to allow chaining</span></div><div class="line"><a name="l00701"></a><span class="lineno"> 701</span>&#160; <span class="keywordflow">return</span> this-&gt;<span class="keyword">self</span>();</div><div class="line"><a name="l00702"></a><span class="lineno"> 702</span>&#160; }</div><div class="line"><a name="l00703"></a><span class="lineno"> 703</span>&#160; <span class="comment">// implement describe</span></div><div class="line"><a name="l00704"></a><span class="lineno"> 704</span>&#160; <span class="keyword">inline</span> TEntry &amp;describe(<span class="keyword">const</span> std::string &amp;description) {</div><div class="line"><a name="l00705"></a><span class="lineno"> 705</span>&#160; description_ = description;</div><div class="line"><a name="l00706"></a><span class="lineno"> 706</span>&#160; <span class="comment">// return self to allow chaining</span></div><div class="line"><a name="l00707"></a><span class="lineno"> 707</span>&#160; <span class="keywordflow">return</span> this-&gt;<span class="keyword">self</span>();</div><div class="line"><a name="l00708"></a><span class="lineno"> 708</span>&#160; }</div><div class="line"><a name="l00709"></a><span class="lineno"> 709</span>&#160; <span class="comment">// initialization function</span></div><div class="line"><a name="l00710"></a><span class="lineno"> 710</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> Init(<span class="keyword">const</span> std::string &amp;key,</div><div class="line"><a name="l00711"></a><span class="lineno"> 711</span>&#160; <span class="keywordtype">void</span> *head, DType &amp;ref) { <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00712"></a><span class="lineno"> 712</span>&#160; this-&gt;key_ = key;</div><div class="line"><a name="l00713"></a><span class="lineno"> 713</span>&#160; <span class="keywordflow">if</span> (this-&gt;type_.length() == 0) {</div><div class="line"><a name="l00714"></a><span class="lineno"> 714</span>&#160; this-&gt;type_ = dmlc::type_name&lt;DType&gt;();</div><div class="line"><a name="l00715"></a><span class="lineno"> 715</span>&#160; }</div><div class="line"><a name="l00716"></a><span class="lineno"> 716</span>&#160; this-&gt;offset_ = ((<span class="keywordtype">char</span>*)&amp;ref) - ((<span class="keywordtype">char</span>*)head); <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00717"></a><span class="lineno"> 717</span>&#160; }</div><div class="line"><a name="l00718"></a><span class="lineno"> 718</span>&#160;</div><div class="line"><a name="l00719"></a><span class="lineno"> 719</span>&#160; <span class="keyword">protected</span>:</div><div class="line"><a name="l00720"></a><span class="lineno"> 720</span>&#160; <span class="comment">// print the value</span></div><div class="line"><a name="l00721"></a><span class="lineno"> 721</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> PrintValue(std::ostream &amp;os, DType value)<span class="keyword"> const </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00722"></a><span class="lineno"> 722</span>&#160; os &lt;&lt; value;</div><div class="line"><a name="l00723"></a><span class="lineno"> 723</span>&#160; }</div><div class="line"><a name="l00724"></a><span class="lineno"> 724</span>&#160; <span class="keywordtype">void</span> PrintDefaultValueString(std::ostream &amp;os)<span class="keyword"> const override </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00725"></a><span class="lineno"> 725</span>&#160; PrintValue(os, default_value_);</div><div class="line"><a name="l00726"></a><span class="lineno"> 726</span>&#160; }</div><div class="line"><a name="l00727"></a><span class="lineno"> 727</span>&#160; <span class="comment">// get the internal representation of parameter</span></div><div class="line"><a name="l00728"></a><span class="lineno"> 728</span>&#160; <span class="comment">// for example if this entry corresponds field param.learning_rate</span></div><div class="line"><a name="l00729"></a><span class="lineno"> 729</span>&#160; <span class="comment">// then Get(&amp;param) will return reference to param.learning_rate</span></div><div class="line"><a name="l00730"></a><span class="lineno"> 730</span>&#160; <span class="keyword">inline</span> DType &amp;Get(<span class="keywordtype">void</span> *head)<span class="keyword"> const </span>{</div><div class="line"><a name="l00731"></a><span class="lineno"> 731</span>&#160; <span class="keywordflow">return</span> *(DType*)this-&gt;GetRawPtr(head); <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00732"></a><span class="lineno"> 732</span>&#160; }</div><div class="line"><a name="l00733"></a><span class="lineno"> 733</span>&#160; <span class="comment">// default value of field</span></div><div class="line"><a name="l00734"></a><span class="lineno"> 734</span>&#160; DType default_value_;</div><div class="line"><a name="l00735"></a><span class="lineno"> 735</span>&#160;};</div><div class="line"><a name="l00736"></a><span class="lineno"> 736</span>&#160;</div><div class="line"><a name="l00737"></a><span class="lineno"> 737</span>&#160;<span class="comment">// parameter base for numeric types that have range</span></div><div class="line"><a name="l00738"></a><span class="lineno"> 738</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">typename</span> TEntry, <span class="keyword">typename</span> DType&gt;</div><div class="line"><a name="l00739"></a><span class="lineno"> 739</span>&#160;<span class="keyword">class </span>FieldEntryNumeric</div><div class="line"><a name="l00740"></a><span class="lineno"> 740</span>&#160; : <span class="keyword">public</span> FieldEntryBase&lt;TEntry, DType&gt; {</div><div class="line"><a name="l00741"></a><span class="lineno"> 741</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l00742"></a><span class="lineno"> 742</span>&#160; FieldEntryNumeric()</div><div class="line"><a name="l00743"></a><span class="lineno"> 743</span>&#160; : has_begin_(false), has_end_(false) {}</div><div class="line"><a name="l00744"></a><span class="lineno"> 744</span>&#160; <span class="comment">// implement set_range</span></div><div class="line"><a name="l00745"></a><span class="lineno"> 745</span>&#160; <span class="keyword">virtual</span> TEntry &amp;set_range(DType begin, DType end) {</div><div class="line"><a name="l00746"></a><span class="lineno"> 746</span>&#160; begin_ = begin; end_ = end;</div><div class="line"><a name="l00747"></a><span class="lineno"> 747</span>&#160; has_begin_ = <span class="keyword">true</span>; has_end_ = <span class="keyword">true</span>;</div><div class="line"><a name="l00748"></a><span class="lineno"> 748</span>&#160; <span class="keywordflow">return</span> this-&gt;<span class="keyword">self</span>();</div><div class="line"><a name="l00749"></a><span class="lineno"> 749</span>&#160; }</div><div class="line"><a name="l00750"></a><span class="lineno"> 750</span>&#160; <span class="comment">// implement set_range</span></div><div class="line"><a name="l00751"></a><span class="lineno"> 751</span>&#160; <span class="keyword">virtual</span> TEntry &amp;set_lower_bound(DType begin) {</div><div class="line"><a name="l00752"></a><span class="lineno"> 752</span>&#160; begin_ = begin; has_begin_ = <span class="keyword">true</span>;</div><div class="line"><a name="l00753"></a><span class="lineno"> 753</span>&#160; <span class="keywordflow">return</span> this-&gt;<span class="keyword">self</span>();</div><div class="line"><a name="l00754"></a><span class="lineno"> 754</span>&#160; }</div><div class="line"><a name="l00755"></a><span class="lineno"> 755</span>&#160; <span class="comment">// consistency check for numeric ranges</span></div><div class="line"><a name="l00756"></a><span class="lineno"> 756</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> Check(<span class="keywordtype">void</span> *head)<span class="keyword"> const </span>{</div><div class="line"><a name="l00757"></a><span class="lineno"> 757</span>&#160; FieldEntryBase&lt;TEntry, DType&gt;::Check(head);</div><div class="line"><a name="l00758"></a><span class="lineno"> 758</span>&#160; DType v = this-&gt;Get(head);</div><div class="line"><a name="l00759"></a><span class="lineno"> 759</span>&#160; <span class="keywordflow">if</span> (has_begin_ &amp;&amp; has_end_) {</div><div class="line"><a name="l00760"></a><span class="lineno"> 760</span>&#160; <span class="keywordflow">if</span> (v &lt; begin_ || v &gt; end_) {</div><div class="line"><a name="l00761"></a><span class="lineno"> 761</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00762"></a><span class="lineno"> 762</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;value &quot;</span> &lt;&lt; v &lt;&lt; <span class="stringliteral">&quot; for Parameter &quot;</span> &lt;&lt; this-&gt;key_</div><div class="line"><a name="l00763"></a><span class="lineno"> 763</span>&#160; &lt;&lt; <span class="stringliteral">&quot; exceed bound [&quot;</span> &lt;&lt; begin_ &lt;&lt; <span class="charliteral">&#39;,&#39;</span> &lt;&lt; end_ &lt;&lt;<span class="charliteral">&#39;]&#39;</span> &lt;&lt; <span class="charliteral">&#39;\n&#39;</span>;</div><div class="line"><a name="l00764"></a><span class="lineno"> 764</span>&#160; os &lt;&lt; this-&gt;key_ &lt;&lt; <span class="stringliteral">&quot;: &quot;</span> &lt;&lt; this-&gt;description_;</div><div class="line"><a name="l00765"></a><span class="lineno"> 765</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l00766"></a><span class="lineno"> 766</span>&#160; }</div><div class="line"><a name="l00767"></a><span class="lineno"> 767</span>&#160; } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (has_begin_ &amp;&amp; v &lt; begin_) {</div><div class="line"><a name="l00768"></a><span class="lineno"> 768</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00769"></a><span class="lineno"> 769</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;value &quot;</span> &lt;&lt; v &lt;&lt; <span class="stringliteral">&quot; for Parameter &quot;</span> &lt;&lt; this-&gt;key_</div><div class="line"><a name="l00770"></a><span class="lineno"> 770</span>&#160; &lt;&lt; <span class="stringliteral">&quot; should be greater equal to &quot;</span> &lt;&lt; begin_ &lt;&lt; <span class="charliteral">&#39;\n&#39;</span>;</div><div class="line"><a name="l00771"></a><span class="lineno"> 771</span>&#160; os &lt;&lt; this-&gt;key_ &lt;&lt; <span class="stringliteral">&quot;: &quot;</span> &lt;&lt; this-&gt;description_;</div><div class="line"><a name="l00772"></a><span class="lineno"> 772</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l00773"></a><span class="lineno"> 773</span>&#160; } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (has_end_ &amp;&amp; v &gt; end_) {</div><div class="line"><a name="l00774"></a><span class="lineno"> 774</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00775"></a><span class="lineno"> 775</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;value &quot;</span> &lt;&lt; v &lt;&lt; <span class="stringliteral">&quot; for Parameter &quot;</span> &lt;&lt; this-&gt;key_</div><div class="line"><a name="l00776"></a><span class="lineno"> 776</span>&#160; &lt;&lt; <span class="stringliteral">&quot; should be smaller equal to &quot;</span> &lt;&lt; end_ &lt;&lt; <span class="charliteral">&#39;\n&#39;</span>;</div><div class="line"><a name="l00777"></a><span class="lineno"> 777</span>&#160; os &lt;&lt; this-&gt;key_ &lt;&lt; <span class="stringliteral">&quot;: &quot;</span> &lt;&lt; this-&gt;description_;</div><div class="line"><a name="l00778"></a><span class="lineno"> 778</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l00779"></a><span class="lineno"> 779</span>&#160; }</div><div class="line"><a name="l00780"></a><span class="lineno"> 780</span>&#160; }</div><div class="line"><a name="l00781"></a><span class="lineno"> 781</span>&#160;</div><div class="line"><a name="l00782"></a><span class="lineno"> 782</span>&#160; <span class="keyword">protected</span>:</div><div class="line"><a name="l00783"></a><span class="lineno"> 783</span>&#160; <span class="comment">// whether it have begin and end range</span></div><div class="line"><a name="l00784"></a><span class="lineno"> 784</span>&#160; <span class="keywordtype">bool</span> has_begin_, has_end_;</div><div class="line"><a name="l00785"></a><span class="lineno"> 785</span>&#160; <span class="comment">// data bound</span></div><div class="line"><a name="l00786"></a><span class="lineno"> 786</span>&#160; DType begin_, end_;</div><div class="line"><a name="l00787"></a><span class="lineno"> 787</span>&#160;};</div><div class="line"><a name="l00788"></a><span class="lineno"> 788</span>&#160;</div><div class="line"><a name="l00794"></a><span class="lineno"> 794</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">typename</span> DType&gt;</div><div class="line"><a name="l00795"></a><span class="lineno"> 795</span>&#160;<span class="keyword">class </span>FieldEntry :</div><div class="line"><a name="l00796"></a><span class="lineno"> 796</span>&#160; <span class="keyword">public</span> IfThenElseType&lt;dmlc::is_arithmetic&lt;DType&gt;::value,</div><div class="line"><a name="l00797"></a><span class="lineno"> 797</span>&#160; FieldEntryNumeric&lt;FieldEntry&lt;DType&gt;, DType&gt;,</div><div class="line"><a name="l00798"></a><span class="lineno"> 798</span>&#160; FieldEntryBase&lt;FieldEntry&lt;DType&gt;, DType&gt; &gt;::Type {</div><div class="line"><a name="l00799"></a><span class="lineno"> 799</span>&#160;};</div><div class="line"><a name="l00800"></a><span class="lineno"> 800</span>&#160;</div><div class="line"><a name="l00801"></a><span class="lineno"> 801</span>&#160;<span class="comment">// specialize define for int(enum)</span></div><div class="line"><a name="l00802"></a><span class="lineno"> 802</span>&#160;<span class="keyword">template</span>&lt;&gt;</div><div class="line"><a name="l00803"></a><span class="lineno"> 803</span>&#160;<span class="keyword">class </span>FieldEntry&lt;int&gt;</div><div class="line"><a name="l00804"></a><span class="lineno"> 804</span>&#160; : <span class="keyword">public</span> FieldEntryNumeric&lt;FieldEntry&lt;int&gt;, int&gt; {</div><div class="line"><a name="l00805"></a><span class="lineno"> 805</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l00806"></a><span class="lineno"> 806</span>&#160; <span class="comment">// construct</span></div><div class="line"><a name="l00807"></a><span class="lineno"> 807</span>&#160; FieldEntry&lt;int&gt;() : is_enum_(<span class="keyword">false</span>) {}</div><div class="line"><a name="l00808"></a><span class="lineno"> 808</span>&#160; <span class="comment">// parent</span></div><div class="line"><a name="l00809"></a><span class="lineno"> 809</span>&#160; <span class="keyword">typedef</span> FieldEntryNumeric&lt;FieldEntry&lt;int&gt;, <span class="keywordtype">int</span>&gt; Parent;</div><div class="line"><a name="l00810"></a><span class="lineno"> 810</span>&#160; <span class="comment">// override set</span></div><div class="line"><a name="l00811"></a><span class="lineno"> 811</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> Set(<span class="keywordtype">void</span> *head, <span class="keyword">const</span> std::string &amp;value)<span class="keyword"> const </span>{</div><div class="line"><a name="l00812"></a><span class="lineno"> 812</span>&#160; <span class="keywordflow">if</span> (is_enum_) {</div><div class="line"><a name="l00813"></a><span class="lineno"> 813</span>&#160; std::map&lt;std::string, int&gt;::const_iterator it = enum_map_.find(value);</div><div class="line"><a name="l00814"></a><span class="lineno"> 814</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00815"></a><span class="lineno"> 815</span>&#160; <span class="keywordflow">if</span> (it == enum_map_.end()) {</div><div class="line"><a name="l00816"></a><span class="lineno"> 816</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Invalid Input: \&#39;&quot;</span> &lt;&lt; value;</div><div class="line"><a name="l00817"></a><span class="lineno"> 817</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;\&#39;, valid values are: &quot;</span>;</div><div class="line"><a name="l00818"></a><span class="lineno"> 818</span>&#160; PrintEnums(os);</div><div class="line"><a name="l00819"></a><span class="lineno"> 819</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l00820"></a><span class="lineno"> 820</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00821"></a><span class="lineno"> 821</span>&#160; os &lt;&lt; it-&gt;second;</div><div class="line"><a name="l00822"></a><span class="lineno"> 822</span>&#160; Parent::Set(head, os.str());</div><div class="line"><a name="l00823"></a><span class="lineno"> 823</span>&#160; }</div><div class="line"><a name="l00824"></a><span class="lineno"> 824</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00825"></a><span class="lineno"> 825</span>&#160; Parent::Set(head, value);</div><div class="line"><a name="l00826"></a><span class="lineno"> 826</span>&#160; }</div><div class="line"><a name="l00827"></a><span class="lineno"> 827</span>&#160; }</div><div class="line"><a name="l00828"></a><span class="lineno"> 828</span>&#160; <span class="keyword">virtual</span> ParamFieldInfo GetFieldInfo()<span class="keyword"> const </span>{</div><div class="line"><a name="l00829"></a><span class="lineno"> 829</span>&#160; <span class="keywordflow">if</span> (is_enum_) {</div><div class="line"><a name="l00830"></a><span class="lineno"> 830</span>&#160; ParamFieldInfo info;</div><div class="line"><a name="l00831"></a><span class="lineno"> 831</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00832"></a><span class="lineno"> 832</span>&#160; info.name = key_;</div><div class="line"><a name="l00833"></a><span class="lineno"> 833</span>&#160; info.type = type_;</div><div class="line"><a name="l00834"></a><span class="lineno"> 834</span>&#160; PrintEnums(os);</div><div class="line"><a name="l00835"></a><span class="lineno"> 835</span>&#160; <span class="keywordflow">if</span> (has_default_) {</div><div class="line"><a name="l00836"></a><span class="lineno"> 836</span>&#160; os &lt;&lt; <span class="charliteral">&#39;,&#39;</span> &lt;&lt; <span class="stringliteral">&quot;optional, default=&quot;</span>;</div><div class="line"><a name="l00837"></a><span class="lineno"> 837</span>&#160; PrintDefaultValueString(os);</div><div class="line"><a name="l00838"></a><span class="lineno"> 838</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00839"></a><span class="lineno"> 839</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;, required&quot;</span>;</div><div class="line"><a name="l00840"></a><span class="lineno"> 840</span>&#160; }</div><div class="line"><a name="l00841"></a><span class="lineno"> 841</span>&#160; info.type_info_str = os.str();</div><div class="line"><a name="l00842"></a><span class="lineno"> 842</span>&#160; info.description = description_;</div><div class="line"><a name="l00843"></a><span class="lineno"> 843</span>&#160; <span class="keywordflow">return</span> info;</div><div class="line"><a name="l00844"></a><span class="lineno"> 844</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00845"></a><span class="lineno"> 845</span>&#160; <span class="keywordflow">return</span> Parent::GetFieldInfo();</div><div class="line"><a name="l00846"></a><span class="lineno"> 846</span>&#160; }</div><div class="line"><a name="l00847"></a><span class="lineno"> 847</span>&#160; }</div><div class="line"><a name="l00848"></a><span class="lineno"> 848</span>&#160; <span class="comment">// add enum</span></div><div class="line"><a name="l00849"></a><span class="lineno"> 849</span>&#160; <span class="keyword">inline</span> FieldEntry&lt;int&gt; &amp;add_enum(<span class="keyword">const</span> std::string &amp;key, <span class="keywordtype">int</span> value) {</div><div class="line"><a name="l00850"></a><span class="lineno"> 850</span>&#160; <span class="keywordflow">if</span> ((enum_map_.size() != 0 &amp;&amp; enum_map_.count(key) != 0) || \</div><div class="line"><a name="l00851"></a><span class="lineno"> 851</span>&#160; enum_back_map_.count(value) != 0) {</div><div class="line"><a name="l00852"></a><span class="lineno"> 852</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00853"></a><span class="lineno"> 853</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Enum &quot;</span> &lt;&lt; <span class="stringliteral">&quot;(&quot;</span> &lt;&lt; key &lt;&lt; <span class="stringliteral">&quot;: &quot;</span> &lt;&lt; value &lt;&lt; <span class="stringliteral">&quot; exisit!&quot;</span> &lt;&lt; <span class="stringliteral">&quot;)\n&quot;</span>;</div><div class="line"><a name="l00854"></a><span class="lineno"> 854</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Enums: &quot;</span>;</div><div class="line"><a name="l00855"></a><span class="lineno"> 855</span>&#160; <span class="keywordflow">for</span> (std::map&lt;std::string, int&gt;::const_iterator it = enum_map_.begin();</div><div class="line"><a name="l00856"></a><span class="lineno"> 856</span>&#160; it != enum_map_.end(); ++it) {</div><div class="line"><a name="l00857"></a><span class="lineno"> 857</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;(&quot;</span> &lt;&lt; it-&gt;first &lt;&lt; <span class="stringliteral">&quot;: &quot;</span> &lt;&lt; it-&gt;second &lt;&lt; <span class="stringliteral">&quot;), &quot;</span>;</div><div class="line"><a name="l00858"></a><span class="lineno"> 858</span>&#160; }</div><div class="line"><a name="l00859"></a><span class="lineno"> 859</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l00860"></a><span class="lineno"> 860</span>&#160; }</div><div class="line"><a name="l00861"></a><span class="lineno"> 861</span>&#160; enum_map_[key] = value;</div><div class="line"><a name="l00862"></a><span class="lineno"> 862</span>&#160; enum_back_map_[value] = key;</div><div class="line"><a name="l00863"></a><span class="lineno"> 863</span>&#160; is_enum_ = <span class="keyword">true</span>;</div><div class="line"><a name="l00864"></a><span class="lineno"> 864</span>&#160; <span class="keywordflow">return</span> this-&gt;<span class="keyword">self</span>();</div><div class="line"><a name="l00865"></a><span class="lineno"> 865</span>&#160; }</div><div class="line"><a name="l00866"></a><span class="lineno"> 866</span>&#160;</div><div class="line"><a name="l00867"></a><span class="lineno"> 867</span>&#160; <span class="keyword">protected</span>:</div><div class="line"><a name="l00868"></a><span class="lineno"> 868</span>&#160; <span class="comment">// enum flag</span></div><div class="line"><a name="l00869"></a><span class="lineno"> 869</span>&#160; <span class="keywordtype">bool</span> is_enum_;</div><div class="line"><a name="l00870"></a><span class="lineno"> 870</span>&#160; <span class="comment">// enum map</span></div><div class="line"><a name="l00871"></a><span class="lineno"> 871</span>&#160; std::map&lt;std::string, int&gt; enum_map_;</div><div class="line"><a name="l00872"></a><span class="lineno"> 872</span>&#160; <span class="comment">// enum map</span></div><div class="line"><a name="l00873"></a><span class="lineno"> 873</span>&#160; std::map&lt;int, std::string&gt; enum_back_map_;</div><div class="line"><a name="l00874"></a><span class="lineno"> 874</span>&#160; <span class="comment">// override print behavior</span></div><div class="line"><a name="l00875"></a><span class="lineno"> 875</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> PrintDefaultValueString(std::ostream &amp;os)<span class="keyword"> const </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00876"></a><span class="lineno"> 876</span>&#160; os &lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l00877"></a><span class="lineno"> 877</span>&#160; PrintValue(os, default_value_);</div><div class="line"><a name="l00878"></a><span class="lineno"> 878</span>&#160; os &lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l00879"></a><span class="lineno"> 879</span>&#160; }</div><div class="line"><a name="l00880"></a><span class="lineno"> 880</span>&#160; <span class="comment">// override print default</span></div><div class="line"><a name="l00881"></a><span class="lineno"> 881</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> PrintValue(std::ostream &amp;os, <span class="keywordtype">int</span> value)<span class="keyword"> const </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00882"></a><span class="lineno"> 882</span>&#160; <span class="keywordflow">if</span> (is_enum_) {</div><div class="line"><a name="l00883"></a><span class="lineno"> 883</span>&#160; CHECK_NE(enum_back_map_.count(value), 0U)</div><div class="line"><a name="l00884"></a><span class="lineno"> 884</span>&#160; &lt;&lt; <span class="stringliteral">&quot;Value not found in enum declared&quot;</span>;</div><div class="line"><a name="l00885"></a><span class="lineno"> 885</span>&#160; os &lt;&lt; enum_back_map_.at(value);</div><div class="line"><a name="l00886"></a><span class="lineno"> 886</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00887"></a><span class="lineno"> 887</span>&#160; os &lt;&lt; value;</div><div class="line"><a name="l00888"></a><span class="lineno"> 888</span>&#160; }</div><div class="line"><a name="l00889"></a><span class="lineno"> 889</span>&#160; }</div><div class="line"><a name="l00890"></a><span class="lineno"> 890</span>&#160;</div><div class="line"><a name="l00891"></a><span class="lineno"> 891</span>&#160;</div><div class="line"><a name="l00892"></a><span class="lineno"> 892</span>&#160; <span class="keyword">private</span>:</div><div class="line"><a name="l00893"></a><span class="lineno"> 893</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> PrintEnums(std::ostream &amp;os)<span class="keyword"> const </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00894"></a><span class="lineno"> 894</span>&#160; os &lt;&lt; <span class="charliteral">&#39;{&#39;</span>;</div><div class="line"><a name="l00895"></a><span class="lineno"> 895</span>&#160; <span class="keywordflow">for</span> (std::map&lt;std::string, int&gt;::const_iterator</div><div class="line"><a name="l00896"></a><span class="lineno"> 896</span>&#160; it = enum_map_.begin(); it != enum_map_.end(); ++it) {</div><div class="line"><a name="l00897"></a><span class="lineno"> 897</span>&#160; <span class="keywordflow">if</span> (it != enum_map_.begin()) {</div><div class="line"><a name="l00898"></a><span class="lineno"> 898</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;, &quot;</span>;</div><div class="line"><a name="l00899"></a><span class="lineno"> 899</span>&#160; }</div><div class="line"><a name="l00900"></a><span class="lineno"> 900</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;\&#39;&quot;</span> &lt;&lt; it-&gt;first &lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l00901"></a><span class="lineno"> 901</span>&#160; }</div><div class="line"><a name="l00902"></a><span class="lineno"> 902</span>&#160; os &lt;&lt; <span class="charliteral">&#39;}&#39;</span>;</div><div class="line"><a name="l00903"></a><span class="lineno"> 903</span>&#160; }</div><div class="line"><a name="l00904"></a><span class="lineno"> 904</span>&#160;};</div><div class="line"><a name="l00905"></a><span class="lineno"> 905</span>&#160;</div><div class="line"><a name="l00906"></a><span class="lineno"> 906</span>&#160;</div><div class="line"><a name="l00907"></a><span class="lineno"> 907</span>&#160;<span class="comment">// specialize define for optional&lt;int&gt;(enum)</span></div><div class="line"><a name="l00908"></a><span class="lineno"> 908</span>&#160;<span class="keyword">template</span>&lt;&gt;</div><div class="line"><a name="l00909"></a><span class="lineno"> 909</span>&#160;<span class="keyword">class </span>FieldEntry&lt;optional&lt;int&gt; &gt;</div><div class="line"><a name="l00910"></a><span class="lineno"> 910</span>&#160; : <span class="keyword">public</span> FieldEntryBase&lt;FieldEntry&lt;optional&lt;int&gt; &gt;, optional&lt;int&gt; &gt; {</div><div class="line"><a name="l00911"></a><span class="lineno"> 911</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l00912"></a><span class="lineno"> 912</span>&#160; <span class="comment">// construct</span></div><div class="line"><a name="l00913"></a><span class="lineno"> 913</span>&#160; FieldEntry&lt;optional&lt;int&gt; &gt;() : is_enum_(<span class="keyword">false</span>) {}</div><div class="line"><a name="l00914"></a><span class="lineno"> 914</span>&#160; <span class="comment">// parent</span></div><div class="line"><a name="l00915"></a><span class="lineno"> 915</span>&#160; <span class="keyword">typedef</span> FieldEntryBase&lt;FieldEntry&lt;optional&lt;int&gt; &gt;, optional&lt;int&gt; &gt; Parent;</div><div class="line"><a name="l00916"></a><span class="lineno"> 916</span>&#160; <span class="comment">// override set</span></div><div class="line"><a name="l00917"></a><span class="lineno"> 917</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> Set(<span class="keywordtype">void</span> *head, <span class="keyword">const</span> std::string &amp;value)<span class="keyword"> const </span>{</div><div class="line"><a name="l00918"></a><span class="lineno"> 918</span>&#160; <span class="keywordflow">if</span> (is_enum_ &amp;&amp; value != <span class="stringliteral">&quot;None&quot;</span>) {</div><div class="line"><a name="l00919"></a><span class="lineno"> 919</span>&#160; std::map&lt;std::string, int&gt;::const_iterator it = enum_map_.find(value);</div><div class="line"><a name="l00920"></a><span class="lineno"> 920</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00921"></a><span class="lineno"> 921</span>&#160; <span class="keywordflow">if</span> (it == enum_map_.end()) {</div><div class="line"><a name="l00922"></a><span class="lineno"> 922</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Invalid Input: \&#39;&quot;</span> &lt;&lt; value;</div><div class="line"><a name="l00923"></a><span class="lineno"> 923</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;\&#39;, valid values are: &quot;</span>;</div><div class="line"><a name="l00924"></a><span class="lineno"> 924</span>&#160; PrintEnums(os);</div><div class="line"><a name="l00925"></a><span class="lineno"> 925</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l00926"></a><span class="lineno"> 926</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00927"></a><span class="lineno"> 927</span>&#160; os &lt;&lt; it-&gt;second;</div><div class="line"><a name="l00928"></a><span class="lineno"> 928</span>&#160; Parent::Set(head, os.str());</div><div class="line"><a name="l00929"></a><span class="lineno"> 929</span>&#160; }</div><div class="line"><a name="l00930"></a><span class="lineno"> 930</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00931"></a><span class="lineno"> 931</span>&#160; Parent::Set(head, value);</div><div class="line"><a name="l00932"></a><span class="lineno"> 932</span>&#160; }</div><div class="line"><a name="l00933"></a><span class="lineno"> 933</span>&#160; }</div><div class="line"><a name="l00934"></a><span class="lineno"> 934</span>&#160; <span class="keyword">virtual</span> ParamFieldInfo GetFieldInfo()<span class="keyword"> const </span>{</div><div class="line"><a name="l00935"></a><span class="lineno"> 935</span>&#160; <span class="keywordflow">if</span> (is_enum_) {</div><div class="line"><a name="l00936"></a><span class="lineno"> 936</span>&#160; ParamFieldInfo info;</div><div class="line"><a name="l00937"></a><span class="lineno"> 937</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00938"></a><span class="lineno"> 938</span>&#160; info.name = key_;</div><div class="line"><a name="l00939"></a><span class="lineno"> 939</span>&#160; info.type = type_;</div><div class="line"><a name="l00940"></a><span class="lineno"> 940</span>&#160; PrintEnums(os);</div><div class="line"><a name="l00941"></a><span class="lineno"> 941</span>&#160; <span class="keywordflow">if</span> (has_default_) {</div><div class="line"><a name="l00942"></a><span class="lineno"> 942</span>&#160; os &lt;&lt; <span class="charliteral">&#39;,&#39;</span> &lt;&lt; <span class="stringliteral">&quot;optional, default=&quot;</span>;</div><div class="line"><a name="l00943"></a><span class="lineno"> 943</span>&#160; PrintDefaultValueString(os);</div><div class="line"><a name="l00944"></a><span class="lineno"> 944</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00945"></a><span class="lineno"> 945</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;, required&quot;</span>;</div><div class="line"><a name="l00946"></a><span class="lineno"> 946</span>&#160; }</div><div class="line"><a name="l00947"></a><span class="lineno"> 947</span>&#160; info.type_info_str = os.str();</div><div class="line"><a name="l00948"></a><span class="lineno"> 948</span>&#160; info.description = description_;</div><div class="line"><a name="l00949"></a><span class="lineno"> 949</span>&#160; <span class="keywordflow">return</span> info;</div><div class="line"><a name="l00950"></a><span class="lineno"> 950</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00951"></a><span class="lineno"> 951</span>&#160; <span class="keywordflow">return</span> Parent::GetFieldInfo();</div><div class="line"><a name="l00952"></a><span class="lineno"> 952</span>&#160; }</div><div class="line"><a name="l00953"></a><span class="lineno"> 953</span>&#160; }</div><div class="line"><a name="l00954"></a><span class="lineno"> 954</span>&#160; <span class="comment">// add enum</span></div><div class="line"><a name="l00955"></a><span class="lineno"> 955</span>&#160; <span class="keyword">inline</span> FieldEntry&lt;optional&lt;int&gt; &gt; &amp;add_enum(<span class="keyword">const</span> std::string &amp;key, <span class="keywordtype">int</span> value) {</div><div class="line"><a name="l00956"></a><span class="lineno"> 956</span>&#160; CHECK_NE(key, <span class="stringliteral">&quot;None&quot;</span>) &lt;&lt; <span class="stringliteral">&quot;None is reserved for empty optional&lt;int&gt;&quot;</span>;</div><div class="line"><a name="l00957"></a><span class="lineno"> 957</span>&#160; <span class="keywordflow">if</span> ((enum_map_.size() != 0 &amp;&amp; enum_map_.count(key) != 0) || \</div><div class="line"><a name="l00958"></a><span class="lineno"> 958</span>&#160; enum_back_map_.count(value) != 0) {</div><div class="line"><a name="l00959"></a><span class="lineno"> 959</span>&#160; std::ostringstream os;</div><div class="line"><a name="l00960"></a><span class="lineno"> 960</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Enum &quot;</span> &lt;&lt; <span class="stringliteral">&quot;(&quot;</span> &lt;&lt; key &lt;&lt; <span class="stringliteral">&quot;: &quot;</span> &lt;&lt; value &lt;&lt; <span class="stringliteral">&quot; exisit!&quot;</span> &lt;&lt; <span class="stringliteral">&quot;)\n&quot;</span>;</div><div class="line"><a name="l00961"></a><span class="lineno"> 961</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Enums: &quot;</span>;</div><div class="line"><a name="l00962"></a><span class="lineno"> 962</span>&#160; <span class="keywordflow">for</span> (std::map&lt;std::string, int&gt;::const_iterator it = enum_map_.begin();</div><div class="line"><a name="l00963"></a><span class="lineno"> 963</span>&#160; it != enum_map_.end(); ++it) {</div><div class="line"><a name="l00964"></a><span class="lineno"> 964</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;(&quot;</span> &lt;&lt; it-&gt;first &lt;&lt; <span class="stringliteral">&quot;: &quot;</span> &lt;&lt; it-&gt;second &lt;&lt; <span class="stringliteral">&quot;), &quot;</span>;</div><div class="line"><a name="l00965"></a><span class="lineno"> 965</span>&#160; }</div><div class="line"><a name="l00966"></a><span class="lineno"> 966</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l00967"></a><span class="lineno"> 967</span>&#160; }</div><div class="line"><a name="l00968"></a><span class="lineno"> 968</span>&#160; enum_map_[key] = value;</div><div class="line"><a name="l00969"></a><span class="lineno"> 969</span>&#160; enum_back_map_[value] = key;</div><div class="line"><a name="l00970"></a><span class="lineno"> 970</span>&#160; is_enum_ = <span class="keyword">true</span>;</div><div class="line"><a name="l00971"></a><span class="lineno"> 971</span>&#160; <span class="keywordflow">return</span> this-&gt;<span class="keyword">self</span>();</div><div class="line"><a name="l00972"></a><span class="lineno"> 972</span>&#160; }</div><div class="line"><a name="l00973"></a><span class="lineno"> 973</span>&#160;</div><div class="line"><a name="l00974"></a><span class="lineno"> 974</span>&#160; <span class="keyword">protected</span>:</div><div class="line"><a name="l00975"></a><span class="lineno"> 975</span>&#160; <span class="comment">// enum flag</span></div><div class="line"><a name="l00976"></a><span class="lineno"> 976</span>&#160; <span class="keywordtype">bool</span> is_enum_;</div><div class="line"><a name="l00977"></a><span class="lineno"> 977</span>&#160; <span class="comment">// enum map</span></div><div class="line"><a name="l00978"></a><span class="lineno"> 978</span>&#160; std::map&lt;std::string, int&gt; enum_map_;</div><div class="line"><a name="l00979"></a><span class="lineno"> 979</span>&#160; <span class="comment">// enum map</span></div><div class="line"><a name="l00980"></a><span class="lineno"> 980</span>&#160; std::map&lt;int, std::string&gt; enum_back_map_;</div><div class="line"><a name="l00981"></a><span class="lineno"> 981</span>&#160; <span class="comment">// override print behavior</span></div><div class="line"><a name="l00982"></a><span class="lineno"> 982</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> PrintDefaultValueString(std::ostream &amp;os)<span class="keyword"> const </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00983"></a><span class="lineno"> 983</span>&#160; os &lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l00984"></a><span class="lineno"> 984</span>&#160; PrintValue(os, default_value_);</div><div class="line"><a name="l00985"></a><span class="lineno"> 985</span>&#160; os &lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l00986"></a><span class="lineno"> 986</span>&#160; }</div><div class="line"><a name="l00987"></a><span class="lineno"> 987</span>&#160; <span class="comment">// override print default</span></div><div class="line"><a name="l00988"></a><span class="lineno"> 988</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> PrintValue(std::ostream &amp;os, optional&lt;int&gt; value)<span class="keyword"> const </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l00989"></a><span class="lineno"> 989</span>&#160; <span class="keywordflow">if</span> (is_enum_) {</div><div class="line"><a name="l00990"></a><span class="lineno"> 990</span>&#160; <span class="keywordflow">if</span> (!value) {</div><div class="line"><a name="l00991"></a><span class="lineno"> 991</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;None&quot;</span>;</div><div class="line"><a name="l00992"></a><span class="lineno"> 992</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00993"></a><span class="lineno"> 993</span>&#160; CHECK_NE(enum_back_map_.count(value.value()), 0U)</div><div class="line"><a name="l00994"></a><span class="lineno"> 994</span>&#160; &lt;&lt; <span class="stringliteral">&quot;Value not found in enum declared&quot;</span>;</div><div class="line"><a name="l00995"></a><span class="lineno"> 995</span>&#160; os &lt;&lt; enum_back_map_.at(value.value());</div><div class="line"><a name="l00996"></a><span class="lineno"> 996</span>&#160; }</div><div class="line"><a name="l00997"></a><span class="lineno"> 997</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00998"></a><span class="lineno"> 998</span>&#160; os &lt;&lt; value;</div><div class="line"><a name="l00999"></a><span class="lineno"> 999</span>&#160; }</div><div class="line"><a name="l01000"></a><span class="lineno"> 1000</span>&#160; }</div><div class="line"><a name="l01001"></a><span class="lineno"> 1001</span>&#160;</div><div class="line"><a name="l01002"></a><span class="lineno"> 1002</span>&#160;</div><div class="line"><a name="l01003"></a><span class="lineno"> 1003</span>&#160; <span class="keyword">private</span>:</div><div class="line"><a name="l01004"></a><span class="lineno"> 1004</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">void</span> PrintEnums(std::ostream &amp;os)<span class="keyword"> const </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l01005"></a><span class="lineno"> 1005</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;{None&quot;</span>;</div><div class="line"><a name="l01006"></a><span class="lineno"> 1006</span>&#160; <span class="keywordflow">for</span> (std::map&lt;std::string, int&gt;::const_iterator</div><div class="line"><a name="l01007"></a><span class="lineno"> 1007</span>&#160; it = enum_map_.begin(); it != enum_map_.end(); ++it) {</div><div class="line"><a name="l01008"></a><span class="lineno"> 1008</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;, &quot;</span>;</div><div class="line"><a name="l01009"></a><span class="lineno"> 1009</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;\&#39;&quot;</span> &lt;&lt; it-&gt;first &lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l01010"></a><span class="lineno"> 1010</span>&#160; }</div><div class="line"><a name="l01011"></a><span class="lineno"> 1011</span>&#160; os &lt;&lt; <span class="charliteral">&#39;}&#39;</span>;</div><div class="line"><a name="l01012"></a><span class="lineno"> 1012</span>&#160; }</div><div class="line"><a name="l01013"></a><span class="lineno"> 1013</span>&#160;};</div><div class="line"><a name="l01014"></a><span class="lineno"> 1014</span>&#160;</div><div class="line"><a name="l01015"></a><span class="lineno"> 1015</span>&#160;<span class="comment">// specialize define for string</span></div><div class="line"><a name="l01016"></a><span class="lineno"> 1016</span>&#160;<span class="keyword">template</span>&lt;&gt;</div><div class="line"><a name="l01017"></a><span class="lineno"> 1017</span>&#160;<span class="keyword">class </span>FieldEntry&lt;<a class="code" href="namespacestd.html">std</a>::string&gt;</div><div class="line"><a name="l01018"></a><span class="lineno"> 1018</span>&#160; : <span class="keyword">public</span> FieldEntryBase&lt;FieldEntry&lt;std::string&gt;, std::string&gt; {</div><div class="line"><a name="l01019"></a><span class="lineno"> 1019</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l01020"></a><span class="lineno"> 1020</span>&#160; <span class="comment">// parent class</span></div><div class="line"><a name="l01021"></a><span class="lineno"> 1021</span>&#160; <span class="keyword">typedef</span> FieldEntryBase&lt;FieldEntry&lt;std::string&gt;, std::string&gt; Parent;</div><div class="line"><a name="l01022"></a><span class="lineno"> 1022</span>&#160; <span class="comment">// override set</span></div><div class="line"><a name="l01023"></a><span class="lineno"> 1023</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> Set(<span class="keywordtype">void</span> *head, <span class="keyword">const</span> std::string &amp;value)<span class="keyword"> const </span>{</div><div class="line"><a name="l01024"></a><span class="lineno"> 1024</span>&#160; this-&gt;Get(head) = value;</div><div class="line"><a name="l01025"></a><span class="lineno"> 1025</span>&#160; }</div><div class="line"><a name="l01026"></a><span class="lineno"> 1026</span>&#160; <span class="comment">// override print default</span></div><div class="line"><a name="l01027"></a><span class="lineno"> 1027</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> PrintDefaultValueString(std::ostream &amp;os)<span class="keyword"> const </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l01028"></a><span class="lineno"> 1028</span>&#160; os &lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span> &lt;&lt; default_value_ &lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l01029"></a><span class="lineno"> 1029</span>&#160; }</div><div class="line"><a name="l01030"></a><span class="lineno"> 1030</span>&#160;};</div><div class="line"><a name="l01031"></a><span class="lineno"> 1031</span>&#160;</div><div class="line"><a name="l01032"></a><span class="lineno"> 1032</span>&#160;<span class="comment">// specialize define for bool</span></div><div class="line"><a name="l01033"></a><span class="lineno"> 1033</span>&#160;<span class="keyword">template</span>&lt;&gt;</div><div class="line"><a name="l01034"></a><span class="lineno"> 1034</span>&#160;<span class="keyword">class </span>FieldEntry&lt;bool&gt;</div><div class="line"><a name="l01035"></a><span class="lineno"> 1035</span>&#160; : <span class="keyword">public</span> FieldEntryBase&lt;FieldEntry&lt;bool&gt;, bool&gt; {</div><div class="line"><a name="l01036"></a><span class="lineno"> 1036</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l01037"></a><span class="lineno"> 1037</span>&#160; <span class="comment">// parent class</span></div><div class="line"><a name="l01038"></a><span class="lineno"> 1038</span>&#160; <span class="keyword">typedef</span> FieldEntryBase&lt;FieldEntry&lt;bool&gt;, <span class="keywordtype">bool</span>&gt; Parent;</div><div class="line"><a name="l01039"></a><span class="lineno"> 1039</span>&#160; <span class="comment">// override set</span></div><div class="line"><a name="l01040"></a><span class="lineno"> 1040</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> Set(<span class="keywordtype">void</span> *head, <span class="keyword">const</span> std::string &amp;value)<span class="keyword"> const </span>{</div><div class="line"><a name="l01041"></a><span class="lineno"> 1041</span>&#160; std::string lower_case; lower_case.resize(value.length());</div><div class="line"><a name="l01042"></a><span class="lineno"> 1042</span>&#160; std::transform(value.begin(), value.end(), lower_case.begin(), ::tolower);</div><div class="line"><a name="l01043"></a><span class="lineno"> 1043</span>&#160; <span class="keywordtype">bool</span> &amp;ref = this-&gt;Get(head);</div><div class="line"><a name="l01044"></a><span class="lineno"> 1044</span>&#160; <span class="keywordflow">if</span> (lower_case == <span class="stringliteral">&quot;true&quot;</span>) {</div><div class="line"><a name="l01045"></a><span class="lineno"> 1045</span>&#160; ref = <span class="keyword">true</span>;</div><div class="line"><a name="l01046"></a><span class="lineno"> 1046</span>&#160; } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (lower_case == <span class="stringliteral">&quot;false&quot;</span>) {</div><div class="line"><a name="l01047"></a><span class="lineno"> 1047</span>&#160; ref = <span class="keyword">false</span>;</div><div class="line"><a name="l01048"></a><span class="lineno"> 1048</span>&#160; } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (lower_case == <span class="stringliteral">&quot;1&quot;</span>) {</div><div class="line"><a name="l01049"></a><span class="lineno"> 1049</span>&#160; ref = <span class="keyword">true</span>;</div><div class="line"><a name="l01050"></a><span class="lineno"> 1050</span>&#160; } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (lower_case == <span class="stringliteral">&quot;0&quot;</span>) {</div><div class="line"><a name="l01051"></a><span class="lineno"> 1051</span>&#160; ref = <span class="keyword">false</span>;</div><div class="line"><a name="l01052"></a><span class="lineno"> 1052</span>&#160; } <span class="keywordflow">else</span> {</div><div class="line"><a name="l01053"></a><span class="lineno"> 1053</span>&#160; std::ostringstream os;</div><div class="line"><a name="l01054"></a><span class="lineno"> 1054</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Invalid Parameter format for &quot;</span> &lt;&lt; key_</div><div class="line"><a name="l01055"></a><span class="lineno"> 1055</span>&#160; &lt;&lt; <span class="stringliteral">&quot; expect &quot;</span> &lt;&lt; type_ &lt;&lt; <span class="stringliteral">&quot; but value=\&#39;&quot;</span> &lt;&lt; value&lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l01056"></a><span class="lineno"> 1056</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l01057"></a><span class="lineno"> 1057</span>&#160; }</div><div class="line"><a name="l01058"></a><span class="lineno"> 1058</span>&#160; }</div><div class="line"><a name="l01059"></a><span class="lineno"> 1059</span>&#160;</div><div class="line"><a name="l01060"></a><span class="lineno"> 1060</span>&#160; <span class="keyword">protected</span>:</div><div class="line"><a name="l01061"></a><span class="lineno"> 1061</span>&#160; <span class="comment">// print default string</span></div><div class="line"><a name="l01062"></a><span class="lineno"> 1062</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> PrintValue(std::ostream &amp;os, <span class="keywordtype">bool</span> value)<span class="keyword"> const </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l01063"></a><span class="lineno"> 1063</span>&#160; os &lt;&lt; static_cast&lt;int&gt;(value);</div><div class="line"><a name="l01064"></a><span class="lineno"> 1064</span>&#160; }</div><div class="line"><a name="l01065"></a><span class="lineno"> 1065</span>&#160;};</div><div class="line"><a name="l01066"></a><span class="lineno"> 1066</span>&#160;</div><div class="line"><a name="l01067"></a><span class="lineno"> 1067</span>&#160;</div><div class="line"><a name="l01068"></a><span class="lineno"> 1068</span>&#160;<span class="comment">// specialize define for float. Uses stof for platform independent handling of</span></div><div class="line"><a name="l01069"></a><span class="lineno"> 1069</span>&#160;<span class="comment">// INF, -INF, NAN, etc.</span></div><div class="line"><a name="l01070"></a><span class="lineno"> 1070</span>&#160;<span class="preprocessor">#if DMLC_USE_CXX11</span></div><div class="line"><a name="l01071"></a><span class="lineno"> 1071</span>&#160;<span class="keyword">template</span> &lt;&gt;</div><div class="line"><a name="l01072"></a><span class="lineno"> 1072</span>&#160;<span class="keyword">class </span>FieldEntry&lt;float&gt; : <span class="keyword">public</span> FieldEntryNumeric&lt;FieldEntry&lt;float&gt;, float&gt; {</div><div class="line"><a name="l01073"></a><span class="lineno"> 1073</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l01074"></a><span class="lineno"> 1074</span>&#160; <span class="comment">// parent</span></div><div class="line"><a name="l01075"></a><span class="lineno"> 1075</span>&#160; <span class="keyword">typedef</span> FieldEntryNumeric&lt;FieldEntry&lt;float&gt;, <span class="keywordtype">float</span>&gt; Parent;</div><div class="line"><a name="l01076"></a><span class="lineno"> 1076</span>&#160; <span class="comment">// override set</span></div><div class="line"><a name="l01077"></a><span class="lineno"> 1077</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> Set(<span class="keywordtype">void</span> *head, <span class="keyword">const</span> std::string &amp;value)<span class="keyword"> const </span>{</div><div class="line"><a name="l01078"></a><span class="lineno"> 1078</span>&#160; <span class="keywordtype">size_t</span> pos = 0; <span class="comment">// number of characters processed by dmlc::stof()</span></div><div class="line"><a name="l01079"></a><span class="lineno"> 1079</span>&#160; <span class="keywordflow">try</span> {</div><div class="line"><a name="l01080"></a><span class="lineno"> 1080</span>&#160; this-&gt;Get(head) = <a class="code" href="namespacedmlc.html#a43a149fb880b527d393975a884255341">dmlc::stof</a>(value, &amp;pos);</div><div class="line"><a name="l01081"></a><span class="lineno"> 1081</span>&#160; } <span class="keywordflow">catch</span> (<span class="keyword">const</span> std::invalid_argument &amp;) {</div><div class="line"><a name="l01082"></a><span class="lineno"> 1082</span>&#160; std::ostringstream os;</div><div class="line"><a name="l01083"></a><span class="lineno"> 1083</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Invalid Parameter format for &quot;</span> &lt;&lt; key_ &lt;&lt; <span class="stringliteral">&quot; expect &quot;</span> &lt;&lt; type_</div><div class="line"><a name="l01084"></a><span class="lineno"> 1084</span>&#160; &lt;&lt; <span class="stringliteral">&quot; but value=\&#39;&quot;</span> &lt;&lt; value &lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l01085"></a><span class="lineno"> 1085</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l01086"></a><span class="lineno"> 1086</span>&#160; } <span class="keywordflow">catch</span> (<span class="keyword">const</span> std::out_of_range&amp;) {</div><div class="line"><a name="l01087"></a><span class="lineno"> 1087</span>&#160; std::ostringstream os;</div><div class="line"><a name="l01088"></a><span class="lineno"> 1088</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Out of range value for &quot;</span> &lt;&lt; key_ &lt;&lt; <span class="stringliteral">&quot;, value=\&#39;&quot;</span> &lt;&lt; value &lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l01089"></a><span class="lineno"> 1089</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l01090"></a><span class="lineno"> 1090</span>&#160; }</div><div class="line"><a name="l01091"></a><span class="lineno"> 1091</span>&#160; CHECK_LE(pos, value.length()); <span class="comment">// just in case</span></div><div class="line"><a name="l01092"></a><span class="lineno"> 1092</span>&#160; <span class="keywordflow">if</span> (pos &lt; value.length()) {</div><div class="line"><a name="l01093"></a><span class="lineno"> 1093</span>&#160; std::ostringstream os;</div><div class="line"><a name="l01094"></a><span class="lineno"> 1094</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Some trailing characters could not be parsed: \&#39;&quot;</span></div><div class="line"><a name="l01095"></a><span class="lineno"> 1095</span>&#160; &lt;&lt; value.substr(pos) &lt;&lt; <span class="stringliteral">&quot;\&#39;&quot;</span>;</div><div class="line"><a name="l01096"></a><span class="lineno"> 1096</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l01097"></a><span class="lineno"> 1097</span>&#160; }</div><div class="line"><a name="l01098"></a><span class="lineno"> 1098</span>&#160; }</div><div class="line"><a name="l01099"></a><span class="lineno"> 1099</span>&#160;</div><div class="line"><a name="l01100"></a><span class="lineno"> 1100</span>&#160; <span class="keyword">protected</span>:</div><div class="line"><a name="l01101"></a><span class="lineno"> 1101</span>&#160; <span class="comment">// print the value</span></div><div class="line"><a name="l01102"></a><span class="lineno"> 1102</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> PrintValue(std::ostream &amp;os, <span class="keywordtype">float</span> value)<span class="keyword"> const </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l01103"></a><span class="lineno"> 1103</span>&#160; os &lt;&lt; std::setprecision(std::numeric_limits&lt;float&gt;::max_digits10) &lt;&lt; value;</div><div class="line"><a name="l01104"></a><span class="lineno"> 1104</span>&#160; }</div><div class="line"><a name="l01105"></a><span class="lineno"> 1105</span>&#160;};</div><div class="line"><a name="l01106"></a><span class="lineno"> 1106</span>&#160;</div><div class="line"><a name="l01107"></a><span class="lineno"> 1107</span>&#160;<span class="comment">// specialize define for double. Uses stod for platform independent handling of</span></div><div class="line"><a name="l01108"></a><span class="lineno"> 1108</span>&#160;<span class="comment">// INF, -INF, NAN, etc.</span></div><div class="line"><a name="l01109"></a><span class="lineno"> 1109</span>&#160;<span class="keyword">template</span> &lt;&gt;</div><div class="line"><a name="l01110"></a><span class="lineno"> 1110</span>&#160;<span class="keyword">class </span>FieldEntry&lt;double&gt;</div><div class="line"><a name="l01111"></a><span class="lineno"> 1111</span>&#160; : <span class="keyword">public</span> FieldEntryNumeric&lt;FieldEntry&lt;double&gt;, double&gt; {</div><div class="line"><a name="l01112"></a><span class="lineno"> 1112</span>&#160; <span class="keyword">public</span>:</div><div class="line"><a name="l01113"></a><span class="lineno"> 1113</span>&#160; <span class="comment">// parent</span></div><div class="line"><a name="l01114"></a><span class="lineno"> 1114</span>&#160; <span class="keyword">typedef</span> FieldEntryNumeric&lt;FieldEntry&lt;double&gt;, <span class="keywordtype">double</span>&gt; Parent;</div><div class="line"><a name="l01115"></a><span class="lineno"> 1115</span>&#160; <span class="comment">// override set</span></div><div class="line"><a name="l01116"></a><span class="lineno"> 1116</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> Set(<span class="keywordtype">void</span> *head, <span class="keyword">const</span> std::string &amp;value)<span class="keyword"> const </span>{</div><div class="line"><a name="l01117"></a><span class="lineno"> 1117</span>&#160; <span class="keywordtype">size_t</span> pos = 0; <span class="comment">// number of characters processed by dmlc::stod()</span></div><div class="line"><a name="l01118"></a><span class="lineno"> 1118</span>&#160; <span class="keywordflow">try</span> {</div><div class="line"><a name="l01119"></a><span class="lineno"> 1119</span>&#160; this-&gt;Get(head) = <a class="code" href="namespacedmlc.html#a5f49479b0736b8709986ead800e1bfdc">dmlc::stod</a>(value, &amp;pos);</div><div class="line"><a name="l01120"></a><span class="lineno"> 1120</span>&#160; } <span class="keywordflow">catch</span> (<span class="keyword">const</span> std::invalid_argument &amp;) {</div><div class="line"><a name="l01121"></a><span class="lineno"> 1121</span>&#160; std::ostringstream os;</div><div class="line"><a name="l01122"></a><span class="lineno"> 1122</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Invalid Parameter format for &quot;</span> &lt;&lt; key_ &lt;&lt; <span class="stringliteral">&quot; expect &quot;</span> &lt;&lt; type_</div><div class="line"><a name="l01123"></a><span class="lineno"> 1123</span>&#160; &lt;&lt; <span class="stringliteral">&quot; but value=\&#39;&quot;</span> &lt;&lt; value &lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l01124"></a><span class="lineno"> 1124</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l01125"></a><span class="lineno"> 1125</span>&#160; } <span class="keywordflow">catch</span> (<span class="keyword">const</span> std::out_of_range&amp;) {</div><div class="line"><a name="l01126"></a><span class="lineno"> 1126</span>&#160; std::ostringstream os;</div><div class="line"><a name="l01127"></a><span class="lineno"> 1127</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Out of range value for &quot;</span> &lt;&lt; key_ &lt;&lt; <span class="stringliteral">&quot;, value=\&#39;&quot;</span> &lt;&lt; value &lt;&lt; <span class="charliteral">&#39;\&#39;&#39;</span>;</div><div class="line"><a name="l01128"></a><span class="lineno"> 1128</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l01129"></a><span class="lineno"> 1129</span>&#160; }</div><div class="line"><a name="l01130"></a><span class="lineno"> 1130</span>&#160; CHECK_LE(pos, value.length()); <span class="comment">// just in case</span></div><div class="line"><a name="l01131"></a><span class="lineno"> 1131</span>&#160; <span class="keywordflow">if</span> (pos &lt; value.length()) {</div><div class="line"><a name="l01132"></a><span class="lineno"> 1132</span>&#160; std::ostringstream os;</div><div class="line"><a name="l01133"></a><span class="lineno"> 1133</span>&#160; os &lt;&lt; <span class="stringliteral">&quot;Some trailing characters could not be parsed: \&#39;&quot;</span></div><div class="line"><a name="l01134"></a><span class="lineno"> 1134</span>&#160; &lt;&lt; value.substr(pos) &lt;&lt; <span class="stringliteral">&quot;\&#39;&quot;</span>;</div><div class="line"><a name="l01135"></a><span class="lineno"> 1135</span>&#160; <span class="keywordflow">throw</span> dmlc::ParamError(os.str());</div><div class="line"><a name="l01136"></a><span class="lineno"> 1136</span>&#160; }</div><div class="line"><a name="l01137"></a><span class="lineno"> 1137</span>&#160; }</div><div class="line"><a name="l01138"></a><span class="lineno"> 1138</span>&#160;</div><div class="line"><a name="l01139"></a><span class="lineno"> 1139</span>&#160; <span class="keyword">protected</span>:</div><div class="line"><a name="l01140"></a><span class="lineno"> 1140</span>&#160; <span class="comment">// print the value</span></div><div class="line"><a name="l01141"></a><span class="lineno"> 1141</span>&#160; <span class="keyword">virtual</span> <span class="keywordtype">void</span> PrintValue(std::ostream &amp;os, <span class="keywordtype">double</span> value)<span class="keyword"> const </span>{ <span class="comment">// NOLINT(*)</span></div><div class="line"><a name="l01142"></a><span class="lineno"> 1142</span>&#160; os &lt;&lt; std::setprecision(std::numeric_limits&lt;double&gt;::max_digits10) &lt;&lt; value;</div><div class="line"><a name="l01143"></a><span class="lineno"> 1143</span>&#160; }</div><div class="line"><a name="l01144"></a><span class="lineno"> 1144</span>&#160;};</div><div class="line"><a name="l01145"></a><span class="lineno"> 1145</span>&#160;<span class="preprocessor">#endif // DMLC_USE_CXX11</span></div><div class="line"><a name="l01146"></a><span class="lineno"> 1146</span>&#160;</div><div class="line"><a name="l01147"></a><span class="lineno"> 1147</span>&#160;} <span class="comment">// namespace parameter</span></div><div class="line"><a name="l01149"></a><span class="lineno"> 1149</span>&#160;<span class="comment"></span></div><div class="line"><a name="l01150"></a><span class="lineno"> 1150</span>&#160;<span class="comment">// implement GetEnv</span></div><div class="line"><a name="l01151"></a><span class="lineno"> 1151</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">typename</span> ValueType&gt;</div><div class="line"><a name="l01152"></a><span class="lineno"> 1152</span>&#160;<span class="keyword">inline</span> ValueType GetEnv(<span class="keyword">const</span> <span class="keywordtype">char</span> *key,</div><div class="line"><a name="l01153"></a><span class="lineno"> 1153</span>&#160; ValueType default_value) {</div><div class="line"><a name="l01154"></a><span class="lineno"> 1154</span>&#160; <span class="keyword">const</span> <span class="keywordtype">char</span> *val = getenv(key);</div><div class="line"><a name="l01155"></a><span class="lineno"> 1155</span>&#160; <span class="comment">// On some implementations, if the var is set to a blank string (i.e. &quot;FOO=&quot;), then</span></div><div class="line"><a name="l01156"></a><span class="lineno"> 1156</span>&#160; <span class="comment">// a blank string will be returned instead of NULL. In order to be consistent, if</span></div><div class="line"><a name="l01157"></a><span class="lineno"> 1157</span>&#160; <span class="comment">// the environment var is a blank string, then also behave as if a null was returned.</span></div><div class="line"><a name="l01158"></a><span class="lineno"> 1158</span>&#160; <span class="keywordflow">if</span> (val == <span class="keyword">nullptr</span> || !*val) {</div><div class="line"><a name="l01159"></a><span class="lineno"> 1159</span>&#160; <span class="keywordflow">return</span> default_value;</div><div class="line"><a name="l01160"></a><span class="lineno"> 1160</span>&#160; }</div><div class="line"><a name="l01161"></a><span class="lineno"> 1161</span>&#160; ValueType ret;</div><div class="line"><a name="l01162"></a><span class="lineno"> 1162</span>&#160; parameter::FieldEntry&lt;ValueType&gt; e;</div><div class="line"><a name="l01163"></a><span class="lineno"> 1163</span>&#160; e.Init(key, &amp;ret, ret);</div><div class="line"><a name="l01164"></a><span class="lineno"> 1164</span>&#160; e.Set(&amp;ret, val);</div><div class="line"><a name="l01165"></a><span class="lineno"> 1165</span>&#160; <span class="keywordflow">return</span> ret;</div><div class="line"><a name="l01166"></a><span class="lineno"> 1166</span>&#160;}</div><div class="line"><a name="l01167"></a><span class="lineno"> 1167</span>&#160;</div><div class="line"><a name="l01168"></a><span class="lineno"> 1168</span>&#160;<span class="comment">// implement SetEnv</span></div><div class="line"><a name="l01169"></a><span class="lineno"> 1169</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">typename</span> ValueType&gt;</div><div class="line"><a name="l01170"></a><span class="lineno"> 1170</span>&#160;<span class="keyword">inline</span> <span class="keywordtype">void</span> SetEnv(<span class="keyword">const</span> <span class="keywordtype">char</span> *key,</div><div class="line"><a name="l01171"></a><span class="lineno"> 1171</span>&#160; ValueType value) {</div><div class="line"><a name="l01172"></a><span class="lineno"> 1172</span>&#160; parameter::FieldEntry&lt;ValueType&gt; e;</div><div class="line"><a name="l01173"></a><span class="lineno"> 1173</span>&#160; e.Init(key, &amp;value, value);</div><div class="line"><a name="l01174"></a><span class="lineno"> 1174</span>&#160;<span class="preprocessor">#ifdef _WIN32</span></div><div class="line"><a name="l01175"></a><span class="lineno"> 1175</span>&#160; _putenv_s(key, e.GetStringValue(&amp;value).c_str());</div><div class="line"><a name="l01176"></a><span class="lineno"> 1176</span>&#160;<span class="preprocessor">#else</span></div><div class="line"><a name="l01177"></a><span class="lineno"> 1177</span>&#160; setenv(key, e.GetStringValue(&amp;value).c_str(), 1);</div><div class="line"><a name="l01178"></a><span class="lineno"> 1178</span>&#160;<span class="preprocessor">#endif // _WIN32</span></div><div class="line"><a name="l01179"></a><span class="lineno"> 1179</span>&#160;}</div><div class="line"><a name="l01180"></a><span class="lineno"> 1180</span>&#160;} <span class="comment">// namespace dmlc</span></div><div class="line"><a name="l01181"></a><span class="lineno"> 1181</span>&#160;<span class="preprocessor">#endif // DMLC_PARAMETER_H_</span></div><div class="ttc" id="optional_8h_html"><div class="ttname"><a href="optional_8h.html">optional.h</a></div><div class="ttdoc">Container to hold optional data. </div></div>
<div class="ttc" id="namespacestd_html"><div class="ttname"><a href="namespacestd.html">std</a></div><div class="ttdef"><b>Definition:</b> optional.h:251</div></div>
<div class="ttc" id="namespacedmlc_html_a5f49479b0736b8709986ead800e1bfdc"><div class="ttname"><a href="namespacedmlc.html#a5f49479b0736b8709986ead800e1bfdc">dmlc::stod</a></div><div class="ttdeci">double stod(const std::string &amp;value, size_t *pos=nullptr)</div><div class="ttdoc">A faster implementation of stod(). See documentation of std::stod() for more information. This function will test for overflow and invalid arguments. TODO: the current version does not support hex number TODO: the current version does not handle long decimals: you may only have up to 19 digits after the decimal point, and you cannot have too many digits before the decimal point either. </div><div class="ttdef"><b>Definition:</b> strtonum.h:497</div></div>
<div class="ttc" id="strtonum_8h_html"><div class="ttname"><a href="strtonum_8h.html">strtonum.h</a></div><div class="ttdoc">A faster implementation of strtof and strtod. </div></div>
<div class="ttc" id="3rdparty_2dmlc-core_2include_2dmlc_2base_8h_html_ae48f57de53e5271fa1394e04cef5dd23"><div class="ttname"><a href="3rdparty_2dmlc-core_2include_2dmlc_2base_8h.html#ae48f57de53e5271fa1394e04cef5dd23">DMLC_SUPPRESS_UBSAN</a></div><div class="ttdeci">#define DMLC_SUPPRESS_UBSAN</div><div class="ttdoc">helper macro to supress Undefined Behavior Sanitizer for a specific function </div><div class="ttdef"><b>Definition:</b> base.h:157</div></div>
<div class="ttc" id="json_8h_html"><div class="ttname"><a href="json_8h.html">json.h</a></div><div class="ttdoc">Lightweight JSON Reader/Writer that read save into C++ data structs. This includes STL composites and...</div></div>
<div class="ttc" id="classdmlc_1_1JSONReader_html"><div class="ttname"><a href="classdmlc_1_1JSONReader.html">dmlc::JSONReader</a></div><div class="ttdoc">Lightweight JSON Reader to read any STL compositions and structs. The user need to know the schema of...</div><div class="ttdef"><b>Definition:</b> json.h:44</div></div>
<div class="ttc" id="namespacedmlc_html_a52dcf01c9ba22be9b08e455194fb2ab3"><div class="ttname"><a href="namespacedmlc.html#a52dcf01c9ba22be9b08e455194fb2ab3">dmlc::isspace</a></div><div class="ttdeci">bool isspace(char c)</div><div class="ttdoc">Inline implementation of isspace(). Tests whether the given character is a whitespace letter...</div><div class="ttdef"><b>Definition:</b> strtonum.h:26</div></div>
<div class="ttc" id="namespacedmlc_html"><div class="ttname"><a href="namespacedmlc.html">dmlc</a></div><div class="ttdoc">namespace for dmlc </div><div class="ttdef"><b>Definition:</b> array_view.h:12</div></div>
<div class="ttc" id="classdmlc_1_1JSONWriter_html_ac16c9b279f64512117fdefb2ede8662d"><div class="ttname"><a href="classdmlc_1_1JSONWriter.html#ac16c9b279f64512117fdefb2ede8662d">dmlc::JSONWriter::Write</a></div><div class="ttdeci">void Write(const ValueType &amp;value)</div><div class="ttdoc">Write value to json. </div></div>
<div class="ttc" id="namespacedmlc_html_a43a149fb880b527d393975a884255341"><div class="ttname"><a href="namespacedmlc.html#a43a149fb880b527d393975a884255341">dmlc::stof</a></div><div class="ttdeci">float stof(const std::string &amp;value, size_t *pos=nullptr)</div><div class="ttdoc">A faster implementation of stof(). See documentation of std::stof() for more information. This function will test for overflow and invalid arguments. TODO: the current version does not support hex number TODO: the current version does not handle long decimals: you may only have up to 19 digits after the decimal point, and you cannot have too many digits before the decimal point either. </div><div class="ttdef"><b>Definition:</b> strtonum.h:467</div></div>
<div class="ttc" id="classdmlc_1_1JSONReader_html_a74487e106bca0cc16b676f539f69a4bf"><div class="ttname"><a href="classdmlc_1_1JSONReader.html#a74487e106bca0cc16b676f539f69a4bf">dmlc::JSONReader::Read</a></div><div class="ttdeci">void Read(ValueType *out_value)</div><div class="ttdoc">Read next ValueType. </div></div>
<div class="ttc" id="3rdparty_2dmlc-core_2include_2dmlc_2base_8h_html"><div class="ttname"><a href="3rdparty_2dmlc-core_2include_2dmlc_2base_8h.html">base.h</a></div></div>
<div class="ttc" id="type__traits_8h_html"><div class="ttname"><a href="type__traits_8h.html">type_traits.h</a></div><div class="ttdoc">type traits information header </div></div>
<div class="ttc" id="classdmlc_1_1JSONWriter_html"><div class="ttname"><a href="classdmlc_1_1JSONWriter.html">dmlc::JSONWriter</a></div><div class="ttdoc">Lightweight json to write any STL compositions. </div><div class="ttdef"><b>Definition:</b> json.h:190</div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Thu Jan 5 2023 00:58:42 for mxnet by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.13
</small></address>
</body>
</html>