• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<html>
2<head>
3<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4<title>read_at</title>
5<link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7<link rel="home" href="../../boost_asio.html" title="Boost.Asio">
8<link rel="up" href="../reference.html" title="Reference">
9<link rel="prev" href="read/overload16.html" title="read (16 of 16 overloads)">
10<link rel="next" href="read_at/overload1.html" title="read_at (1 of 8 overloads)">
11</head>
12<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
13<table cellpadding="2" width="100%"><tr>
14<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
15<td align="center"><a href="../../../../index.html">Home</a></td>
16<td align="center"><a href="../../../../libs/libraries.htm">Libraries</a></td>
17<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
18<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
19<td align="center"><a href="../../../../more/index.htm">More</a></td>
20</tr></table>
21<hr>
22<div class="spirit-nav">
23<a accesskey="p" href="read/overload16.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../boost_asio.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="read_at/overload1.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
24</div>
25<div class="section">
26<div class="titlepage"><div><div><h3 class="title">
27<a name="boost_asio.reference.read_at"></a><a class="link" href="read_at.html" title="read_at">read_at</a>
28</h3></div></div></div>
29<p>
30        <a class="indexterm" name="boost_asio.indexterm.read_at"></a>
31The <code class="computeroutput">read_at</code> function is a
32        composed operation that reads a certain amount of data at the specified offset
33        before returning.
34      </p>
35<p>
36        Attempt to read a certain amount of data at the specified offset before returning.
37      </p>
38<pre class="programlisting">template&lt;
39    typename <a class="link" href="SyncRandomAccessReadDevice.html" title="Buffer-oriented synchronous random-access read device requirements">SyncRandomAccessReadDevice</a>,
40    typename <a class="link" href="MutableBufferSequence.html" title="Mutable buffer sequence requirements">MutableBufferSequence</a>&gt;
41std::size_t <a class="link" href="read_at/overload1.html" title="read_at (1 of 8 overloads)">read_at</a>(
42    SyncRandomAccessReadDevice &amp; d,
43    uint64_t offset,
44    const MutableBufferSequence &amp; buffers);
45  <span class="emphasis"><em>» <a class="link" href="read_at/overload1.html" title="read_at (1 of 8 overloads)">more...</a></em></span>
46
47template&lt;
48    typename <a class="link" href="SyncRandomAccessReadDevice.html" title="Buffer-oriented synchronous random-access read device requirements">SyncRandomAccessReadDevice</a>,
49    typename <a class="link" href="MutableBufferSequence.html" title="Mutable buffer sequence requirements">MutableBufferSequence</a>&gt;
50std::size_t <a class="link" href="read_at/overload2.html" title="read_at (2 of 8 overloads)">read_at</a>(
51    SyncRandomAccessReadDevice &amp; d,
52    uint64_t offset,
53    const MutableBufferSequence &amp; buffers,
54    boost::system::error_code &amp; ec);
55  <span class="emphasis"><em>» <a class="link" href="read_at/overload2.html" title="read_at (2 of 8 overloads)">more...</a></em></span>
56
57template&lt;
58    typename <a class="link" href="SyncRandomAccessReadDevice.html" title="Buffer-oriented synchronous random-access read device requirements">SyncRandomAccessReadDevice</a>,
59    typename <a class="link" href="MutableBufferSequence.html" title="Mutable buffer sequence requirements">MutableBufferSequence</a>,
60    typename <a class="link" href="CompletionCondition.html" title="Completion condition requirements">CompletionCondition</a>&gt;
61std::size_t <a class="link" href="read_at/overload3.html" title="read_at (3 of 8 overloads)">read_at</a>(
62    SyncRandomAccessReadDevice &amp; d,
63    uint64_t offset,
64    const MutableBufferSequence &amp; buffers,
65    CompletionCondition completion_condition);
66  <span class="emphasis"><em>» <a class="link" href="read_at/overload3.html" title="read_at (3 of 8 overloads)">more...</a></em></span>
67
68template&lt;
69    typename <a class="link" href="SyncRandomAccessReadDevice.html" title="Buffer-oriented synchronous random-access read device requirements">SyncRandomAccessReadDevice</a>,
70    typename <a class="link" href="MutableBufferSequence.html" title="Mutable buffer sequence requirements">MutableBufferSequence</a>,
71    typename <a class="link" href="CompletionCondition.html" title="Completion condition requirements">CompletionCondition</a>&gt;
72std::size_t <a class="link" href="read_at/overload4.html" title="read_at (4 of 8 overloads)">read_at</a>(
73    SyncRandomAccessReadDevice &amp; d,
74    uint64_t offset,
75    const MutableBufferSequence &amp; buffers,
76    CompletionCondition completion_condition,
77    boost::system::error_code &amp; ec);
78  <span class="emphasis"><em>» <a class="link" href="read_at/overload4.html" title="read_at (4 of 8 overloads)">more...</a></em></span>
79
80template&lt;
81    typename <a class="link" href="SyncRandomAccessReadDevice.html" title="Buffer-oriented synchronous random-access read device requirements">SyncRandomAccessReadDevice</a>,
82    typename Allocator&gt;
83std::size_t <a class="link" href="read_at/overload5.html" title="read_at (5 of 8 overloads)">read_at</a>(
84    SyncRandomAccessReadDevice &amp; d,
85    uint64_t offset,
86    basic_streambuf&lt; Allocator &gt; &amp; b);
87  <span class="emphasis"><em>» <a class="link" href="read_at/overload5.html" title="read_at (5 of 8 overloads)">more...</a></em></span>
88
89template&lt;
90    typename <a class="link" href="SyncRandomAccessReadDevice.html" title="Buffer-oriented synchronous random-access read device requirements">SyncRandomAccessReadDevice</a>,
91    typename Allocator&gt;
92std::size_t <a class="link" href="read_at/overload6.html" title="read_at (6 of 8 overloads)">read_at</a>(
93    SyncRandomAccessReadDevice &amp; d,
94    uint64_t offset,
95    basic_streambuf&lt; Allocator &gt; &amp; b,
96    boost::system::error_code &amp; ec);
97  <span class="emphasis"><em>» <a class="link" href="read_at/overload6.html" title="read_at (6 of 8 overloads)">more...</a></em></span>
98
99template&lt;
100    typename <a class="link" href="SyncRandomAccessReadDevice.html" title="Buffer-oriented synchronous random-access read device requirements">SyncRandomAccessReadDevice</a>,
101    typename Allocator,
102    typename <a class="link" href="CompletionCondition.html" title="Completion condition requirements">CompletionCondition</a>&gt;
103std::size_t <a class="link" href="read_at/overload7.html" title="read_at (7 of 8 overloads)">read_at</a>(
104    SyncRandomAccessReadDevice &amp; d,
105    uint64_t offset,
106    basic_streambuf&lt; Allocator &gt; &amp; b,
107    CompletionCondition completion_condition);
108  <span class="emphasis"><em>» <a class="link" href="read_at/overload7.html" title="read_at (7 of 8 overloads)">more...</a></em></span>
109
110template&lt;
111    typename <a class="link" href="SyncRandomAccessReadDevice.html" title="Buffer-oriented synchronous random-access read device requirements">SyncRandomAccessReadDevice</a>,
112    typename Allocator,
113    typename <a class="link" href="CompletionCondition.html" title="Completion condition requirements">CompletionCondition</a>&gt;
114std::size_t <a class="link" href="read_at/overload8.html" title="read_at (8 of 8 overloads)">read_at</a>(
115    SyncRandomAccessReadDevice &amp; d,
116    uint64_t offset,
117    basic_streambuf&lt; Allocator &gt; &amp; b,
118    CompletionCondition completion_condition,
119    boost::system::error_code &amp; ec);
120  <span class="emphasis"><em>» <a class="link" href="read_at/overload8.html" title="read_at (8 of 8 overloads)">more...</a></em></span>
121</pre>
122<h5>
123<a name="boost_asio.reference.read_at.h0"></a>
124        <span class="phrase"><a name="boost_asio.reference.read_at.requirements"></a></span><a class="link" href="read_at.html#boost_asio.reference.read_at.requirements">Requirements</a>
125      </h5>
126<p>
127        <span class="emphasis"><em>Header: </em></span><code class="literal">boost/asio/read_at.hpp</code>
128      </p>
129<p>
130        <span class="emphasis"><em>Convenience header: </em></span><code class="literal">boost/asio.hpp</code>
131      </p>
132</div>
133<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
134<td align="left"></td>
135<td align="right"><div class="copyright-footer">Copyright © 2003-2020 Christopher M.
136      Kohlhoff<p>
137        Distributed under the Boost Software License, Version 1.0. (See accompanying
138        file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
139      </p>
140</div></td>
141</tr></table>
142<hr>
143<div class="spirit-nav">
144<a accesskey="p" href="read/overload16.html"><img src="../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../boost_asio.html"><img src="../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="read_at/overload1.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a>
145</div>
146</body>
147</html>
148