2
0
mirror of https://github.com/boostorg/asio.git synced 2026-02-23 14:02:13 +00:00
Files
asio/doc/requirements/asynchronous_socket_operations.qbk
Christopher Kohlhoff 35e93e4e90 Update copyright notices.
2023-03-01 23:03:03 +11:00

40 lines
1.7 KiB
Plaintext

[/
/ Copyright (c) 2003-2023 Christopher M. Kohlhoff (chris at kohlhoff dot com)
/
/ Distributed under the Boost Software License, Version 1.0. (See accompanying
/ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
/]
[section:asynchronous_socket_operations Requirements on asynchronous socket operations]
In this library, ['asynchronous socket operations] are those member functions
having prefix `async_`.
For an object `s`, a program may initiate asynchronous socket operations such
that there are multiple simultaneously outstanding asynchronous operations.
When there are multiple outstanding asynchronous [link
boost_asio.reference.read_write_operations read operations] on `s`:
[mdash] having no argument `flags` of type `socket_base::message_flags`, or
[mdash] having an argument `flags` of type `socket_base::message_flags` but
where `(flags & socket_base::message_out_of_band) == 0`
then the `buffers` are filled in the order in which these operations were
issued. The order of invocation of the completion handlers for these operations
is unspecified.
When there are multiple outstanding asynchronous [link
boost_asio.reference.read_write_operations read operations] on `s` having an argument
`flags` of type `socket_base::message_flags` where `(flags &
socket_base::message_out_of_band) != 0` then the `buffers` are filled in the
order in which these operations were issued.
When there are multiple outstanding asynchronous [link
boost_asio.reference.read_write_operations write operations] on `s`, the `buffers`
are transmitted in the order in which these operations were issued. The order
of invocation of the completion handlers for these operations is unspecified.
[endsect]