blake-john/agent-config/cpp-pro

// 定义可复用的、自文档化的约束
template<typename T>
concept Numeric = std::integral<T> || std::floating_point<T>;
 
template<Numeric T>
T clamp(T value, T lo, T hi) {
    return std::clamp(value, lo, hi);
}

// 包装原始句柄；调用点无需手动清理
class FileHandle {
public:
    explicit FileHandle(const char* path)
        : handle_(std::fopen(path, "r")) {
        if (!handle_) throw std::runtime_error("Cannot open file");
    }
    ~FileHandle() { if (handle_) std::fclose(handle_); }
 
    // 不可复制，可移动
    FileHandle(const FileHandle&) = delete;
    FileHandle& operator=(const FileHandle&) = delete;
    FileHandle(FileHandle&& other) noexcept
        : handle_(std::exchange(other.handle_, nullptr)) {}
 
    std::FILE* get() const noexcept { return handle_; }
private:
    std::FILE* handle_;
};

// 优先使用 make_unique / make_shared；避免裸 new/delete
auto buffer = std::make_unique<std::array<std::byte, 4096>>();
 
// 仅在真正需要时使用共享所有权
auto config = std::make_shared<Config>(parseArgs(argc, argv));