Boost C++ 库

...世界上最受推崇和专业设计的 C++ 库项目之一。 — Herb Sutter 和 Andrei Alexandrescu, C++ 编码标准

read_at (8 个重载中的 5 个)

尝试在返回之前，在指定的偏移量处读取一定量的数据。

template<
    typename SyncRandomAccessReadDevice,
    typename Allocator>
std::size_t read_at(
    SyncRandomAccessReadDevice & d,
    uint64_t offset,
    basic_streambuf< Allocator > & b);

此函数用于从随机访问设备在指定的偏移量处读取一定数量的字节数据。调用将阻塞，直到以下条件之一为真

发生错误。

此操作通过零次或多次调用设备的 read_some_at 函数来实现。

参数

d: 从中读取数据的设备。该类型必须支持 SyncRandomAccessReadDevice 概念。
offset: 数据将被读取的偏移量。
b: 数据将被读取到的 basic_streambuf 对象。

返回值

传输的字节数。

异常

boost::system::system_error: 失败时抛出。

备注

此重载等效于调用

boost::asio::read_at(
   d, 42, b,
   boost::asio::transfer_all());