Boost C++ 库

...是世界上备受推崇、设计精良的 C++ 库项目之一。 — Herb Sutter 和 Andrei Alexandrescu，《C++ 编码规范》

读取 (16个重载中的 6 个) - Boost C++ 函数库

读取 (16个重载中的 6 个)

尝试从流中读取指定数量的数据，然后返回。

template<
    typename SyncReadStream,
    typename DynamicBuffer_v1>
std::size_t read(
    SyncReadStream & s,
    DynamicBuffer_v1 && buffers,
    boost::system::error_code & ec,
    constraint_t< is_dynamic_buffer_v1< decay_t< DynamicBuffer_v1 > >::value >  = 0,
    constraint_t< !is_dynamic_buffer_v2< decay_t< DynamicBuffer_v1 > >::value >  = 0);

此函数用于从流中读取指定数量的字节数据。调用将阻塞，直到满足以下任一条件：

提供的缓冲区已满（即已达到最大大小）。
发生错误。

此操作通过零次或多次调用流的 read_some 函数来实现。

参数

s: 要从中读取数据的流。类型必须支持 SyncReadStream 概念。
缓冲区: 将要读取数据的动态缓冲区序列。
ec: 用于指示发生何种错误（如果有）。

返回值

传输的字节数。

备注

此重载等同于调用

boost::asio::read(
   s, buffers,
   boost::asio::transfer_all(), ec);