Exit Zen
7
string ID 46
type: paragraph
English
Ping, pong, and close messages are control frames which may be sent at any time by either peer on an established WebSocket connection. They are sent using the functions [link beast.ref.boost__beast__websocket__stream.ping `ping`], [link beast.ref.boost__beast__websocket__stream.pong `pong`]. and [link beast.ref.boost__beast__websocket__stream.close `close`]. To be notified of control frames, callers may register a ['control callback] using [link beast.ref.boost__beast__websocket__stream.control_callback `control_callback`]. The object provided with this option should be callable with the following signature:
615/6150 · 615
7
string ID 40
type: paragraph
English
The Expect field with the value "100-continue" in a request is special. It indicates that the after sending the message header, a client desires an immediate informational response before sending the message body, which presumably may be expensive to compute or large. This behavior is described in [@https://tools.ietf.org/html/rfc7231#section-5.1.1 rfc7231 section 5.1.1]. Invoking the 100-continue behavior is implemented easily in a client by constructing a __serializer__ to send the header first, then receiving the server response, and finally conditionally send the body using the same serializer instance. A synchronous, simplified version (no timeout) of this client action looks like this:
700/7000 · 700
7
string ID 36
type: paragraph
English
A client must also verify that the hostname or IP address in the certificate matches the expected one. The [@boost:/doc/html/boost_asio/reference/ssl__host_name_verification.html `net::ssl::host_name_verification`] helper function object can perform this verification according to the rules described in RFC 6125:
313/3130 · 313
7
string ID 27
type: list
English
* [*Performance:] Build applications handling thousands of connections or more.
79/790 · 79
7
string ID 48
type: list
English
* Type erasing the final handler. This will cause undefined behavior.
69/690 · 69
7
string ID 19
type: table cell
English
Enables the split compilation mode, which allows the user to compile definitions of non-template entities in a single translation unit, thus improving compilation speed. That translation unit has to include boost/beast/src.hpp in order to compile the definitions.
263/2630 · 263
7
string ID 46
type: table title
English
Layered Stream Algorithms and Types
35/350 · 35
8
string ID 42
type: paragraph
English
In such scenarios, `http::read` or `http::async_read` operations succeed as they don't need EOF to complete. However, the next operation on the stream would fail with an [@boost:/doc/html/boost_asio/reference/ssl__error__stream_errors.html `net::ssl::error::stream_truncated`] error.
283/2830 · 283
8
string ID 56
type: paragraph
English
First we declare the initiating function and document the requirements, parameters, preconditions, and effects:
111/1110 · 111
25
string ID 25
type: table cell
English
HTTP, asynchronous
18/180 · 18
8
string ID 21
type: table cell
English
__SyncWriteStream__
19/190 · 19
8
string ID 16
type: table cell
English
[link beast.ref.boost__beast__http__async_read.overload2 [*async_read]]
71/710 · 71
8
string ID 47
type: table cell
English
This request has a method of "GET", a target of "/", and indicates HTTP version 1.1. It contains a single field called "User-Agent" whose value is "Beast". There is no message body.
181/1810 · 181
8
string ID 67
type: paragraph
English
A [@https://en.wikipedia.org/wiki/Data_buffer ['buffer]] holds a contiguous sequence of bytes used when performing I/O. The types [@boost:/doc/html/boost_asio/reference/const_buffer.html `net::const_buffer`] and [@boost:/doc/html/boost_asio/reference/mutable_buffer.html `net::mutable_buffer`] represent these memory regions as type-safe pointer/size pairs:
357/3570 · 357
8
string ID 63
type: paragraph
English
The standard library provides the type `std::ostream` for performing high level write operations on character streams. The variable `std::cout` is based on this output stream. This example uses the buffer oriented interface of __serializer__ to write an HTTP message to a `std::ostream`:
287/2870 · 287
8
string ID 25
type: variablelist cell
English
Serialization
13/130 · 13
8
string ID 17
type: table cell
English
[link beast.ref.boost__beast__http__request `request`]
54/540 · 54
8
string ID 42
type: list
English
* [issue 3042] `http::field` constants are updated.
51/510 · 51
8
string ID 38
type: list
English
* `boost::asio::is_dynamic_buffer`
* __ConstBufferSequence__
* __MutableBufferSequence__
88/880 · 88
8
string ID 30
type: table title
English
Valid expressions
17/170 · 17