Exit Zen
1
string ID 10
type: section title
English
Message Containers
18/180 · 18
2
string ID 12
type: paragraph
English
Beast provides a single class template __message__ and some aliases which model HTTP/1 and [@https://tools.ietf.org/html/rfc7540 HTTP/2] messages:
146/1460 · 146
3
string ID 17
type: table title
English
Message
7/100 · 7
17
string ID 17
type: table cell
English
Name
4/100 · 4
17
string ID 17
type: table cell
English
Description
11/110 · 11
6
string ID 17
type: table cell
English
__message__
11/110 · 11
7
string ID 17
type: table code
English
/// An HTTP message
template<
bool isRequest, // `true` for requests, `false` for responses
class Body, // Controls the container and algorithms used for the body
class Fields = fields> // The type of container to store the fields
class message;
278/2780 · 278
8
string ID 17
type: table cell
English
[link beast.ref.boost__beast__http__request `request`]
54/540 · 54
9
string ID 17
type: table code
English
/// A typical HTTP request
template<class Body, class Fields = fields>
using request = message<true, Body, Fields>;
115/1150 · 115
10
string ID 17
type: table cell
English
[link beast.ref.boost__beast__http__response `response`]
56/560 · 56
11
string ID 17
type: table code
English
/// A typical HTTP response
template<class Body, class Fields = fields>
using response = message<false, Body, Fields>;
118/1180 · 118
12
string ID 51
type: paragraph
English
The container offers value semantics including move and copy if supported by __Body__ and __Fields__. User defined template function parameters can accept any message, or can use partial specialization to accept just requests or responses. The default __fields__ is a provided associative container using the standard allocator and supporting modification and inspection of fields. As per __rfc7230__, a non-case-sensitive comparison is used for field names. User defined types for fields are possible. The `Body` type determines the type of the container used to represent the body as well as the algorithms for transferring buffers to and from the container. The library comes with a collection of common body types. As with fields, user defined body types are possible.
772/7720 · 772
13
string ID 63
type: paragraph
English
Sometimes it is desired to only work with a header. Beast provides a single class template __header__ and some aliases to model HTTP/1 and HTTP/2 headers:
154/1540 · 154
14
string ID 66
type: table title
English
Header
6/100 · 6
66
string ID 66
type: table cell
English
Name
4/100 · 4
66
string ID 66
type: table cell
English
Description
11/110 · 11
17
string ID 66
type: table cell
English
__header__
10/100 · 10
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