handle.h

#ifndef ASYNCIO_HANDLE_H
#define ASYNCIO_HANDLE_H

#include <cstdint>
#include <source_location>
#include <fmt/core.h>

namespace ASYNCIO_NS {
// for cancelled
using HandleId = uint64_t;

/*
句柄类，回调类
*/
struct Handle { // type erase for EventLoop
    enum State: uint8_t {
        UNSCHEDULED,
        SUSPEND,
        SCHEDULED,
    };

    Handle() noexcept: handle_id_(handle_id_generation_++) {}
    virtual void run() = 0;
    void set_state(State state) { state_ = state; }
    HandleId get_handle_id() { return handle_id_; }
    virtual ~Handle() = default;
private:
    HandleId handle_id_;
    static HandleId handle_id_generation_;
protected:
    State state_ {Handle::UNSCHEDULED};
};

// handle maybe destroyed, using the increasing id to track the lifetime of handle.
// don't directly using a raw pointer to track coroutine lifetime,
// because a destroyed coroutine may has the same address as a new ready coroutine has created.
/*
通过id来追踪句柄
*/
struct HandleInfo {
    HandleId id { };
    Handle* handle { };
};

/*
协程句柄类
实现在event_loop.cpp
*/
struct CoroHandle: Handle {
    // 帧
    std::string frame_name() const {
        const auto& frame_info = get_frame_info();
        return fmt::format("{} at {}:{}", frame_info.function_name(),
                           frame_info.file_name(), frame_info.line());
    }

    virtual void dump_backtrace(size_t depth = 0) const {};
    
    void schedule();
    
    void cancel();
private:
    virtual const std::source_location& get_frame_info() const;
};

}

#endif // ASYNCIO_HANDLE_H