SWIG 包装的 C 库引发异常的最优雅的方式

Question

我最近将一个库（最初是使用 Boost Python 包装用 C++ 编写的）转换为使用 SWIG 包装的 C 语言，以支持更多语言。 我从 C++ 切换到 C，因为该库仅包含一组函数，而且我还希望该库可以从 C 调用（无需使用 C++ 编译器编译整个程序）。 然而，有一件事并不容易移植，一小部分功能需要能够报告错误。 在 C++/Boost Python 中，通过 throw 和异常转换非常优雅地完成了这一点。

让函数子集报告错误的最优雅的方式（在 C 和包装语言方面）是什么？

Answer 1

我就是这样做的。 %{...%} 块将其内容插入到包装文件中。 %exception 块是 SWIG 的异常处理，在每个函数调用后运行以检查是否有错误，如果有则使用 PyErr_SetString 抛出异常。然后，如果您想引发异常，只需从您的 C 函数中调用“set_err("Error msg"); 即可。

%{
    /* Exception helpers */
    static int swig_c_error_num = 0;
    static char swig_c_err_msg[256];

    const char *err_occurred()
    {
        if (swig_c_error_num) {
            swig_c_error_num = 0;
            return (const char*)swig_c_err_msg;
        }
        return NULL;
    }

    void set_err(const char *msg)
    {
        swig_c_error_num = 1;
        strncpy(swig_c_err_msg, msg, 256);
    }
%}

%exception {
    const char *err;
    $action
    if (err = err_occurred()) {
        PyErr_SetString(PyExc_RuntimeError, err);
        return NULL;
    }
}

或者，如果您的 C 库使用一组标准的返回代码，您可以通过检查函数的返回代码来替换此机制在 %Exception 块中。

%exception {
    int rc;
    rc = $action;

    if (rc == ERR) {
        PyErr_SetString(PyExc_RuntimeError, <err msg>);
        return NULL;
    }
}

Answer 2

请参阅 Richard R. Hanson 所著的《C 接口和实现》中的第 4 章。