Exit Zen
18
string ID 66
type: table code
English
/// An HTTP header
template<
bool isRequest, // `true` for requests, `false` for responses
class Fields = fields> // The type of container to store the fields
class header;
189/1890 · 189
19
string ID 66
type: table cell
English
[link beast.ref.boost__beast__http__request_header `request_header`]
68/680 · 68
20
string ID 66
type: table code
English
/// A typical HTTP request header
template<class Fields>
using request_header = header<true, Fields>;
101/1010 · 101
21
string ID 66
type: table cell
English
[link beast.ref.boost__beast__http__response_header `response_header`]
70/700 · 70
22
string ID 66
type: table code
English
/// A typical HTTP response header
template<class Fields>
using response_header = header<false, Fields>;
104/1040 · 104
23
string ID 99
type: paragraph
English
Requests and responses share the version, fields, and body but have a few members unique to the type. This is implemented by declaring the header classes as partial specializations of `isRequest`. __message__ is derived from __header__; a message may be passed as an argument to a function taking a suitably typed header as a parameter. Additionally, `header` is publicly derived from `Fields`; a message inherits all the member functions of `Fields`. This diagram shows the inheritance relationship between header and message, along with some of the notable differences in members in each partial specialization:
613/6130 · 613
24
string ID 111
type: heading
English
Body Types
10/100 · 10
25
string ID 113
type: paragraph
English
Beast defines the __Body__ concept, which determines both the type of the [link beast.ref.boost__beast__http__message.body `message::body`] member (as seen in the diagram above) and may also include algorithms for transferring buffers in and out. These algorithms are used during parsing and serialization. Users may define their own body types which meet the requirements, or use the ones that come with the library:
417/4170 · 417
26
string ID 120
type: table cell
English
[link beast.ref.boost__beast__http__buffer_body `buffer_body`]
62/620 · 62
27
string ID 120
type: table cell
English
A body whose [link beast.ref.boost__beast__http__buffer_body__value_type `value_type`] holds a raw pointer and size to a caller-provided buffer. This allows for serialization of body data coming from external sources, and incremental parsing of message body content using a fixed size buffer.
292/2920 · 292
28
string ID 120
type: table cell
English
[link beast.ref.boost__beast__http__dynamic_body `dynamic_body`]

[link beast.ref.boost__beast__http__basic_dynamic_body `basic_dynamic_body`]
142/1420 · 142
29
string ID 120
type: table cell
English
A body whose `value_type` is a __DynamicBuffer__. It inherits the insertion complexity of the underlying choice of dynamic buffer. Messages with this body type may be serialized and parsed.
189/1890 · 189
30
string ID 120
type: table cell
English
[link beast.ref.boost__beast__http__empty_body `empty_body`]
60/600 · 60
31
string ID 120
type: table cell
English
A special body with an empty `value_type` indicating that the message has no body. Messages with this body may be serialized and parsed; however, body octets received while parsing a message with this body will generate a unique error.
235/2350 · 235
32
string ID 120
type: table cell
English
[link beast.ref.boost__beast__http__file_body `file_body`]

[link beast.ref.boost__beast__http__basic_file_body `basic_file_body`]
130/1300 · 130
33
string ID 120
type: table cell
English
This body is represented by a file opened for either reading or writing. Messages with this body may be serialized and parsed. HTTP algorithms will use the open file for reading and writing, for streaming and incremental sends and receives.
240/2400 · 240
34
string ID 120
type: table cell
English
[link beast.ref.boost__beast__http__span_body `span_body`]
58/580 · 58
35
string ID 120
type: table cell
English
A body whose `value_type` is a [@boost:/libs/core/doc/html/core/span.html `span`], a non-owning reference to a single linear buffer of bytes. Messages with this body type may be serialized and parsed.
200/2000 · 200
36
string ID 120
type: table cell
English
[link beast.ref.boost__beast__http__string_body `string_body`]

[link beast.ref.boost__beast__http__basic_string_body `basic_string_body`]
138/1380 · 138
37
string ID 120
type: table cell
English
A body whose `value_type` is `std::basic_string` or `std::string`. Insertion complexity is amortized constant time, while capacity grows geometrically. Messages with this body type may be serialized and parsed. This is the type of body used in the examples.
257/2570 · 257