Home | Libraries | People | FAQ | More |
Spawn a new coroutined-based thread of execution.
template< typename ExecutionContext, typename F, typename CompletionToken = DEFAULT> DEDUCED co_spawn( ExecutionContext & ctx, F && f, CompletionToken && token = DEFAULT, typename enable_if< is_convertible< ExecutionContext &, execution_context & >::value >::type * = 0);
An execution context that will provide the executor to be used to schedule the new thread of execution.
A nullary function object with a return type of the form boost::asio::awaitable<R,E>
that will be used as the coroutine's entry point.
The completion token that will handle the notification that the thread
of execution has completed. If R
is void
,
the function signature of the completion handler must be:
void handler(std::exception_ptr);
Otherwise, the function signature of the completion handler must be:
void handler(std::exception_ptr, R);
boost::asio::awaitable<std::size_t> echo(tcp::socket socket) { std::size_t bytes_transferred = 0; try { char data[1024]; for (;;) { std::size_t n = co_await socket.async_read_some( boost::asio::buffer(data), boost::asio::use_awaitable); co_await boost::asio::async_write(socket, boost::asio::buffer(data, n), boost::asio::use_awaitable); bytes_transferred += n; } } catch (const std::exception&) { } co_return bytes_transferred; } // ... boost::asio::co_spawn(my_io_context, [socket = std::move(my_tcp_socket)]() mutable -> boost::asio::awaitable<void> { try { char data[1024]; for (;;) { std::size_t n = co_await socket.async_read_some( boost::asio::buffer(data), boost::asio::use_awaitable); co_await boost::asio::async_write(socket, boost::asio::buffer(data, n), boost::asio::use_awaitable); } } catch (const std::exception& e) { std::cerr << "Exception: " << e.what() << "\n"; } }, boost::asio::detached);