Run

Concepts
concept	uvco::MainFunction

Functions
template<typename R, MainFunction< R > F>
R	uvco::runMain (F main)

Detailed Description

Function Documentation

runMain()

template<typename R, MainFunction< R > F>

R uvco::runMain

(

F

main

)

Set up event loop, then run main function to set up promises. Finally, clean up once the event loop has finished. An exception thrown within a coroutine is rethrown here.

MainFunction is a function taking a single const Loop& argument, and returning a Promise<R>. The supplied Loop is necessary to instantiate different types of resources, such as TCP streams or timers.

Example:

runMain<void>([](const Loop& loop) -> Promise<void> {
  // Set up resources here.
  TtyStream stdin = TtyStream::stdin(loop);
  std::optional<std::string> line = co_await stdin.read();
  co_await stdin.close();
  co_return;
});

                                                           {
  Loop loop;
  Promise<R> promise = main(loop);
  runLoop(loop);
  // Returns when libuv does not see any handles left, and neither
  // are any promises ready.
  return promise.unwrap();
}