Start a new stackful coroutine.
Start a new stackful coroutine, calling the specified handler when it completes.
template< typename Function> void spawn( Function && function, const boost::coroutines::attributes & attributes = boost::coroutines::attributes()); » more... template< typename Handler, typename Function> void spawn( Handler && handler, Function && function, const boost::coroutines::attributes & attributes = boost::coroutines::attributes(), typename enable_if<!is_executor< typename decay< Handler >::type >::value &&!is_convertible< Handler &, execution_context & >::value >::type * = 0); » more...
Start a new stackful coroutine, inheriting the execution context of another.
template< typename Handler, typename Function> void spawn( basic_yield_context< Handler > ctx, Function && function, const boost::coroutines::attributes & attributes = boost::coroutines::attributes()); » more...
Start a new stackful coroutine that executes on a given executor.
template< typename Function, typename Executor> void spawn( const Executor & ex, Function && function, const boost::coroutines::attributes & attributes = boost::coroutines::attributes(), typename enable_if< is_executor< Executor >::value >::type * = 0); » more...
Start a new stackful coroutine that executes on a given strand.
template< typename Function, typename Executor> void spawn( const strand< Executor > & ex, Function && function, const boost::coroutines::attributes & attributes = boost::coroutines::attributes()); » more...
Start a new stackful coroutine that executes in the context of a strand.
template< typename Function> void spawn( const asio::io_context::strand & s, Function && function, const boost::coroutines::attributes & attributes = boost::coroutines::attributes()); » more...
Start a new stackful coroutine that executes on a given execution context.
template< typename Function, typename ExecutionContext> void spawn( ExecutionContext & ctx, Function && function, const boost::coroutines::attributes & attributes = boost::coroutines::attributes(), typename enable_if< is_convertible< ExecutionContext &, execution_context & >::value >::type * = 0); » more...
The spawn()
function is a high-level wrapper over the Boost.Coroutine
library. This function enables programs to implement asynchronous logic in
a synchronous manner, as illustrated by the following example:
asio::spawn(my_strand, do_echo); // ... void do_echo(asio::yield_context yield) { try { char data[128]; for (;;) { std::size_t length = my_socket.async_read_some( asio::buffer(data), yield); asio::async_write(my_socket, asio::buffer(data, length), yield); } } catch (std::exception& e) { // ... } }
Header: asio/spawn.hpp
Convenience header: None