loop.h

Go to the documentation of this file.

// uvco (c) 2024 Lewin Bormann. See LICENSE for specific terms.
 
#pragma once
 
#include <uv.h>
 
#include "uvco/loop/scheduler.h"
 
#include <coroutine>
#include <memory>
 
namespace uvco {
 
 
class Loop {
public:
  // Don't use this constructor. Use `runMain()` instead.
  explicit Loop(Scheduler::RunMode mode = Scheduler::RunMode::Deferred);
 
  Loop(const Loop &) = delete;
  Loop(Loop &&) = delete;
  Loop &operator=(const Loop &) = delete;
  Loop &operator=(Loop &&) = delete;
  ~Loop();
 
  [[nodiscard]] uv_loop_t *uvloop() const;
 
  // Retrieve the currently active global scheduler associated with the default
  // loop.
  static void enqueue(std::coroutine_handle<> handle);
 
private:
  // The default loop is the only loop that can be created. It is set/unset by
  // the constructor/destructor.
  static Loop *defaultLoop;
  static Scheduler &currentScheduler();
 
  friend void runLoop(Loop &);
  void run();
  // Run a single turn of the loop.
  void runOne();
 
  // Loop and scheduler should be kept at the same
  // place in memory.
  std::unique_ptr<uv_loop_t> loop_;
  std::unique_ptr<Scheduler> scheduler_;
};
 
 
} // namespace uvco