File: coroutine.qbk

package info (click to toggle)
boost1.88 1.88.0-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 576,932 kB
  • sloc: cpp: 4,149,234; xml: 136,789; ansic: 35,092; python: 33,910; asm: 5,698; sh: 4,604; ada: 1,681; makefile: 1,633; pascal: 1,139; perl: 1,124; sql: 640; yacc: 478; ruby: 271; java: 77; lisp: 24; csh: 6
file content (51 lines) | stat: -rw-r--r-- 1,779 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
[/
 / Copyright (c) 2003-2025 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:coroutine Stackless Coroutines]

The [link boost_asio.reference.coroutine `coroutine`] class provides support for
stackless coroutines. Stackless coroutines enable programs to implement
asynchronous logic in a synchronous manner, with minimal overhead, as shown in
the following example:

  struct session : boost::asio::coroutine
  {
    boost::shared_ptr<tcp::socket> socket_;
    boost::shared_ptr<std::vector<char> > buffer_;

    session(boost::shared_ptr<tcp::socket> socket)
      : socket_(socket),
        buffer_(new std::vector<char>(1024))
    {
    }

    void operator()(boost::system::error_code ec = boost::system::error_code(), std::size_t n = 0)
    {
      if (!ec) reenter (this)
      {
        for (;;)
        {
          yield socket_->async_read_some(boost::asio::buffer(*buffer_), *this);
          yield boost::asio::async_write(*socket_, boost::asio::buffer(*buffer_, n), *this);
        }
      }
    }
  };

The `coroutine` class is used in conjunction with the pseudo-keywords
`reenter`, `yield` and `fork`. These are preprocessor macros, and are
implemented in terms of a `switch` statement using a technique similar to
Duff's Device. The [link boost_asio.reference.coroutine `coroutine`] class's
documentation provides a complete description of these pseudo-keywords.

[heading See Also]

[link boost_asio.reference.coroutine coroutine],
[link boost_asio.examples.cpp11_examples.http_server_4 HTTP Server 4 example],
[link boost_asio.overview.composition.spawn Stackful Coroutines].

[endsect]