如何为第三方C库API调用统一实现异常处理包装器？

我正在使用一个厂商提供的C库（命名为foo），它包含大量API调用。所有函数都接收一个预初始化的FOOHandle类型句柄，成功返回0，失败返回其他数值，此时可调用foo_get_errmsg()获取错误文本。

我用C++开发，希望将这些错误转换为自定义异常类型，为此创建了FOOException类，其构造函数如下：

private:
    char    buf[1024];
    int     code;
public:
    FOOException(FOOHandle h, int32_t _code) noexcept : code(_code)
    {
        foo_get_errmsg(code, h, buf);
    }

为简化现有代码改造，我想添加一个通用包装函数，调用指定API、检查结果并在失败时抛出异常：

static auto wrapper(const auto &foofunc, auto&&... args) const
{
    auto code = foofunc(args...);

    switch (code) {
    case 0:
        return 0;
    default:
        throw FOOException(handle, code);
    }
}

问题在于获取handle：FOO库的所有API调用都包含该参数，但它并非总是第一个参数，例如：

foo_analyze(a, handle);
...
foo_meow(handle, a, b, c, d);

请问能否从args...中按类型或名称提取handle，还是必须在wrapper调用中重复传入handle？

方法1：从参数包中按类型提取FOOHandle #

基于你提到的“所有API恰好包含一个FOOHandle参数”的前提，可以通过模板元编程从参数包中自动提取该类型的参数，无需显式重复传入：

首先实现一个辅助函数，确保参数包中存在且仅存在一个FOOHandle：

#include <type_traits>

template<typename... Args>
constexpr FOOHandle get_handle(Args&&... args) {
    FOOHandle target_handle{};
    bool found = false;

    // 遍历参数包，匹配FOOHandle类型
    (([&]() {
        using ArgType = std::decay_t<decltype(args)>;
        if constexpr (std::is_same_v<ArgType, FOOHandle>) {
            if (found) {
                static_assert(false, "参数包中存在多个FOOHandle类型参数");
            }
            target_handle = std::forward<Args>(args);
            found = true;
        }
    }()), ...);

    static_assert(found, "参数包中未找到FOOHandle类型参数");
    return target_handle;
}

然后修改包装函数，调用辅助函数获取handle：

static auto wrapper(const auto &foofunc, auto&&... args) {
    auto code = foofunc(std::forward<decltype(args)>(args)...);
    
    if (code != 0) {
        FOOHandle handle = get_handle(std::forward<decltype(args)>(args)...);
        throw FOOException(handle, code);
    }
    return code;
}

调用时直接传入原API的参数即可，无需额外操作：

wrapper(foo_analyze, a, handle);
wrapper(foo_meow, handle, a, b, c, d);

方法2：显式传入handle（简单可靠） #

如果不想引入模板元编程的复杂度，最直接的方式是在调用wrapper时显式传入handle，虽然看起来参数重复，但实现简单、可读性强：

static auto wrapper(FOOHandle handle, const auto &foofunc, auto&&... args) {
    auto code = foofunc(std::forward<decltype(args)>(args)...);
    
    if (code != 0) {
        throw FOOException(handle, code);
    }
    return code;
}

调用方式：

wrapper(handle, foo_analyze, a, handle);
wrapper(handle, foo_meow, handle, a, b, c, d);

方案选择 #

• 若能保证所有API严格仅包含一个FOOHandle参数，方法1更适合，无需修改现有调用结构，减少改造工作量。
• 若担心API参数存在歧义，或希望代码更简洁直观，方法2更稳妥，显式传入避免潜在问题。

内容的提问来源于stack exchange，提问作者Mikhail T.