Zen

Source string Source string

type: table cell
1117/10000 · 1117

The string is read-only.

English Actions
Requirements
In this table:
* `B` is a type meeting the requirements of [*Body].
* `m` is a value of type `message<b,B,F>` where `b` is a `bool` value
Valid expressions
Expression
Type
Semantics, Pre/Post-conditions
`B::value_type`
The return type of the `message::body` member function. If this is not movable or not copyable, the containing message will be not movable or not copyable.
`B::reader`
If present, indicates that the body can be parsed. The type must meet the requirements of __BodyReader__. The implementation constructs an object of this type to obtain buffers into which parsed body octets are placed.
`B::writer`
If present, indicates that the body is serializable. The type must meet the requirements of __BodyWriter__. The implementation constructs an object of this type to obtain buffers representing the message body for serialization.
B::size(
B::value_type body)
`std::uint64_t`
This static member function is optional. It returns the payload size of `body` in bytes not including any chunked transfer encoding. The return value may be zero, to indicate that the message is known to have no payload. The function shall not exit via an exception.

When this function is present:

* The function shall not fail

* A call to [link beast.ref.boost__beast__http__message.payload_size `message::payload_size`] will return the same value as `size`.

* A call to [link beast.ref.boost__beast__http__message.prepare_payload `message::prepare_payload`] will remove "chunked" from the Transfer-Encoding field if it appears as the last encoding, and will set the Content-Length field to the returned value.

Otherwise, when the function is omitted:

* A call to [link beast.ref.boost__beast__http__message.payload_size `message::payload_size`] will return `boost::none`.

* A call to [link beast.ref.boost__beast__http__message.prepare_payload `message::prepare_payload`] will erase the Content-Length field, and add "chunked" as the last encoding in the Transfer-Encoding field if it is not already present.
Exemplar
Models
* [link beast.ref.boost__beast__http__basic_dynamic_body `basic_dynamic_body`]
* [link beast.ref.boost__beast__http__basic_file_body `basic_file_body`]
* [link beast.ref.boost__beast__http__basic_string_body `basic_string_body`]
* [link beast.ref.boost__beast__http__buffer_body `buffer_body`]
* [link beast.ref.boost__beast__http__empty_body `empty_body`]
* [link beast.ref.boost__beast__http__span_body `span_body`]
* [link beast.ref.boost__beast__http__vector_body `vector_body`]
English Actions
Requirements
In this table:
* `B` is a type meeting the requirements of [*Body].
* `m` is a value of type `message<b,B,F>` where `b` is a `bool` value
Valid expressions
Expression
Type
Semantics, Pre/Post-conditions
`B::value_type`
The return type of the `message::body` member function. If this is not movable or not copyable, the containing message will be not movable or not copyable.
`B::reader`
If present, indicates that the body can be parsed. The type must meet the requirements of __BodyReader__. The implementation constructs an object of this type to obtain buffers into which parsed body octets are placed.
`B::writer`
If present, indicates that the body is serializable. The type must meet the requirements of __BodyWriter__. The implementation constructs an object of this type to obtain buffers representing the message body for serialization.
B::size(
B::value_type body)
`std::uint64_t`
This static member function is optional. It returns the payload size of `body` in bytes not including any chunked transfer encoding. The return value may be zero, to indicate that the message is known to have no payload. The function shall not exit via an exception.

When this function is present:

* The function shall not fail

* A call to [link beast.ref.boost__beast__http__message.payload_size `message::payload_size`] will return the same value as `size`.

* A call to [link beast.ref.boost__beast__http__message.prepare_payload `message::prepare_payload`] will remove "chunked" from the Transfer-Encoding field if it appears as the last encoding, and will set the Content-Length field to the returned value.

Otherwise, when the function is omitted:

* A call to [link beast.ref.boost__beast__http__message.payload_size `message::payload_size`] will return `boost::none`.

* A call to [link beast.ref.boost__beast__http__message.prepare_payload `message::prepare_payload`] will erase the Content-Length field, and add "chunked" as the last encoding in the Transfer-Encoding field if it is not already present.
Exemplar
Models
* [link beast.ref.boost__beast__http__basic_dynamic_body `basic_dynamic_body`]
* [link beast.ref.boost__beast__http__basic_file_body `basic_file_body`]
* [link beast.ref.boost__beast__http__basic_string_body `basic_string_body`]
* [link beast.ref.boost__beast__http__buffer_body `buffer_body`]
* [link beast.ref.boost__beast__http__empty_body `empty_body`]
* [link beast.ref.boost__beast__http__span_body `span_body`]
* [link beast.ref.boost__beast__http__vector_body `vector_body`]

Loading…

User avatar admin

String added in the repository
This static member function is optional. It returns the payload size of `body` in bytes not including any chunked transfer encoding. The return value may be zero, to indicate that the message is known to have no payload. The function shall not exit via an exception.

When this function is present:

* The function shall not fail

* A call to [link beast.ref.boost__beast__http__message.payload_size `message::payload_size`] will return the same value as `size`.

* A call to [link beast.ref.boost__beast__http__message.prepare_payload `message::prepare_payload`] will remove "chunked" from the Transfer-Encoding field if it appears as the last encoding, and will set the Content-Length field to the returned value.

Otherwise, when the function is omitted:

* A call to [link beast.ref.boost__beast__http__message.payload_size `message::payload_size`] will return `boost::none`.

* A call to [link beast.ref.boost__beast__http__message.prepare_payload `message::prepare_payload`] will erase the Content-Length field, and add "chunked" as the last encoding in the Transfer-Encoding field if it is not already present.
This static member function is optional. It returns the payload size of `body` in bytes not including any chunked transfer encoding. The return value may be zero, to indicate that the message is known to have no payload. The function shall not exit via an exception.

When this function is present:

* The function shall not fail

* A call to [link beast.ref.boost__beast__http__message.payload_size `message::payload_size`] will return the same value as `size`.

* A call to [link beast.ref.boost__beast__http__message.prepare_payload `message::prepare_payload`] will remove "chunked" from the Transfer-Encoding field if it appears as the last encoding, and will set the Content-Length field to the returned value.

Otherwise, when the function is omitted:

* A call to [link beast.ref.boost__beast__http__message.payload_size `message::payload_size`] will return `boost::none`.

* A call to [link beast.ref.boost__beast__http__message.prepare_payload `message::prepare_payload`] will erase the Content-Length field, and add "chunked" as the last encoding in the Transfer-Encoding field if it is not already present.
06/05/2026
Browse all string changes

Glossary

English English
No related strings found in the glossary.

String information

Component
Boost Beast Translation (zh_Hans)/Doc / Qbk / 07 Concepts / Body (qbk)
Source string description
type: table cell
Flags
read-only
Unit identifier
56382
Source string location
string ID 30
String age
06/05/2026
Last updated
06/05/2026
Source string age
06/05/2026
Translation file QuickBook file
doc/qbk/07_concepts/Body.qbk, string 20