Exit Zen
1
string ID 10
type: section title
English
Networking
10/100 · 10
2
string ID 12
type: paragraph
English
This library uses the [@http://cplusplus.github.io/networking-ts/draft.pdf Networking Technical Specification], scheduled to become an official part of C++ no sooner than the year 2023. Three implementations exist, with cosmetic differences but otherwise using the same function signatures and type declarations: Boost.Asio, stand-alone Asio, and networking-ts-impl. This table shows how a variable of type `io_context` is declared in each implementation by including the appropriate header and using a suitable namespace alias:
528/5280 · 528
3
string ID 21
type: table title
English
Networking Implementations
26/260 · 26
4
string ID 21
type: table cell
English
Name
4/100 · 4
5
string ID 21
type: table cell
English
Namespace and Header Example
28/280 · 28
6
string ID 21
type: table cell
English
__Asio__
8/100 · 8
7
string ID 21
type: table code
English
#include <boost/asio/io_context.hpp>
namespace net = boost::asio;
net::io_context ioc;
86/860 · 86
8
string ID 21
type: table cell
English
[@https://think-async.com/Asio/ Asio (Standalone)]
50/500 · 50
9
string ID 21
type: table code
English
#include <asio/io_context.hpp>
namespace net = asio;
net::io_context ioc;
73/730 · 73
10
string ID 21
type: table cell
English
[@https://github.com/chriskohlhoff/networking-ts-impl networking-ts-impl]
73/730 · 73
11
string ID 21
type: table code
English
#include <experimental/io_context>
namespace net = std::experimental::net;
net::io_context ioc;
95/950 · 95
12
string ID 53
type: paragraph
English
This document refers to the three implementations above interchangeably and collectively as [*Networking] (or just ['networking]). The Boost.Asio and Asio flavors of Networking provide additional features not currently proposed for C++, but likely to appear in a future specification, such as:
293/2930 · 293
13
string ID 58
type: list
English
* [@boost:/doc/html/boost_asio/reference/serial_port.html Serial ports]
* [@boost:/doc/html/boost_asio/reference/local__stream_protocol.html UNIX domain sockets]
* [@boost:/doc/html/boost_asio/reference/signal_set.html POSIX signals] (e.g. SIGINT, SIGABORT)
* [@boost:/doc/html/boost_asio/reference/ssl__stream.html TLS streams] (such as OpenSSL)
346/3460 · 346
14
string ID 63
type: paragraph
English
Boost.Beast depends specifically on the Boost.Asio flavor of Networking, although this may change in the future. While this library offers performant implementations of the HTTP and WebSocket network protocols, it depends on the networking interfaces to perform general tasks such as performing domain name resolution (DNS lookup), establishing outgoing connections, and accepting incoming connections. Callers are responsible for interacting with networking to initialize objects to the correct state where they are usable by this library.
540/5400 · 540
15
string ID 73
type: paragraph
English
In this documentation, the example code, and the implementation, the `net` namespace is used to qualify Networking identifiers. For Boost.Beast, `net` will be an alias for the `boost::asio` namespace.
200/2000 · 200
16
string ID 77
type: paragraph
English
To further ease of use, this library provides an extensive collection of types and algorithms. This section of the documentation explains these types and algorithms, provides examples of usage, and also provides refreshers and tutorials for working with networking.
265/2650 · 265
17
string ID 82
type: heading
English
Abbreviations
13/130 · 13
18
string ID 84
type: paragraph
English
This documentation assumes familiarity with __Asio__, which is required to work with Beast. Sample code and identifiers used throughout are written as if the following declarations are in effect:
195/1950 · 195
19
string ID 103
type: section title
English
Configuration
13/130 · 13
The translation has come to an end.