Boost C++ 库

...世界上最受推崇、设计最精良的 C++ 库项目之一。 Herb SutterAndrei Alexandrescu, C++ Coding Standards

write (16 个重载中的第 8 个) - Boost C++ 函数库
PrevUpHomeNext

在返回前将一定量的数据写入流。

template<
    typename SyncWriteStream,
    typename DynamicBuffer_v1,
    typename CompletionCondition>
std::size_t write(
    SyncWriteStream & s,
    DynamicBuffer_v1 && buffers,
    CompletionCondition completion_condition,
    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,
    constraint_t< is_completion_condition< CompletionCondition >::value >  = 0);

此函数用于将指定数量的字节数据写入流。调用将阻塞,直到以下任一条件为真。

  • supplied 动态缓冲区序列中的所有数据都已写入。
  • completion_condition 函数对象返回 0。

此操作是根据对流的 `write_some` 函数的零次或多次调用来实现的。

参数

s

要写入数据的数据流。类型必须支持 SyncWriteStream 概念。

缓冲区

将要写入数据的动态缓冲区序列。成功写入的数据将自动从缓冲区中消耗。

completion_condition

用于确定写入操作是否完成的函数对象。函数对象的签名必须是:

std::size_t completion_condition(
  // Result of latest write_some operation.
  const boost::system::error_code& error,

  // Number of bytes transferred so far.
  std::size_t bytes_transferred
);

返回值为 0 表示写入操作已完成。非零返回值表示下一次调用流的 `write_some` 函数时要写入的最大字节数。

ec

用于指示发生何种错误(如果有)。

返回值

已写入的字节数。如果发生错误,则返回错误前成功传输的总字节数。


PrevUpHomeNext