http://git-wip-us.apache.org/repos/asf/mesos-site/blob/09fd0301/content/api/latest/c++/windows_2write_8hpp_source.html
----------------------------------------------------------------------
diff --git a/content/api/latest/c++/windows_2write_8hpp_source.html
b/content/api/latest/c++/windows_2write_8hpp_source.html
index 4585f04..26b5647 100644
--- a/content/api/latest/c++/windows_2write_8hpp_source.html
+++ b/content/api/latest/c++/windows_2write_8hpp_source.html
@@ -52,7 +52,7 @@
<div class="title">write.hpp</div> </div>
</div><!--header-->
<div class="contents">
-<a href="windows_2write_8hpp.html">Go to the documentation of this
file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span
class="lineno"> 1</span> <span class="comment">// Licensed under the
Apache License, Version 2.0 (the "License");</span></div><div
class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span
class="comment">// you may not use this file except in compliance with the
License.</span></div><div class="line"><a name="l00003"></a><span
class="lineno"> 3</span> <span class="comment">// You may obtain a copy
of the License at</span></div><div class="line"><a name="l00004"></a><span
class="lineno"> 4</span> <span class="comment">//</span></div><div
class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span
class="comment">// http://www.apache.org/licenses/LICENSE-2.0</span></div><div
class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span
class="comment">/
/</span></div><div class="line"><a name="l00007"></a><span class="lineno">
7</span> <span class="comment">// Unless required by applicable law or
agreed to in writing, software</span></div><div class="line"><a
name="l00008"></a><span class="lineno"> 8</span> <span
class="comment">// distributed under the License is distributed on an "AS
IS" BASIS,</span></div><div class="line"><a name="l00009"></a><span
class="lineno"> 9</span> <span class="comment">// WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied.</span></div><div
class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span
class="comment">// See the License for the specific language governing
permissions and</span></div><div class="line"><a name="l00011"></a><span
class="lineno"> 11</span> <span class="comment">// limitations under the
License.</span></div><div class="line"><a name="l00012"></a><span
class="lineno"> 12</span> </div><div cla
ss="line"><a name="l00013"></a><span class="lineno"> 13</span> <span
class="preprocessor">#ifndef __STOUT_OS_WINDOWS_WRITE_HPP__</span></div><div
class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span
class="preprocessor">#define __STOUT_OS_WINDOWS_WRITE_HPP__</span></div><div
class="line"><a name="l00015"></a><span class="lineno">
15</span> </div><div class="line"><a name="l00016"></a><span
class="lineno"> 16</span> <span class="preprocessor">#include <<a
class="code"
href="nothing_8hpp.html">stout/nothing.hpp</a>></span></div><div
class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span
class="preprocessor">#include <<a class="code"
href="try_8hpp.html">stout/try.hpp</a>></span></div><div class="line"><a
name="l00018"></a><span class="lineno"> 18</span> <span
class="preprocessor">#include <<a class="code"
href="unreachable_8hpp.html">stout/unreachable.hpp</a>></span></div><div
class="line">
<a name="l00019"></a><span class="lineno"> 19</span> <span
class="preprocessor">#include <<a class="code"
href="3rdparty_2stout_2include_2stout_2windows_8hpp.html">stout/windows.hpp</a>></span></div><div
class="line"><a name="l00020"></a><span class="lineno">
20</span> </div><div class="line"><a name="l00021"></a><span
class="lineno"> 21</span> <span class="preprocessor">#include <<a
class="code"
href="overlapped_8hpp.html">stout/internal/windows/overlapped.hpp</a>></span></div><div
class="line"><a name="l00022"></a><span class="lineno">
22</span> </div><div class="line"><a name="l00023"></a><span
class="lineno"> 23</span> <span class="preprocessor">#include <<a
class="code"
href="int__fd_8hpp.html">stout/os/int_fd.hpp</a>></span></div><div
class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span
class="preprocessor">#include <<a class="code"
href="stout_2include_2stout_2os_2socket_8hpp.html">stout/os/sock
et.hpp</a>></span></div><div class="line"><a name="l00025"></a><span
class="lineno"> 25</span> </div><div class="line"><a
name="l00026"></a><span class="lineno"> 26</span> <span
class="keyword">namespace </span><a class="code" href="namespaceos.html">os</a>
{</div><div class="line"><a name="l00027"></a><span class="lineno">
27</span> </div><div class="line"><a name="l00028"></a><span
class="lineno"> 28</span> <span class="comment">// Asynchronous write on
a overlapped int_fd. Returns `Error` on fatal errors,</span></div><div
class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span
class="comment">// `None()` on a successful pending IO operation or number of
bytes written on</span></div><div class="line"><a name="l00030"></a><span
class="lineno"> 30</span> <span class="comment">// a successful IO
operation that finished immediately.</span></div><div class="line"><a
name="l00031"></a><span class="lineno"><a class="line" href=
"namespaceos.html#a1af52685ba3e8fe8676af86cd16a1eb8">
31</a></span> <span class="keyword">inline</span> <a class="code"
href="classResult.html">Result<size_t></a> <a class="code"
href="namespaceos.html#a1af52685ba3e8fe8676af86cd16a1eb8">write_async</a>(</div><div
class="line"><a name="l00032"></a><span class="lineno"> 32</span> 
<span class="keyword">const</span> <a class="code"
href="int__fd_8hpp.html#aea4dbda01c90455f158ffa9b924c2f07">int_fd</a>&
fd,</div><div class="line"><a name="l00033"></a><span class="lineno">
33</span>  <span class="keyword">const</span> <span
class="keywordtype">void</span>* data,</div><div class="line"><a
name="l00034"></a><span class="lineno"> 34</span>  <span
class="keywordtype">size_t</span> <a class="code"
href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>,</div><div
class="line"><a name="l00035"></a><span class="lineno"> 35</span> 
OVERLAPPED* overlapped)</div><div class=
"line"><a name="l00036"></a><span class="lineno"> 36</span> {</div><div
class="line"><a name="l00037"></a><span class="lineno"> 37</span> 
CHECK_LE(size, UINT_MAX);</div><div class="line"><a name="l00038"></a><span
class="lineno"> 38</span> </div><div class="line"><a
name="l00039"></a><span class="lineno"> 39</span>  <span
class="keywordflow">switch</span> (fd.type()) {</div><div class="line"><a
name="l00040"></a><span class="lineno"> 40</span>  <span
class="keywordflow">case</span> <a class="code"
href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5ad09c4cb1265f1772bb757a7af277b49f">WindowsFD::Type::HANDLE</a>:
{</div><div class="line"><a name="l00041"></a><span class="lineno">
41</span>  DWORD bytes;</div><div class="line"><a
name="l00042"></a><span class="lineno"> 42</span>  <span
class="keyword">const</span> <span class="keywordtype">bool</span> success
=</div><div class="line"><a name="l00043"></a><spa
n class="lineno"> 43</span>  ::WriteFile(fd, data,
static_cast<DWORD>(size), &bytes, overlapped);</div><div
class="line"><a name="l00044"></a><span class="lineno">
44</span> </div><div class="line"><a name="l00045"></a><span
class="lineno"> 45</span>  <a class="code"
href="namespaceinternal_1_1windows.html#a4ed4d1bae6b01fb85f8e6fad0b10599d">return
::internal::windows::process_async_io_result</a>(success, bytes);</div><div
class="line"><a name="l00046"></a><span class="lineno"> 46</span> 
}</div><div class="line"><a name="l00047"></a><span class="lineno">
47</span>  <span class="keywordflow">case</span> <a class="code"
href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5a75fbea08c09e684e6b3f3961761354fa">WindowsFD::Type::SOCKET</a>:
{</div><div class="line"><a name="l00048"></a><span class="lineno">
48</span>  static_assert(</div><div class="line"><a
name="l00049"></a><span class="lineno"> 49</s
pan>  std::is_same<OVERLAPPED,
WSAOVERLAPPED>::value,</div><div class="line"><a name="l00050"></a><span
class="lineno"> 50</span>  <span
class="stringliteral">"Expected `WSAOVERLAPPED` to be of type
`OVERLAPPED`."</span>);</div><div class="line"><a name="l00051"></a><span
class="lineno"> 51</span> </div><div class="line"><a
name="l00052"></a><span class="lineno"> 52</span>  <span
class="comment">// Note that it's okay to allocate this on the stack, since
the WinSock</span></div><div class="line"><a name="l00053"></a><span
class="lineno"> 53</span>  <span class="comment">// providers must
copy the WSABUF to their internal buffers. See</span></div><div class="line"><a
name="l00054"></a><span class="lineno"> 54</span>  <span
class="comment">//
https://msdn.microsoft.com/en-us/library/windows/desktop/ms741688(v=vs.85).aspx
// NOLINT(whitespace/line_length)</span></div><div class="line"><a name="
l00055"></a><span class="lineno"> 55</span>  WSABUF buf =
{</div><div class="line"><a name="l00056"></a><span class="lineno">
56</span>  <span class="keyword">static_cast<</span>u_long<span
class="keyword">></span>(<a class="code"
href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>),</div><div
class="line"><a name="l00057"></a><span class="lineno"> 57</span> 
static_cast<char*>(const_cast<void*>(data))</div><div
class="line"><a name="l00058"></a><span class="lineno"> 58</span> 
};</div><div class="line"><a name="l00059"></a><span class="lineno">
59</span> </div><div class="line"><a name="l00060"></a><span
class="lineno"> 60</span>  DWORD bytes;</div><div class="line"><a
name="l00061"></a><span class="lineno"> 61</span>  <span
class="keyword">const</span> <span class="keywordtype">int</span> result
=</div><div class="line"><a name="l00062"></a><span class="linen
o"> 62</span>  ::WSASend(fd, &buf, 1, &bytes, 0,
overlapped, <span class="keyword">nullptr</span>);</div><div class="line"><a
name="l00063"></a><span class="lineno"> 63</span> </div><div
class="line"><a name="l00064"></a><span class="lineno"> 64</span> 
<a class="code"
href="namespaceinternal_1_1windows.html#a4ed4d1bae6b01fb85f8e6fad0b10599d">return
::internal::windows::process_async_io_result</a>(result == 0,
bytes);</div><div class="line"><a name="l00065"></a><span class="lineno">
65</span>  }</div><div class="line"><a name="l00066"></a><span
class="lineno"> 66</span>  }</div><div class="line"><a
name="l00067"></a><span class="lineno"> 67</span> </div><div
class="line"><a name="l00068"></a><span class="lineno"> 68</span>  <a
class="code"
href="unreachable_8hpp.html#a0bc63b24b654ca433be7b97a3edde132">UNREACHABLE</a>();</div><div
class="line"><a name="l00069"></a><span class="lineno">
69</span> }</div><
div class="line"><a name="l00070"></a><span class="lineno">
70</span> </div><div class="line"><a name="l00071"></a><span
class="lineno"> 71</span> </div><div class="line"><a
name="l00072"></a><span class="lineno"><a class="line"
href="namespaceos.html#a73da9d49515dfff761c4887c3d6032c0">
72</a></span> <span class="keyword">inline</span> <a class="code"
href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386">ssize_t</a>
<a class="code"
href="namespaceos.html#a73da9d49515dfff761c4887c3d6032c0">write</a>(<span
class="keyword">const</span> <a class="code"
href="int__fd_8hpp.html#aea4dbda01c90455f158ffa9b924c2f07">int_fd</a>& fd,
<span class="keyword">const</span> <span class="keywordtype">void</span>* data,
<span class="keywordtype">size_t</span> <a class="code"
href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>)</div><div
class="line"><a name="l00073"></a><span class="lineno">
73</span> {</div><d
iv class="line"><a name="l00074"></a><span class="lineno"> 74</span> 
CHECK_LE(size, INT_MAX);</div><div class="line"><a name="l00075"></a><span
class="lineno"> 75</span> </div><div class="line"><a
name="l00076"></a><span class="lineno"> 76</span>  <span
class="keywordflow">switch</span> (fd.type()) {</div><div class="line"><a
name="l00077"></a><span class="lineno"> 77</span>  <span
class="keywordflow">case</span> <a class="code"
href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5ad09c4cb1265f1772bb757a7af277b49f">WindowsFD::Type::HANDLE</a>:
{</div><div class="line"><a name="l00078"></a><span class="lineno">
78</span>  <span class="comment">// Handle non-overlapped case. We
just use the regular `WriteFile` since</span></div><div class="line"><a
name="l00079"></a><span class="lineno"> 79</span>  <span
class="comment">// seekable overlapped files require an offset, which we
don't track.</span></div><div class=
"line"><a name="l00080"></a><span class="lineno"> 80</span>  <span
class="keywordflow">if</span> (!fd.is_overlapped()) {</div><div class="line"><a
name="l00081"></a><span class="lineno"> 81</span>  DWORD
bytes;</div><div class="line"><a name="l00082"></a><span class="lineno">
82</span>  <span class="keyword">const</span> BOOL result
=</div><div class="line"><a name="l00083"></a><span class="lineno">
83</span>  ::WriteFile(fd, data, static_cast<DWORD>(size),
&bytes, <span class="keyword">nullptr</span>);</div><div class="line"><a
name="l00084"></a><span class="lineno"> 84</span> </div><div
class="line"><a name="l00085"></a><span class="lineno"> 85</span> 
<span class="keywordflow">if</span> (result == FALSE) {</div><div
class="line"><a name="l00086"></a><span class="lineno"> 86</span> 
<span class="comment">// Indicates an error, but we can't return a
`WindowsError`.</span></div
><div class="line"><a name="l00087"></a><span class="lineno">
>87</span>  <span class="keywordflow">return</span>
>-1;</div><div class="line"><a name="l00088"></a><span class="lineno">
>88</span>  }</div><div class="line"><a name="l00089"></a><span
>class="lineno"> 89</span> </div><div class="line"><a
>name="l00090"></a><span class="lineno"> 90</span>  <span
>class="keywordflow">return</span> <span
>class="keyword">static_cast<</span><a class="code"
>href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386">ssize_t</a><span
> class="keyword">></span>(bytes);</div><div class="line"><a
>name="l00091"></a><span class="lineno"> 91</span>  }</div><div
>class="line"><a name="l00092"></a><span class="lineno">
>92</span> </div><div class="line"><a name="l00093"></a><span
>class="lineno"> 93</span>  <span class="comment">// Asynchronous
>handle, we can use the `write_async` function</sp
an></div><div class="line"><a name="l00094"></a><span class="lineno">
94</span>  <span class="comment">// and then wait on the overlapped
object for a synchronous write.</span></div><div class="line"><a
name="l00095"></a><span class="lineno"> 95</span>  <a class="code"
href="classTry.html">Try<OVERLAPPED></a> overlapped_ =</div><div
class="line"><a name="l00096"></a><span class="lineno"> 96</span> 
<a class="code"
href="namespaceinternal_1_1windows.html#a388bd9a30ab487f5d035e542187e379a">::internal::windows::init_overlapped_for_sync_io</a>();</div><div
class="line"><a name="l00097"></a><span class="lineno">
97</span> </div><div class="line"><a name="l00098"></a><span
class="lineno"> 98</span>  <span class="keywordflow">if</span>
(overlapped_.<a class="code"
href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>())
{</div><div class="line"><a name="l00099"></a><span class="lineno">
99</span>  <sp
an class="keywordflow">return</span> -1;</div><div class="line"><a
name="l00100"></a><span class="lineno"> 100</span>  }</div><div
class="line"><a name="l00101"></a><span class="lineno">
101</span> </div><div class="line"><a name="l00102"></a><span
class="lineno"> 102</span>  OVERLAPPED overlapped = overlapped_.<a
class="code"
href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>();</div><div
class="line"><a name="l00103"></a><span class="lineno"> 103</span> 
<a class="code" href="classResult.html">Result<size_t></a> result = <a
class="code"
href="namespaceos.html#a1af52685ba3e8fe8676af86cd16a1eb8">write_async</a>(fd,
data, size, &overlapped);</div><div class="line"><a name="l00104"></a><span
class="lineno"> 104</span> </div><div class="line"><a
name="l00105"></a><span class="lineno"> 105</span>  <span
class="keywordflow">if</span> (result.<a class="code"
href="classResult.html#aeca16ad17d299ad885c9b46c83b12a
3d">isError</a>()) {</div><div class="line"><a name="l00106"></a><span
class="lineno"> 106</span>  <span
class="keywordflow">return</span> -1;</div><div class="line"><a
name="l00107"></a><span class="lineno"> 107</span>  }</div><div
class="line"><a name="l00108"></a><span class="lineno">
108</span> </div><div class="line"><a name="l00109"></a><span
class="lineno"> 109</span>  <span class="keywordflow">if</span>
(result.<a class="code"
href="classResult.html#a85eaa52037223d71092e65701c166562">isSome</a>())
{</div><div class="line"><a name="l00110"></a><span class="lineno">
110</span>  <span class="keywordflow">return</span> result.<a
class="code"
href="classResult.html#aedf79f3b14dcda5791b84a64ada4d412">get</a>();</div><div
class="line"><a name="l00111"></a><span class="lineno"> 111</span> 
}</div><div class="line"><a name="l00112"></a><span class="lineno">
112</span> </div><div class="line"><a name="l00113"></a><
span class="lineno"> 113</span>  <span class="comment">// IO is
pending, so wait for the overlapped object.</span></div><div class="line"><a
name="l00114"></a><span class="lineno"> 114</span>  DWORD
bytes;</div><div class="line"><a name="l00115"></a><span class="lineno">
115</span>  <span class="keyword">const</span> BOOL wait_success
=</div><div class="line"><a name="l00116"></a><span class="lineno">
116</span>  ::GetOverlappedResult(fd, &overlapped, &bytes,
TRUE);</div><div class="line"><a name="l00117"></a><span class="lineno">
117</span> </div><div class="line"><a name="l00118"></a><span
class="lineno"> 118</span>  <span class="keywordflow">if</span>
(wait_success == FALSE) {</div><div class="line"><a name="l00119"></a><span
class="lineno"> 119</span>  <span
class="keywordflow">return</span> -1;</div><div class="line"><a
name="l00120"></a><span class="lineno"> 120</span>  }</div><div c
lass="line"><a name="l00121"></a><span class="lineno">
121</span> </div><div class="line"><a name="l00122"></a><span
class="lineno"> 122</span>  <span class="keywordflow">return</span>
<span class="keyword">static_cast<</span><a class="code"
href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386">ssize_t</a><span
class="keyword">></span>(bytes);</div><div class="line"><a
name="l00123"></a><span class="lineno"> 123</span>  }</div><div
class="line"><a name="l00124"></a><span class="lineno"> 124</span> 
<span class="keywordflow">case</span> <a class="code"
href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5a75fbea08c09e684e6b3f3961761354fa">WindowsFD::Type::SOCKET</a>:
{</div><div class="line"><a name="l00125"></a><span class="lineno">
125</span>  <a class="code"
href="namespacenet.html#aa0a46766b4aca53ea50e1921567ddb40">return
::send</a>(fd, (<span class="keyword">const</span> <span c
lass="keywordtype">char</span>*)data, static_cast<int>(size),
0);</div><div class="line"><a name="l00126"></a><span class="lineno">
126</span>  }</div><div class="line"><a name="l00127"></a><span
class="lineno"> 127</span>  }</div><div class="line"><a
name="l00128"></a><span class="lineno"> 128</span> </div><div
class="line"><a name="l00129"></a><span class="lineno"> 129</span>  <a
class="code"
href="unreachable_8hpp.html#a0bc63b24b654ca433be7b97a3edde132">UNREACHABLE</a>();</div><div
class="line"><a name="l00130"></a><span class="lineno">
130</span> }</div><div class="line"><a name="l00131"></a><span
class="lineno"> 131</span> </div><div class="line"><a
name="l00132"></a><span class="lineno"> 132</span> } <span
class="comment">// namespace os {</span></div><div class="line"><a
name="l00133"></a><span class="lineno"> 133</span> </div><div
class="line"><a name="l00134"></a><span class="lineno">
134</span> </div><div cla
ss="line"><a name="l00135"></a><span class="lineno"> 135</span> <span
class="preprocessor">#endif // __STOUT_OS_WINDOWS_WRITE_HPP__</span></div><div
class="ttc"
id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_a894c4d58faeee7675b9e7e8244de1386"><div
class="ttname"><a
href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386">ssize_t</a></div><div
class="ttdeci">SSIZE_T ssize_t</div><div class="ttdef"><b>Definition:</b>
windows.hpp:186</div></div>
+<a href="windows_2write_8hpp.html">Go to the documentation of this
file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span
class="lineno"> 1</span> <span class="comment">// Licensed under the
Apache License, Version 2.0 (the "License");</span></div><div
class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span
class="comment">// you may not use this file except in compliance with the
License.</span></div><div class="line"><a name="l00003"></a><span
class="lineno"> 3</span> <span class="comment">// You may obtain a copy
of the License at</span></div><div class="line"><a name="l00004"></a><span
class="lineno"> 4</span> <span class="comment">//</span></div><div
class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span
class="comment">// http://www.apache.org/licenses/LICENSE-2.0</span></div><div
class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span
class="comment">/
/</span></div><div class="line"><a name="l00007"></a><span class="lineno">
7</span> <span class="comment">// Unless required by applicable law or
agreed to in writing, software</span></div><div class="line"><a
name="l00008"></a><span class="lineno"> 8</span> <span
class="comment">// distributed under the License is distributed on an "AS
IS" BASIS,</span></div><div class="line"><a name="l00009"></a><span
class="lineno"> 9</span> <span class="comment">// WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied.</span></div><div
class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span
class="comment">// See the License for the specific language governing
permissions and</span></div><div class="line"><a name="l00011"></a><span
class="lineno"> 11</span> <span class="comment">// limitations under the
License.</span></div><div class="line"><a name="l00012"></a><span
class="lineno"> 12</span> </div><div cla
ss="line"><a name="l00013"></a><span class="lineno"> 13</span> <span
class="preprocessor">#ifndef __STOUT_OS_WINDOWS_WRITE_HPP__</span></div><div
class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span
class="preprocessor">#define __STOUT_OS_WINDOWS_WRITE_HPP__</span></div><div
class="line"><a name="l00015"></a><span class="lineno">
15</span> </div><div class="line"><a name="l00016"></a><span
class="lineno"> 16</span> <span class="preprocessor">#include <<a
class="code"
href="nothing_8hpp.html">stout/nothing.hpp</a>></span></div><div
class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span
class="preprocessor">#include <<a class="code"
href="try_8hpp.html">stout/try.hpp</a>></span></div><div class="line"><a
name="l00018"></a><span class="lineno"> 18</span> <span
class="preprocessor">#include <<a class="code"
href="unreachable_8hpp.html">stout/unreachable.hpp</a>></span></div><div
class="line">
<a name="l00019"></a><span class="lineno"> 19</span> <span
class="preprocessor">#include <<a class="code"
href="3rdparty_2stout_2include_2stout_2windows_8hpp.html">stout/windows.hpp</a>></span></div><div
class="line"><a name="l00020"></a><span class="lineno">
20</span> </div><div class="line"><a name="l00021"></a><span
class="lineno"> 21</span> <span class="preprocessor">#include <<a
class="code"
href="overlapped_8hpp.html">stout/internal/windows/overlapped.hpp</a>></span></div><div
class="line"><a name="l00022"></a><span class="lineno">
22</span> </div><div class="line"><a name="l00023"></a><span
class="lineno"> 23</span> <span class="preprocessor">#include <<a
class="code"
href="int__fd_8hpp.html">stout/os/int_fd.hpp</a>></span></div><div
class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span
class="preprocessor">#include <<a class="code"
href="stout_2include_2stout_2os_2socket_8hpp.html">stout/os/sock
et.hpp</a>></span></div><div class="line"><a name="l00025"></a><span
class="lineno"> 25</span> </div><div class="line"><a
name="l00026"></a><span class="lineno"> 26</span> <span
class="keyword">namespace </span><a class="code" href="namespaceos.html">os</a>
{</div><div class="line"><a name="l00027"></a><span class="lineno">
27</span> </div><div class="line"><a name="l00028"></a><span
class="lineno"> 28</span> <span class="comment">// Asynchronous write on
a overlapped int_fd. Returns `Error` on fatal errors,</span></div><div
class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span
class="comment">// `None()` on a successful pending IO operation or number of
bytes written on</span></div><div class="line"><a name="l00030"></a><span
class="lineno"> 30</span> <span class="comment">// a successful IO
operation that finished immediately.</span></div><div class="line"><a
name="l00031"></a><span class="lineno"><a class="line" href=
"namespaceos.html#a1af52685ba3e8fe8676af86cd16a1eb8">
31</a></span> <span class="keyword">inline</span> <a class="code"
href="classResult.html">Result<size_t></a> <a class="code"
href="namespaceos.html#a1af52685ba3e8fe8676af86cd16a1eb8">write_async</a>(</div><div
class="line"><a name="l00032"></a><span class="lineno"> 32</span> 
<span class="keyword">const</span> <a class="code"
href="int__fd_8hpp.html#aea4dbda01c90455f158ffa9b924c2f07">int_fd</a>&
fd,</div><div class="line"><a name="l00033"></a><span class="lineno">
33</span>  <span class="keyword">const</span> <span
class="keywordtype">void</span>* data,</div><div class="line"><a
name="l00034"></a><span class="lineno"> 34</span>  <span
class="keywordtype">size_t</span> <a class="code"
href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>,</div><div
class="line"><a name="l00035"></a><span class="lineno"> 35</span> 
OVERLAPPED* overlapped)</div><div class=
"line"><a name="l00036"></a><span class="lineno"> 36</span> {</div><div
class="line"><a name="l00037"></a><span class="lineno"> 37</span> 
CHECK_LE(size, UINT_MAX);</div><div class="line"><a name="l00038"></a><span
class="lineno"> 38</span> </div><div class="line"><a
name="l00039"></a><span class="lineno"> 39</span>  <span
class="keywordflow">switch</span> (fd.type()) {</div><div class="line"><a
name="l00040"></a><span class="lineno"> 40</span>  <span
class="keywordflow">case</span> <a class="code"
href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5ad09c4cb1265f1772bb757a7af277b49f">WindowsFD::Type::HANDLE</a>:
{</div><div class="line"><a name="l00041"></a><span class="lineno">
41</span>  DWORD bytes;</div><div class="line"><a
name="l00042"></a><span class="lineno"> 42</span>  <span
class="keyword">const</span> <span class="keywordtype">bool</span> success
=</div><div class="line"><a name="l00043"></a><spa
n class="lineno"> 43</span>  ::WriteFile(fd, data,
static_cast<DWORD>(size), &bytes, overlapped);</div><div
class="line"><a name="l00044"></a><span class="lineno">
44</span> </div><div class="line"><a name="l00045"></a><span
class="lineno"> 45</span>  <a class="code"
href="namespaceinternal_1_1windows.html#a4ed4d1bae6b01fb85f8e6fad0b10599d">return
::internal::windows::process_async_io_result</a>(success, bytes);</div><div
class="line"><a name="l00046"></a><span class="lineno"> 46</span> 
}</div><div class="line"><a name="l00047"></a><span class="lineno">
47</span>  <span class="keywordflow">case</span> <a class="code"
href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5a75fbea08c09e684e6b3f3961761354fa">WindowsFD::Type::SOCKET</a>:
{</div><div class="line"><a name="l00048"></a><span class="lineno">
48</span>  static_assert(</div><div class="line"><a
name="l00049"></a><span class="lineno"> 49</s
pan>  std::is_same<OVERLAPPED,
WSAOVERLAPPED>::value,</div><div class="line"><a name="l00050"></a><span
class="lineno"> 50</span>  <span
class="stringliteral">"Expected `WSAOVERLAPPED` to be of type
`OVERLAPPED`."</span>);</div><div class="line"><a name="l00051"></a><span
class="lineno"> 51</span> </div><div class="line"><a
name="l00052"></a><span class="lineno"> 52</span>  <span
class="comment">// Note that it's okay to allocate this on the stack, since
the WinSock</span></div><div class="line"><a name="l00053"></a><span
class="lineno"> 53</span>  <span class="comment">// providers must
copy the WSABUF to their internal buffers. See</span></div><div class="line"><a
name="l00054"></a><span class="lineno"> 54</span>  <span
class="comment">//
https://msdn.microsoft.com/en-us/library/windows/desktop/ms741688(v=vs.85).aspx
// NOLINT(whitespace/line_length)</span></div><div class="line"><a name="
l00055"></a><span class="lineno"> 55</span>  WSABUF buf =
{</div><div class="line"><a name="l00056"></a><span class="lineno">
56</span>  <span class="keyword">static_cast<</span>u_long<span
class="keyword">></span>(<a class="code"
href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>),</div><div
class="line"><a name="l00057"></a><span class="lineno"> 57</span> 
static_cast<char*>(const_cast<void*>(data))</div><div
class="line"><a name="l00058"></a><span class="lineno"> 58</span> 
};</div><div class="line"><a name="l00059"></a><span class="lineno">
59</span> </div><div class="line"><a name="l00060"></a><span
class="lineno"> 60</span>  DWORD bytes;</div><div class="line"><a
name="l00061"></a><span class="lineno"> 61</span>  <span
class="keyword">const</span> <span class="keywordtype">int</span> result
=</div><div class="line"><a name="l00062"></a><span class="linen
o"> 62</span>  ::WSASend(fd, &buf, 1, &bytes, 0,
overlapped, <span class="keyword">nullptr</span>);</div><div class="line"><a
name="l00063"></a><span class="lineno"> 63</span> </div><div
class="line"><a name="l00064"></a><span class="lineno"> 64</span> 
<a class="code"
href="namespaceinternal_1_1windows.html#a4ed4d1bae6b01fb85f8e6fad0b10599d">return
::internal::windows::process_async_io_result</a>(result == 0,
bytes);</div><div class="line"><a name="l00065"></a><span class="lineno">
65</span>  }</div><div class="line"><a name="l00066"></a><span
class="lineno"> 66</span>  }</div><div class="line"><a
name="l00067"></a><span class="lineno"> 67</span> </div><div
class="line"><a name="l00068"></a><span class="lineno"> 68</span>  <a
class="code"
href="unreachable_8hpp.html#a0bc63b24b654ca433be7b97a3edde132">UNREACHABLE</a>();</div><div
class="line"><a name="l00069"></a><span class="lineno">
69</span> }</div><
div class="line"><a name="l00070"></a><span class="lineno">
70</span> </div><div class="line"><a name="l00071"></a><span
class="lineno"> 71</span> </div><div class="line"><a
name="l00072"></a><span class="lineno"><a class="line"
href="namespaceos.html#a73da9d49515dfff761c4887c3d6032c0">
72</a></span> <span class="keyword">inline</span> <a class="code"
href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386">ssize_t</a>
<a class="code"
href="namespaceos.html#a73da9d49515dfff761c4887c3d6032c0">write</a>(<span
class="keyword">const</span> <a class="code"
href="int__fd_8hpp.html#aea4dbda01c90455f158ffa9b924c2f07">int_fd</a>& fd,
<span class="keyword">const</span> <span class="keywordtype">void</span>* data,
<span class="keywordtype">size_t</span> <a class="code"
href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">size</a>)</div><div
class="line"><a name="l00073"></a><span class="lineno">
73</span> {</div><d
iv class="line"><a name="l00074"></a><span class="lineno"> 74</span> 
CHECK_LE(size, INT_MAX);</div><div class="line"><a name="l00075"></a><span
class="lineno"> 75</span> </div><div class="line"><a
name="l00076"></a><span class="lineno"> 76</span>  <span
class="keywordflow">switch</span> (fd.type()) {</div><div class="line"><a
name="l00077"></a><span class="lineno"> 77</span>  <span
class="keywordflow">case</span> <a class="code"
href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5ad09c4cb1265f1772bb757a7af277b49f">WindowsFD::Type::HANDLE</a>:
{</div><div class="line"><a name="l00078"></a><span class="lineno">
78</span>  <span class="comment">// Handle non-overlapped case. We
just use the regular `WriteFile` since</span></div><div class="line"><a
name="l00079"></a><span class="lineno"> 79</span>  <span
class="comment">// seekable overlapped files require an offset, which we
don't track.</span></div><div class=
"line"><a name="l00080"></a><span class="lineno"> 80</span>  <span
class="keywordflow">if</span> (!fd.is_overlapped()) {</div><div class="line"><a
name="l00081"></a><span class="lineno"> 81</span>  DWORD
bytes;</div><div class="line"><a name="l00082"></a><span class="lineno">
82</span>  <span class="keyword">const</span> BOOL result
=</div><div class="line"><a name="l00083"></a><span class="lineno">
83</span>  ::WriteFile(fd, data, static_cast<DWORD>(size),
&bytes, <span class="keyword">nullptr</span>);</div><div class="line"><a
name="l00084"></a><span class="lineno"> 84</span> </div><div
class="line"><a name="l00085"></a><span class="lineno"> 85</span> 
<span class="keywordflow">if</span> (result == FALSE) {</div><div
class="line"><a name="l00086"></a><span class="lineno"> 86</span> 
<span class="comment">// Indicates an error, but we can't return a
`WindowsError`.</span></div
><div class="line"><a name="l00087"></a><span class="lineno">
>87</span>  <span class="keywordflow">return</span>
>-1;</div><div class="line"><a name="l00088"></a><span class="lineno">
>88</span>  }</div><div class="line"><a name="l00089"></a><span
>class="lineno"> 89</span> </div><div class="line"><a
>name="l00090"></a><span class="lineno"> 90</span>  <span
>class="keywordflow">return</span> <span
>class="keyword">static_cast<</span><a class="code"
>href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386">ssize_t</a><span
> class="keyword">></span>(bytes);</div><div class="line"><a
>name="l00091"></a><span class="lineno"> 91</span>  }</div><div
>class="line"><a name="l00092"></a><span class="lineno">
>92</span> </div><div class="line"><a name="l00093"></a><span
>class="lineno"> 93</span>  <span class="comment">// Asynchronous
>handle, we can use the `write_async` function</sp
an></div><div class="line"><a name="l00094"></a><span class="lineno">
94</span>  <span class="comment">// and then wait on the overlapped
object for a synchronous write.</span></div><div class="line"><a
name="l00095"></a><span class="lineno"> 95</span>  <a class="code"
href="classTry.html">Try<OVERLAPPED></a> overlapped_ =</div><div
class="line"><a name="l00096"></a><span class="lineno"> 96</span> 
<a class="code"
href="namespaceinternal_1_1windows.html#a388bd9a30ab487f5d035e542187e379a">::internal::windows::init_overlapped_for_sync_io</a>();</div><div
class="line"><a name="l00097"></a><span class="lineno">
97</span> </div><div class="line"><a name="l00098"></a><span
class="lineno"> 98</span>  <span class="keywordflow">if</span>
(overlapped_.<a class="code"
href="classTry.html#a0b98f95163b8a38daafd1651b043a276">isError</a>())
{</div><div class="line"><a name="l00099"></a><span class="lineno">
99</span>  <sp
an class="keywordflow">return</span> -1;</div><div class="line"><a
name="l00100"></a><span class="lineno"> 100</span>  }</div><div
class="line"><a name="l00101"></a><span class="lineno">
101</span> </div><div class="line"><a name="l00102"></a><span
class="lineno"> 102</span>  OVERLAPPED overlapped = overlapped_.<a
class="code"
href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">get</a>();</div><div
class="line"><a name="l00103"></a><span class="lineno"> 103</span> 
<a class="code" href="classResult.html">Result<size_t></a> result = <a
class="code"
href="namespaceos.html#a1af52685ba3e8fe8676af86cd16a1eb8">write_async</a>(fd,
data, size, &overlapped);</div><div class="line"><a name="l00104"></a><span
class="lineno"> 104</span> </div><div class="line"><a
name="l00105"></a><span class="lineno"> 105</span>  <span
class="keywordflow">if</span> (result.<a class="code"
href="classResult.html#aeca16ad17d299ad885c9b46c83b12a
3d">isError</a>()) {</div><div class="line"><a name="l00106"></a><span
class="lineno"> 106</span>  <span
class="keywordflow">return</span> -1;</div><div class="line"><a
name="l00107"></a><span class="lineno"> 107</span>  }</div><div
class="line"><a name="l00108"></a><span class="lineno">
108</span> </div><div class="line"><a name="l00109"></a><span
class="lineno"> 109</span>  <span class="keywordflow">if</span>
(result.<a class="code"
href="classResult.html#a85eaa52037223d71092e65701c166562">isSome</a>())
{</div><div class="line"><a name="l00110"></a><span class="lineno">
110</span>  <span class="keywordflow">return</span> result.<a
class="code"
href="classResult.html#aedf79f3b14dcda5791b84a64ada4d412">get</a>();</div><div
class="line"><a name="l00111"></a><span class="lineno"> 111</span> 
}</div><div class="line"><a name="l00112"></a><span class="lineno">
112</span> </div><div class="line"><a name="l00113"></a><
span class="lineno"> 113</span>  <span class="comment">// IO is
pending, so wait for the overlapped object.</span></div><div class="line"><a
name="l00114"></a><span class="lineno"> 114</span>  DWORD
bytes;</div><div class="line"><a name="l00115"></a><span class="lineno">
115</span>  <span class="keyword">const</span> BOOL wait_success
=</div><div class="line"><a name="l00116"></a><span class="lineno">
116</span>  ::GetOverlappedResult(fd, &overlapped, &bytes,
TRUE);</div><div class="line"><a name="l00117"></a><span class="lineno">
117</span> </div><div class="line"><a name="l00118"></a><span
class="lineno"> 118</span>  <span class="keywordflow">if</span>
(wait_success == FALSE) {</div><div class="line"><a name="l00119"></a><span
class="lineno"> 119</span>  <span
class="keywordflow">return</span> -1;</div><div class="line"><a
name="l00120"></a><span class="lineno"> 120</span>  }</div><div c
lass="line"><a name="l00121"></a><span class="lineno">
121</span> </div><div class="line"><a name="l00122"></a><span
class="lineno"> 122</span>  <span class="keywordflow">return</span>
<span class="keyword">static_cast<</span><a class="code"
href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386">ssize_t</a><span
class="keyword">></span>(bytes);</div><div class="line"><a
name="l00123"></a><span class="lineno"> 123</span>  }</div><div
class="line"><a name="l00124"></a><span class="lineno"> 124</span> 
<span class="keywordflow">case</span> <a class="code"
href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5a75fbea08c09e684e6b3f3961761354fa">WindowsFD::Type::SOCKET</a>:
{</div><div class="line"><a name="l00125"></a><span class="lineno">
125</span>  <a class="code"
href="namespaceprocess_1_1windows.html#a04c64346155d34517acdf8b587162868">return
::send</a>(fd, (<span class="keyword">const
</span> <span class="keywordtype">char</span>*)data,
static_cast<int>(size), 0);</div><div class="line"><a
name="l00126"></a><span class="lineno"> 126</span>  }</div><div
class="line"><a name="l00127"></a><span class="lineno"> 127</span> 
}</div><div class="line"><a name="l00128"></a><span class="lineno">
128</span> </div><div class="line"><a name="l00129"></a><span
class="lineno"> 129</span>  <a class="code"
href="unreachable_8hpp.html#a0bc63b24b654ca433be7b97a3edde132">UNREACHABLE</a>();</div><div
class="line"><a name="l00130"></a><span class="lineno">
130</span> }</div><div class="line"><a name="l00131"></a><span
class="lineno"> 131</span> </div><div class="line"><a
name="l00132"></a><span class="lineno"> 132</span> } <span
class="comment">// namespace os {</span></div><div class="line"><a
name="l00133"></a><span class="lineno"> 133</span> </div><div
class="line"><a name="l00134"></a><span class="lineno"> 134</span> 
;</div><div class="line"><a name="l00135"></a><span class="lineno">
135</span> <span class="preprocessor">#endif //
__STOUT_OS_WINDOWS_WRITE_HPP__</span></div><div class="ttc"
id="3rdparty_2stout_2include_2stout_2windows_8hpp_html_a894c4d58faeee7675b9e7e8244de1386"><div
class="ttname"><a
href="3rdparty_2stout_2include_2stout_2windows_8hpp.html#a894c4d58faeee7675b9e7e8244de1386">ssize_t</a></div><div
class="ttdeci">SSIZE_T ssize_t</div><div class="ttdef"><b>Definition:</b>
windows.hpp:186</div></div>
<div class="ttc"
id="namespaceos_1_1stat_html_a7a116891923bc8b5d8c50f78da8657be"><div
class="ttname"><a
href="namespaceos_1_1stat.html#a7a116891923bc8b5d8c50f78da8657be">os::stat::size</a></div><div
class="ttdeci">Try< Bytes > size(const std::string &path, const
FollowSymlink follow=FollowSymlink::FOLLOW_SYMLINK)</div><div
class="ttdef"><b>Definition:</b> stat.hpp:121</div></div>
<div class="ttc" id="classTry_html_a8bc7f43e75a47111ea18e9c83b007be5"><div
class="ttname"><a
href="classTry.html#a8bc7f43e75a47111ea18e9c83b007be5">Try::get</a></div><div
class="ttdeci">T & get()&</div><div class="ttdef"><b>Definition:</b>
try.hpp:73</div></div>
<div class="ttc" id="namespaceos_html_a73da9d49515dfff761c4887c3d6032c0"><div
class="ttname"><a
href="namespaceos.html#a73da9d49515dfff761c4887c3d6032c0">os::write</a></div><div
class="ttdeci">ssize_t write(const int_fd &fd, const void *data, size_t
size)</div><div class="ttdef"><b>Definition:</b> write.hpp:72</div></div>
@@ -65,7 +65,6 @@
<div class="ttc"
id="classos_1_1WindowsFD_html_ac0377db41e1c167339c97dbd69c79ae5a75fbea08c09e684e6b3f3961761354fa"><div
class="ttname"><a
href="classos_1_1WindowsFD.html#ac0377db41e1c167339c97dbd69c79ae5a75fbea08c09e684e6b3f3961761354fa">os::WindowsFD::Type::SOCKET</a></div></div>
<div class="ttc" id="3rdparty_2stout_2include_2stout_2windows_8hpp_html"><div
class="ttname"><a
href="3rdparty_2stout_2include_2stout_2windows_8hpp.html">windows.hpp</a></div></div>
<div class="ttc" id="classResult_html"><div class="ttname"><a
href="classResult.html">Result</a></div><div class="ttdef"><b>Definition:</b>
check.hpp:30</div></div>
-<div class="ttc" id="namespacenet_html_aa0a46766b4aca53ea50e1921567ddb40"><div
class="ttname"><a
href="namespacenet.html#aa0a46766b4aca53ea50e1921567ddb40">net::send</a></div><div
class="ttdeci">ssize_t send(const int_fd &fd, const void *buf, size_t len,
int flags)</div><div class="ttdef"><b>Definition:</b> socket.hpp:159</div></div>
<div class="ttc" id="namespaceos_html_a1af52685ba3e8fe8676af86cd16a1eb8"><div
class="ttname"><a
href="namespaceos.html#a1af52685ba3e8fe8676af86cd16a1eb8">os::write_async</a></div><div
class="ttdeci">Result< size_t > write_async(const int_fd &fd, const
void *data, size_t size, OVERLAPPED *overlapped)</div><div
class="ttdef"><b>Definition:</b> write.hpp:31</div></div>
<div class="ttc" id="nothing_8hpp_html"><div class="ttname"><a
href="nothing_8hpp.html">nothing.hpp</a></div></div>
<div class="ttc" id="classResult_html_aedf79f3b14dcda5791b84a64ada4d412"><div
class="ttname"><a
href="classResult.html#aedf79f3b14dcda5791b84a64ada4d412">Result::get</a></div><div
class="ttdeci">const T & get() const </div><div
class="ttdef"><b>Definition:</b> result.hpp:115</div></div>
@@ -78,6 +77,7 @@
<div class="ttc" id="classResult_html_aeca16ad17d299ad885c9b46c83b12a3d"><div
class="ttname"><a
href="classResult.html#aeca16ad17d299ad885c9b46c83b12a3d">Result::isError</a></div><div
class="ttdeci">bool isError() const </div><div
class="ttdef"><b>Definition:</b> result.hpp:113</div></div>
<div class="ttc" id="int__fd_8hpp_html_aea4dbda01c90455f158ffa9b924c2f07"><div
class="ttname"><a
href="int__fd_8hpp.html#aea4dbda01c90455f158ffa9b924c2f07">int_fd</a></div><div
class="ttdeci">int int_fd</div><div class="ttdef"><b>Definition:</b>
int_fd.hpp:35</div></div>
<div class="ttc" id="unreachable_8hpp_html"><div class="ttname"><a
href="unreachable_8hpp.html">unreachable.hpp</a></div></div>
+<div class="ttc"
id="namespaceprocess_1_1windows_html_a04c64346155d34517acdf8b587162868"><div
class="ttname"><a
href="namespaceprocess_1_1windows.html#a04c64346155d34517acdf8b587162868">process::windows::send</a></div><div
class="ttdeci">Future< size_t > send(const int_fd &fd, const void
*buf, size_t size)</div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
