blob: 250e114861e6cccfa7adbf775d97760726d6b017 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://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.20"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Qpid Proton C++ API: proton/value.hpp 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="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.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>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(document).ready(function() { init_search(); });
/* @license-end */
</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">Qpid Proton C++ API
&#160;<span id="projectnumber">0.32.0</span>
</div>
</td>
<td> <div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.svg"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.20 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search');
/* @license-end */
</script>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(document).ready(function(){initNavTree('value_8hpp_source.html',''); initResizable(); });
/* @license-end */
</script>
<div id="doc-content">
<!-- 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 class="header">
<div class="headertitle">
<div class="title">value.hpp</div> </div>
</div><!--header-->
<div class="contents">
<a href="value_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span>&#160;<span class="preprocessor">#ifndef PROTON_VALUE_HPP</span></div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span>&#160;<span class="preprocessor">#define PROTON_VALUE_HPP</span></div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span>&#160; </div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span>&#160;<span class="comment">/*</span></div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span>&#160;<span class="comment"> *</span></div>
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span>&#160;<span class="comment"> * Licensed to the Apache Software Foundation (ASF) under one</span></div>
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span>&#160;<span class="comment"> * or more contributor license agreements. See the NOTICE file</span></div>
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span>&#160;<span class="comment"> * distributed with this work for additional information</span></div>
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span>&#160;<span class="comment"> * regarding copyright ownership. The ASF licenses this file</span></div>
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span>&#160;<span class="comment"> * to you under the Apache License, Version 2.0 (the</span></div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span>&#160;<span class="comment"> * &quot;License&quot;); you may not use this file except in compliance</span></div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span>&#160;<span class="comment"> * with the License. You may obtain a copy of the License at</span></div>
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span>&#160;<span class="comment"> *</span></div>
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span>&#160;<span class="comment"> * http://www.apache.org/licenses/LICENSE-2.0</span></div>
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span>&#160;<span class="comment"> *</span></div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span>&#160;<span class="comment"> * Unless required by applicable law or agreed to in writing,</span></div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span>&#160;<span class="comment"> * software distributed under the License is distributed on an</span></div>
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span>&#160;<span class="comment"> * &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span></div>
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span>&#160;<span class="comment"> * KIND, either express or implied. See the License for the</span></div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span>&#160;<span class="comment"> * specific language governing permissions and limitations</span></div>
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span>&#160;<span class="comment"> * under the License.</span></div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span>&#160;<span class="comment"> *</span></div>
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span>&#160;<span class="comment"> */</span></div>
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span>&#160; </div>
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="encoder_8hpp.html">./codec/encoder.hpp</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="decoder_8hpp.html">./codec/decoder.hpp</a>&quot;</span></div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span>&#160;<span class="preprocessor">#include &quot;./internal/type_traits.hpp&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="scalar_8hpp.html">./scalar.hpp</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="types__fwd_8hpp.html">./types_fwd.hpp</a>&quot;</span></div>
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span>&#160; </div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span>&#160;<span class="preprocessor">#include &lt;proton/type_compat.h&gt;</span></div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span>&#160; </div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span>&#160;<span class="preprocessor">#include &lt;iosfwd&gt;</span></div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span>&#160; </div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span>&#160; </div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span>&#160;<span class="keyword">namespace </span><a class="code" href="namespaceproton.html">proton</a> {</div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span>&#160; </div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span>&#160;<span class="keyword">namespace </span>internal {</div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span>&#160; </div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span>&#160;<span class="comment">// Separate value data from implicit conversion constructors to avoid template recursion.</span></div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>&#160;<span class="keyword">class </span>value_base {</div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span>&#160; <span class="keyword">protected</span>:</div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>&#160; internal::data&amp; data();</div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span>&#160; internal::data data_;</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span>&#160; </div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>&#160; <span class="keyword">friend</span> <span class="keyword">class </span>codec::encoder;</div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span>&#160; <span class="keyword">friend</span> <span class="keyword">class </span>codec::decoder;</div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span>&#160;};</div>
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span>&#160; </div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>&#160;} <span class="comment">// internal</span></div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>&#160; </div>
<div class="line"><a name="l00057"></a><span class="lineno"><a class="line" href="classproton_1_1value.html"> 57</a></span>&#160;<span class="keyword">class </span><a class="code" href="classproton_1_1value.html">value</a> : <span class="keyword">public</span> internal::value_base, <span class="keyword">private</span> internal::comparable&lt;value&gt; {</div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>&#160; <span class="keyword">private</span>:</div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>&#160; <span class="comment">// Enabler for encodable types excluding proton::value.</span></div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span>&#160; <span class="keyword">template</span>&lt;<span class="keyword">class</span> T, <span class="keyword">class</span> U=<span class="keywordtype">void</span>&gt; <span class="keyword">struct </span>assignable :</div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span>&#160; <span class="keyword">public</span> internal::enable_if&lt;codec::is_encodable&lt;T&gt;::value, U&gt; {};</div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span>&#160; <span class="keyword">template</span>&lt;<span class="keyword">class</span> U&gt; <span class="keyword">struct </span>assignable&lt;<a class="code" href="classproton_1_1value.html">value</a>, U&gt; {};</div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span>&#160; </div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span>&#160; <span class="keyword">public</span>:</div>
<div class="line"><a name="l00066"></a><span class="lineno"><a class="line" href="classproton_1_1value.html#aefbfa229f1c9e1fc967bff724a010f9e"> 66</a></span>&#160; PN_CPP_EXTERN <a class="code" href="classproton_1_1value.html#aefbfa229f1c9e1fc967bff724a010f9e">value</a>();</div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span>&#160; </div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span>&#160; PN_CPP_EXTERN <a class="code" href="classproton_1_1value.html#aefbfa229f1c9e1fc967bff724a010f9e">value</a>(<span class="keyword">const</span> <a class="code" href="classproton_1_1value.html">value</a>&amp;);</div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>&#160; PN_CPP_EXTERN <a class="code" href="classproton_1_1value.html">value</a>&amp; operator=(<span class="keyword">const</span> <a class="code" href="classproton_1_1value.html">value</a>&amp;);</div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span>&#160;<span class="preprocessor">#if PN_CPP_HAS_RVALUE_REFERENCES</span></div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span>&#160; PN_CPP_EXTERN <a class="code" href="classproton_1_1value.html#aefbfa229f1c9e1fc967bff724a010f9e">value</a>(<a class="code" href="classproton_1_1value.html">value</a>&amp;&amp;);</div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>&#160; PN_CPP_EXTERN <a class="code" href="classproton_1_1value.html">value</a>&amp; operator=(<a class="code" href="classproton_1_1value.html">value</a>&amp;&amp;);</div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>&#160;<span class="preprocessor">#endif</span></div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>&#160; </div>
<div class="line"><a name="l00079"></a><span class="lineno"><a class="line" href="classproton_1_1value.html#ae7acdea6863a3b5100b7ac9e0b4c73e1"> 79</a></span>&#160; <span class="keyword">template</span> &lt;<span class="keyword">class</span> T&gt; <a class="code" href="classproton_1_1value.html#ae7acdea6863a3b5100b7ac9e0b4c73e1">value</a>(<span class="keyword">const</span> T&amp; x, <span class="keyword">typename</span> assignable&lt;T&gt;::type* = 0) { *<span class="keyword">this</span> = x; }</div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>&#160; </div>
<div class="line"><a name="l00082"></a><span class="lineno"><a class="line" href="classproton_1_1value.html#ad139f5042c366b09078f123f5621c156"> 82</a></span>&#160; <span class="keyword">template</span> &lt;<span class="keyword">class</span> T&gt; <span class="keyword">typename</span> assignable&lt;T, value&amp;&gt;::type <a class="code" href="classproton_1_1value.html#ad139f5042c366b09078f123f5621c156">operator=</a>(<span class="keyword">const</span> T&amp; x) {</div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>&#160; <a class="code" href="classproton_1_1codec_1_1encoder.html">codec::encoder</a> e(*<span class="keyword">this</span>);</div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span>&#160; e &lt;&lt; x;</div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span>&#160; <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span>&#160; }</div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span>&#160; </div>
<div class="line"><a name="l00089"></a><span class="lineno"><a class="line" href="classproton_1_1value.html#a89dd77b1757d854f49d49e379f8f9db8"> 89</a></span>&#160; PN_CPP_EXTERN <a class="code" href="namespaceproton.html#a83c2656d467d69eb49725c18f5aa13a9">type_id</a> <a class="code" href="classproton_1_1value.html#a89dd77b1757d854f49d49e379f8f9db8">type</a>() <span class="keyword">const</span>;</div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>&#160; </div>
<div class="line"><a name="l00092"></a><span class="lineno"><a class="line" href="classproton_1_1value.html#a644718bb2fb240de962dc3c9a1fdf0dc"> 92</a></span>&#160; PN_CPP_EXTERN <span class="keywordtype">bool</span> <a class="code" href="classproton_1_1value.html#a644718bb2fb240de962dc3c9a1fdf0dc">empty</a>() <span class="keyword">const</span>;</div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>&#160; </div>
<div class="line"><a name="l00095"></a><span class="lineno"><a class="line" href="classproton_1_1value.html#ac8bb3912a3ce86b15842e79d0b421204"> 95</a></span>&#160; PN_CPP_EXTERN <span class="keywordtype">void</span> <a class="code" href="classproton_1_1value.html#ac8bb3912a3ce86b15842e79d0b421204">clear</a>();</div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>&#160; </div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>&#160; <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; PN_CPP_DEPRECATED(<span class="stringliteral">&quot;Use &#39;proton::get&#39;&quot;</span>) void <a class="code" href="classproton_1_1value.html#a051c12c4c7efc82a5f268d4f64e15b54">get</a>(T &amp;t) const;</div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>&#160; template&lt;class T&gt; PN_CPP_DEPRECATED(&quot;Use &#39;<a class="code" href="namespaceproton.html">proton</a>::<a class="code" href="classproton_1_1value.html#a051c12c4c7efc82a5f268d4f64e15b54">get</a>&#39;&quot;) T <a class="code" href="classproton_1_1value.html#a051c12c4c7efc82a5f268d4f64e15b54">get</a>() const;</div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>&#160; </div>
<div class="line"><a name="l00103"></a><span class="lineno"><a class="line" href="classproton_1_1value.html#afdde986e34571c6544abfdea9afdb658"> 103</a></span>&#160; friend PN_CPP_EXTERN <span class="keywordtype">void</span> <a class="code" href="classproton_1_1value.html#afdde986e34571c6544abfdea9afdb658">swap</a>(<a class="code" href="classproton_1_1value.html">value</a>&amp;, <a class="code" href="classproton_1_1value.html">value</a>&amp;);</div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>&#160; </div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>&#160; friend PN_CPP_EXTERN <span class="keywordtype">bool</span> operator==(const <a class="code" href="classproton_1_1value.html">value</a>&amp; x, const <a class="code" href="classproton_1_1value.html">value</a>&amp; y);</div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>&#160; friend PN_CPP_EXTERN <span class="keywordtype">bool</span> operator&lt;(const <a class="code" href="classproton_1_1value.html">value</a>&amp; x, const <a class="code" href="classproton_1_1value.html">value</a>&amp; y);</div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>&#160; </div>
<div class="line"><a name="l00115"></a><span class="lineno"><a class="line" href="classproton_1_1value.html#a70ee803fc7f2a505266e357e7c13aa18"> 115</a></span>&#160; friend PN_CPP_EXTERN std::ostream&amp; operator&lt;&lt;(std::ostream&amp;, const <a class="code" href="classproton_1_1value.html">value</a>&amp;);</div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>&#160; </div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>&#160; <a class="code" href="classproton_1_1value.html">value</a>(pn_data_t* d); <span class="comment">// Refer to existing pn_data_t</span></div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>&#160; <span class="keywordtype">void</span> reset(pn_data_t* d = 0); <span class="comment">// Refer to a new pn_data_t</span></div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>&#160;<span class="comment"></span>};</div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>&#160; </div>
<div class="line"><a name="l00126"></a><span class="lineno"><a class="line" href="namespaceproton.html#a051c12c4c7efc82a5f268d4f64e15b54"> 126</a></span>&#160;template&lt;class T&gt; T <a class="code" href="classproton_1_1value.html#a051c12c4c7efc82a5f268d4f64e15b54">get</a>(const <a class="code" href="classproton_1_1value.html">value</a>&amp; v) { T x; <a class="code" href="classproton_1_1value.html#a051c12c4c7efc82a5f268d4f64e15b54">get</a>(v, x); <span class="keywordflow">return</span> x; }</div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span>&#160; </div>
<div class="line"><a name="l00133"></a><span class="lineno"><a class="line" href="namespaceproton.html#a2dd4c0151b171f03f2c36d907832522b"> 133</a></span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keywordtype">void</span> <a class="code" href="classproton_1_1value.html#a051c12c4c7efc82a5f268d4f64e15b54">get</a>(<span class="keyword">const</span> <a class="code" href="classproton_1_1value.html">value</a>&amp; v, T&amp; x) { <a class="code" href="classproton_1_1codec_1_1decoder.html">codec::decoder</a> d(v, <span class="keyword">true</span>); d &gt;&gt; x; }</div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span>&#160; </div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">class</span> T, <span class="keyword">class</span> U&gt; <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classproton_1_1value.html#a051c12c4c7efc82a5f268d4f64e15b54">get</a>(<span class="keyword">const</span> U&amp; u, T&amp; x) { <span class="keyword">const</span> <a class="code" href="classproton_1_1value.html#aefbfa229f1c9e1fc967bff724a010f9e">value</a> v(u); <a class="code" href="classproton_1_1value.html#a051c12c4c7efc82a5f268d4f64e15b54">get</a>(v, x); }</div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>&#160; </div>
<div class="line"><a name="l00140"></a><span class="lineno"><a class="line" href="namespaceproton.html#a486dfed974ca6f79e75039b3eee6c44c"> 140</a></span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; T <a class="code" href="classproton_1_1value.html#a486dfed974ca6f79e75039b3eee6c44c">coerce</a>(<span class="keyword">const</span> <a class="code" href="classproton_1_1value.html">value</a>&amp; v) { T x; <a class="code" href="classproton_1_1value.html#a486dfed974ca6f79e75039b3eee6c44c">coerce</a>(v, x); <span class="keywordflow">return</span> x; }</div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>&#160; </div>
<div class="line"><a name="l00147"></a><span class="lineno"><a class="line" href="namespaceproton.html#a4896ec87beab7d691e1985c221c36e49"> 147</a></span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keywordtype">void</span> <a class="code" href="classproton_1_1value.html#a486dfed974ca6f79e75039b3eee6c44c">coerce</a>(<span class="keyword">const</span> <a class="code" href="classproton_1_1value.html">value</a>&amp; v, T&amp; x) {</div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span>&#160; <a class="code" href="classproton_1_1codec_1_1decoder.html">codec::decoder</a> d(v, <span class="keyword">false</span>);</div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span>&#160; <a class="code" href="classproton_1_1scalar.html">scalar</a> s;</div>
<div class="line"><a name="l00150"></a><span class="lineno"> 150</span>&#160; <span class="keywordflow">if</span> (type_id_is_scalar(v.<a class="code" href="classproton_1_1value.html#a89dd77b1757d854f49d49e379f8f9db8">type</a>())) {</div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span>&#160; d &gt;&gt; s;</div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>&#160; x = internal::coerce&lt;T&gt;(s);</div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>&#160; } <span class="keywordflow">else</span> {</div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>&#160; d &gt;&gt; x;</div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span>&#160; }</div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>&#160;}</div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span>&#160; </div>
<div class="line"><a name="l00159"></a><span class="lineno"><a class="line" href="namespaceproton.html#a669620a0968de2603fe8922405f1331b"> 159</a></span>&#160;<span class="keyword">template</span>&lt;&gt; <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespaceproton.html#a669620a0968de2603fe8922405f1331b">get&lt;null&gt;</a>(<span class="keyword">const</span> <a class="code" href="classproton_1_1value.html">value</a>&amp; v, <span class="keyword">null</span>&amp;) {</div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>&#160; <a class="code" href="namespaceproton.html#aa77887032372174b09ee779f5df12056">assert_type_equal</a>(<a class="code" href="namespaceproton.html#a83c2656d467d69eb49725c18f5aa13a9a74cf8825b522b9721ea02973803d76b4">NULL_TYPE</a>, v.<a class="code" href="classproton_1_1value.html#a89dd77b1757d854f49d49e379f8f9db8">type</a>());</div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>&#160;}</div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>&#160;<span class="preprocessor">#if PN_CPP_HAS_NULLPTR</span></div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span>&#160;<span class="keyword">template</span>&lt;&gt; <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="namespaceproton.html#a565c609b3fe24b92ae8294ea1318a6bd">get&lt;decltype(nullptr)&gt;</a>(<span class="keyword">const</span> <a class="code" href="classproton_1_1value.html#aefbfa229f1c9e1fc967bff724a010f9e">value</a>&amp; v, decltype(<span class="keyword">nullptr</span>)&amp;) {</div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span>&#160; <a class="code" href="namespaceproton.html#aa77887032372174b09ee779f5df12056">assert_type_equal</a>(<a class="code" href="namespaceproton.html#a83c2656d467d69eb49725c18f5aa13a9a74cf8825b522b9721ea02973803d76b4">NULL_TYPE</a>, v.type());</div>
<div class="line"><a name="l00166"></a><span class="lineno"> 166</span>&#160;}</div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>&#160;<span class="preprocessor">#endif</span></div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span>&#160; </div>
<div class="line"><a name="l00170"></a><span class="lineno"><a class="line" href="namespaceproton.html#a8c46a4cbeb5a6150ab40ea81ee4bfb81"> 170</a></span>&#160;PN_CPP_EXTERN std::string <a class="code" href="namespaceproton.html#aa06e1abe8e9c848ba20d89405436fb1f">to_string</a>(<span class="keyword">const</span> <a class="code" href="classproton_1_1value.html">value</a>&amp; x);</div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span>&#160; </div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keywordtype">void</span> <a class="code" href="classproton_1_1value.html#a051c12c4c7efc82a5f268d4f64e15b54">value::get</a>(T &amp;x)<span class="keyword"> const </span>{ x = proton::get&lt;T&gt;(*<span class="keyword">this</span>); }</div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span>&#160;<span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; T <a class="code" href="classproton_1_1value.html#a051c12c4c7efc82a5f268d4f64e15b54">value::get</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> proton::get&lt;T&gt;(*<span class="keyword">this</span>); }</div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>&#160; </div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span>&#160;} <span class="comment">// proton</span></div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>&#160; </div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>&#160;<span class="preprocessor">#endif // PROTON_VALUE_HPP</span></div>
</div><!-- fragment --></div><!-- contents -->
</div><!-- doc-content -->
<div class="ttc" id="aclassproton_1_1scalar_html"><div class="ttname"><a href="classproton_1_1scalar.html">proton::scalar</a></div><div class="ttdoc">A holder for an instance of any scalar AMQP type.</div><div class="ttdef"><b>Definition:</b> scalar.hpp:37</div></div>
<div class="ttc" id="aclassproton_1_1value_html_a89dd77b1757d854f49d49e379f8f9db8"><div class="ttname"><a href="classproton_1_1value.html#a89dd77b1757d854f49d49e379f8f9db8">proton::value::type</a></div><div class="ttdeci">type_id type() const</div><div class="ttdoc">Get the type ID for the current value.</div></div>
<div class="ttc" id="aclassproton_1_1value_html_aefbfa229f1c9e1fc967bff724a010f9e"><div class="ttname"><a href="classproton_1_1value.html#aefbfa229f1c9e1fc967bff724a010f9e">proton::value::value</a></div><div class="ttdeci">value()</div><div class="ttdoc">Create a null value.</div></div>
<div class="ttc" id="anamespaceproton_html_a669620a0968de2603fe8922405f1331b"><div class="ttname"><a href="namespaceproton.html#a669620a0968de2603fe8922405f1331b">proton::get&lt; null &gt;</a></div><div class="ttdeci">void get&lt; null &gt;(const value &amp;v, null &amp;)</div><div class="ttdoc">Special case for null, just checks that value contains NULL.</div><div class="ttdef"><b>Definition:</b> value.hpp:159</div></div>
<div class="ttc" id="ascalar_8hpp_html"><div class="ttname"><a href="scalar_8hpp.html">scalar.hpp</a></div><div class="ttdoc">A holder for an instance of any scalar AMQP type.</div></div>
<div class="ttc" id="aclassproton_1_1value_html_a644718bb2fb240de962dc3c9a1fdf0dc"><div class="ttname"><a href="classproton_1_1value.html#a644718bb2fb240de962dc3c9a1fdf0dc">proton::value::empty</a></div><div class="ttdeci">bool empty() const</div><div class="ttdoc">True if the value is null.</div></div>
<div class="ttc" id="aclassproton_1_1value_html"><div class="ttname"><a href="classproton_1_1value.html">proton::value</a></div><div class="ttdoc">A holder for any AMQP value, simple or complex.</div><div class="ttdef"><b>Definition:</b> value.hpp:57</div></div>
<div class="ttc" id="aclassproton_1_1value_html_ac8bb3912a3ce86b15842e79d0b421204"><div class="ttname"><a href="classproton_1_1value.html#ac8bb3912a3ce86b15842e79d0b421204">proton::value::clear</a></div><div class="ttdeci">void clear()</div><div class="ttdoc">Reset the value to null/empty.</div></div>
<div class="ttc" id="anamespaceproton_html_a83c2656d467d69eb49725c18f5aa13a9a74cf8825b522b9721ea02973803d76b4"><div class="ttname"><a href="namespaceproton.html#a83c2656d467d69eb49725c18f5aa13a9a74cf8825b522b9721ea02973803d76b4">proton::NULL_TYPE</a></div><div class="ttdeci">@ NULL_TYPE</div><div class="ttdoc">The null type, contains no data.</div><div class="ttdef"><b>Definition:</b> type_id.hpp:38</div></div>
<div class="ttc" id="anamespaceproton_html_aa06e1abe8e9c848ba20d89405436fb1f"><div class="ttname"><a href="namespaceproton.html#aa06e1abe8e9c848ba20d89405436fb1f">proton::to_string</a></div><div class="ttdeci">std::string to_string(const message &amp;)</div><div class="ttdoc">Human readable string representation.</div></div>
<div class="ttc" id="aclassproton_1_1value_html_a051c12c4c7efc82a5f268d4f64e15b54"><div class="ttname"><a href="classproton_1_1value.html#a051c12c4c7efc82a5f268d4f64e15b54">proton::value::get</a></div><div class="ttdeci">T get(const value &amp;v)</div><div class="ttdoc">Get a contained value of type T.</div><div class="ttdef"><b>Definition:</b> value.hpp:126</div></div>
<div class="ttc" id="anamespaceproton_html_a83c2656d467d69eb49725c18f5aa13a9"><div class="ttname"><a href="namespaceproton.html#a83c2656d467d69eb49725c18f5aa13a9">proton::type_id</a></div><div class="ttdeci">type_id</div><div class="ttdoc">An identifier for AMQP types.</div><div class="ttdef"><b>Definition:</b> type_id.hpp:37</div></div>
<div class="ttc" id="aclassproton_1_1codec_1_1decoder_html"><div class="ttname"><a href="classproton_1_1codec_1_1decoder.html">proton::codec::decoder</a></div><div class="ttdoc">Unsettled API - A stream-like decoder from AMQP bytes to C++ values.</div><div class="ttdef"><b>Definition:</b> decoder.hpp:56</div></div>
<div class="ttc" id="adecoder_8hpp_html"><div class="ttname"><a href="decoder_8hpp.html">decoder.hpp</a></div><div class="ttdoc">Unsettled API - A stream-like decoder from AMQP bytes to C++ values.</div></div>
<div class="ttc" id="aclassproton_1_1value_html_a486dfed974ca6f79e75039b3eee6c44c"><div class="ttname"><a href="classproton_1_1value.html#a486dfed974ca6f79e75039b3eee6c44c">proton::value::coerce</a></div><div class="ttdeci">T coerce(const value &amp;v)</div><div class="ttdoc">Coerce the contained value to type T.</div><div class="ttdef"><b>Definition:</b> value.hpp:140</div></div>
<div class="ttc" id="anamespaceproton_html_a565c609b3fe24b92ae8294ea1318a6bd"><div class="ttname"><a href="namespaceproton.html#a565c609b3fe24b92ae8294ea1318a6bd">proton::get&lt; decltype(nullptr)&gt;</a></div><div class="ttdeci">void get&lt; decltype(nullptr)&gt;(const value &amp;v, decltype(nullptr)&amp;)</div><div class="ttdoc">Special case for null, just checks that value contains NULL.</div><div class="ttdef"><b>Definition:</b> value.hpp:164</div></div>
<div class="ttc" id="aclassproton_1_1value_html_ad139f5042c366b09078f123f5621c156"><div class="ttname"><a href="classproton_1_1value.html#ad139f5042c366b09078f123f5621c156">proton::value::operator=</a></div><div class="ttdeci">assignable&lt; T, value &amp; &gt;::type operator=(const T &amp;x)</div><div class="ttdoc">Assign from any allowed type T.</div><div class="ttdef"><b>Definition:</b> value.hpp:82</div></div>
<div class="ttc" id="aclassproton_1_1value_html_ae7acdea6863a3b5100b7ac9e0b4c73e1"><div class="ttname"><a href="classproton_1_1value.html#ae7acdea6863a3b5100b7ac9e0b4c73e1">proton::value::value</a></div><div class="ttdeci">value(const T &amp;x, typename assignable&lt; T &gt;::type *=0)</div><div class="ttdoc">Copy from any allowed type T.</div><div class="ttdef"><b>Definition:</b> value.hpp:79</div></div>
<div class="ttc" id="aclassproton_1_1codec_1_1encoder_html"><div class="ttname"><a href="classproton_1_1codec_1_1encoder.html">proton::codec::encoder</a></div><div class="ttdoc">Unsettled API - A stream-like encoder from C++ values to AMQP bytes.</div><div class="ttdef"><b>Definition:</b> encoder.hpp:50</div></div>
<div class="ttc" id="anamespaceproton_html"><div class="ttname"><a href="namespaceproton.html">proton</a></div><div class="ttdoc">The main Proton namespace.</div><div class="ttdef"><b>Definition:</b> annotation_key.hpp:33</div></div>
<div class="ttc" id="aencoder_8hpp_html"><div class="ttname"><a href="encoder_8hpp.html">encoder.hpp</a></div><div class="ttdoc">Unsettled API - A stream-like encoder from C++ values to AMQP bytes.</div></div>
<div class="ttc" id="aclassproton_1_1value_html_afdde986e34571c6544abfdea9afdb658"><div class="ttname"><a href="classproton_1_1value.html#afdde986e34571c6544abfdea9afdb658">proton::value::swap</a></div><div class="ttdeci">friend void swap(value &amp;, value &amp;)</div><div class="ttdoc">swap values</div></div>
<div class="ttc" id="anamespaceproton_html_aa77887032372174b09ee779f5df12056"><div class="ttname"><a href="namespaceproton.html#aa77887032372174b09ee779f5df12056">proton::assert_type_equal</a></div><div class="ttdeci">void assert_type_equal(type_id want, type_id got)</div><div class="ttdoc">Throw a conversion_error if want != got with a message including the names of the types.</div></div>
<div class="ttc" id="atypes__fwd_8hpp_html"><div class="ttname"><a href="types__fwd_8hpp.html">types_fwd.hpp</a></div><div class="ttdoc">Forward declarations for Proton types used to represent AMQP types.</div></div>
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="dir_3a71568e5d046e5ed52679664c3002a5.html">proton</a></li><li class="navelem"><a class="el" href="value_8hpp.html">value.hpp</a></li>
<li class="footer">Generated by <a href="http://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.8.20 </li>
</ul>
</div>
</body>
</html>