User avatar Bstran

Translation changed
* `W` denotes a type meeting the requirements of [*BodyWriter].
* `B` denotes a __Body__ where
* `W` denotes a type meeting the requirements of [*BodyWriter].
* `B` denotes a __Body__ whereW 表示满足 [*BodyWriter] 要求的类型。

B 表示一个 Body 类型，其中
06/18/2026
User avatar Bstran

Translation changed
In this table:
In this table:在下表中：
06/18/2026
User avatar Bstran

Translation changed
These requirements may undergo non-backward compatible
These requirements may undergo non-backward compatible这些要求可能发生不向后兼容的变更
06/18/2026
User avatar Bstran

Translation changed
Requirements
Requirements要求
06/18/2026
User avatar Bstran

Translation changed
* [link beast.ref.boost__beast__http__is_body_writer `is_body_writer`]
* __Body__
* [link beast.ref.boost__beast__http__is_body_writer `is_body_writer`]
* __Body__
06/18/2026
User avatar Bstran

Translation changed
Associated Types
Associated Types关联类型
06/18/2026
User avatar Bstran

Translation changed
* A body that does not entirely fit in memory.
* A body produced incrementally from coroutine output.
* A body represented by zero or more buffers already in memory.
* A body whose size is not known ahead of time.
* Body data generated dynamically from other threads.
* Body data computed algorithmically.
* A body that does not entirely fit in memory.
* A body produced incrementally from coroutine output.
* A body represented by zero or more buffers already in memory.
* A body whose size is not known ahead of time.
* Body data generated dynamically from other threads.
* Body data computed algorithmically.无法完整存入内存的消息体。
* 由协程输出逐步生成的消息体。
* 由已在内存中的零个或多个缓冲区表示的消息体。
* 大小无法预先确定的消息体。
* 由其他线程动态生成的消息体数据。
* 通过算法计算得到的消息体数据。
06/18/2026
User avatar Bstran

Translation changed
A [*BodyWriter] provides an [@https://en.wikipedia.org/wiki/Online_algorithm online algorithm] to obtain a sequence of zero or more buffers from a body during serialization. The implementation creates an instance of this type when needed, and calls into it one or more times to retrieve buffers holding body octets. The interface of [*BodyWriter] is intended to obtain buffers for these scenarios:
A [*BodyWriter] provides an提供一种 [@https://en.wikipedia.org/wiki/Online_algorithm online algorithm] to obtain a sequence of zero or more buffers from a body during serialization. The implementation creates an instance of this type when needed, and calls into it one or more times to retrieve buffers holding body octets. The interface of [*BodyWriter] is intended to obtain buffers for these scenarios:在线算法]，用于在序列化过程中从消息体获取零个或多个缓冲区序列。实现会在需要时创建该类型的实例，并调用一次或多次以检索包含消息体八位字节的缓冲区。[BodyWriter] 的接口设计用于获取以下场景的缓冲区：
06/18/2026
User avatar Bstran

Translation changed
BodyWriter
BodyWriter消息体写入器
06/18/2026
User avatar Bstran

Contributor joined
Contributor joined 06/18/2026
User avatar admin

Resource updated
File “doc/qbk/07_concepts/BodyWriter_zh_Hans.qbk” was added. 06/05/2026
User avatar admin

String added in the repository
* [link beast.ref.boost__beast__http__basic_dynamic_body.writer `basic_dynamic_body::writer`]
* [link beast.ref.boost__beast__http__basic_file_body__writer `basic_file_body::writer`]
* [link beast.ref.boost__beast__http__basic_string_body.writer `basic_string_body::writer`]
* [link beast.ref.boost__beast__http__buffer_body.writer `buffer_body::writer`]
* [link beast.ref.boost__beast__http__empty_body.writer `empty_body::writer`]
* [link beast.ref.boost__beast__http__span_body.writer `span_body::writer`]
* [link beast.ref.boost__beast__http__vector_body.writer `vector_body::writer`]
* [link beast.ref.boost__beast__http__basic_dynamic_body.writer `basic_dynamic_body::writer`]
* [link beast.ref.boost__beast__http__basic_file_body__writer `basic_file_body::writer`]
* [link beast.ref.boost__beast__http__basic_string_body.writer `basic_string_body::writer`]
* [link beast.ref.boost__beast__http__buffer_body.writer `buffer_body::writer`]
* [link beast.ref.boost__beast__http__empty_body.writer `empty_body::writer`]
* [link beast.ref.boost__beast__http__span_body.writer `span_body::writer`]
* [link beast.ref.boost__beast__http__vector_body.writer `vector_body::writer`]
06/05/2026
User avatar admin

String added in the repository
Models
Models
06/05/2026
User avatar admin

String added in the repository
Exemplar
Exemplar
06/05/2026
User avatar admin

String added in the repository
Called one or more times after `init` succeeds. This function returns `boost::none` if all buffers representing the body have been returned in previous calls or if it sets `ec` to indicate an error. Otherwise, if there are buffers remaining the function should return a pair with the first element containing a non-zero length buffer sequence representing the next set of octets in the body, while the second element is a `bool` meaning `true` if there may be additional buffers returned on a subsequent call, or `false` if the buffer returned on this call is the last buffer representing the body. The function will ensure that `!ec` is `true` if there was no error or set to the appropriate error code if there was one.
Called one or more times after `init` succeeds. This function returns `boost::none` if all buffers representing the body have been returned in previous calls or if it sets `ec` to indicate an error. Otherwise, if there are buffers remaining the function should return a pair with the first element containing a non-zero length buffer sequence representing the next set of octets in the body, while the second element is a `bool` meaning `true` if there may be additional buffers returned on a subsequent call, or `false` if the buffer returned on this call is the last buffer representing the body. The function will ensure that `!ec` is `true` if there was no error or set to the appropriate error code if there was one.
06/05/2026
User avatar admin

String added in the repository
`W<W::const_buffers_type>`
`W<W::const_buffers_type>`
06/05/2026
User avatar admin

String added in the repository
`a.get(ec)`
`a.get(ec)`
06/05/2026
User avatar admin

String added in the repository
Called once to fully initialize the object before any calls to `get`. The message body becomes valid before entering this function, and remains valid until the writer is destroyed. The function will ensure that `!ec` is `true` if there was no error or set to the appropriate error code if there was one.
Called once to fully initialize the object before any calls to `get`. The message body becomes valid before entering this function, and remains valid until the writer is destroyed. The function will ensure that `!ec` is `true` if there was no error or set to the appropriate error code if there was one.
06/05/2026
User avatar admin

String added in the repository
`a.init(ec)`
`a.init(ec)`
06/05/2026
User avatar admin

String added in the repository
Constructible from `h` and `v`. The lifetime of `h` and `v` are guaranteed to end no earlier than after the `W` is destroyed. The writer shall not access the contents of `h` or `v` before the first call to `init`, permitting lazy construction of the message.

The constructor may optionally require that `h` and `v` are `const` references, with these consequences:

* If `W` requires that `h` and `v` are const references, then the corresponding serializer constructors for messages with this body type will will accept a const reference to a message, otherwise:

* If `W` requires that `h` and `v` are non-const references, then the corresponding serializer constructors for messages with this body type will require a non-const reference to a message.
Constructible from `h` and `v`. The lifetime of `h` and `v` are guaranteed to end no earlier than after the `W` is destroyed. The writer shall not access the contents of `h` or `v` before the first call to `init`, permitting lazy construction of the message.

The constructor may optionally require that `h` and `v` are `const` references, with these consequences:

* If `W` requires that `h` and `v` are const references, then the corresponding serializer constructors for messages with this body type will will accept a const reference to a message, otherwise:

* If `W` requires that `h` and `v` are non-const references, then the corresponding serializer constructors for messages with this body type will require a non-const reference to a message.
06/05/2026

Search