...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Write part of a message to a stream using a serializer.
Defined in header <boost/beast/http/write.hpp>
template< class SyncWriteStream, bool isRequest, class Body, class Fields> std::size_t write_some( SyncWriteStream& stream, serializer< isRequest, Body, Fields >& sr);
This function is used to write part of a message to a stream using a caller-provided HTTP/1 serializer. The call will block until one of the following conditions is true:
serializer::is_done
returns true
This operation is implemented in terms of one or more calls to the stream's
write_some
function.
The amount of data actually transferred is controlled by the behavior of
the underlying stream, subject to the buffer size limit of the serializer
obtained or set through a call to serializer::limit
. Setting a limit and performing
bounded work helps applications set reasonable timeouts. It also allows
application-level flow control to function correctly. For example when
using a TCP/IP based stream.
Name |
Description |
---|---|
|
The stream to which the data is to be written. The type must support the SyncWriteStream concept. |
|
The serializer to use. |
The number of bytes written to the stream.
Type |
Thrown On |
---|---|
|
Thrown on failure. |