swig 中的 %rename 和 %inline，错误检查

Question

我使用 SWIG 和 Numpy。我定义了一个名为 inplace() 的 C 函数来快速处理数据数组，并且我想进行一些错误检查（如果两个数组具有相同的尺寸）。

我在 .i 文件中使用 %rename 和 %inline 。据我了解，重命名应该映射函数名称，因此每次有人使用 inplace 时，都会运行 safe_inplace 并检查错误。

但它不起作用:(。据我所知，safe_inplace 没有执行，python 直接运行 inplace 而不接触函数的安全版本。

# .i

%include "inplace.h"
%rename (inplace) safe_inplace;

%inline %{
    void safe_inplace(int* datain, int in_dx, int in_dy, int in_dz,
                      int* dataout, int out_dx, int out_dy)
    {
        if ((in_dx != out_dx) || (in_dy != out_dy)) { 
            PyErr_Format(PyExc_ValueError, /*... messgage*/) 
            return;
        } 

        inplace( /* .. pass the arguments to original function*/ );
    }

头文件：

# .h 

void inplace(int* datain, int in_dx, int in_dy, int in_dz, int* dataout, int out_dx, int out_dy);

Python：

#.py
inplace.inplace(a,b)

我修改的原始示例可以可以在此处找到

Answer 1

您最初的方法很接近，但您可能希望 SWIG 根本不包装该函数的原始版本。

我整理了一个稍微简单的示例来说明这是如何工作的。给定头文件：

void foo();

我们希望将其包装起来，以便在调用真正的版本之前调用稍作修改的版本。

最简单的方法是从不实际显示 SWIG 头文件进行包装，仅用于编译包装器，例如：

%module test

%{
#include "test.h"
#include <iostream>
%}

%rename (foo) foo_safe;
%inline %{
  void foo_safe() {
    std::cout << "Hello world" << std::endl;
    foo(); // Calls the foo() from test.h, as you'd hope
  }
%}

如果您不想删除 %include （例如，该头文件中还有您关心的其他内容）您可以执行以下操作：

%module test

%{
#include "test.h"
#include <iostream>
%}

%rename (unsafe_foo) foo;    
%include "test.h"

%rename (foo) foo_safe;    
%inline %{
  void foo_safe() {
    std::cout << "Hello world" << std::endl;
    foo();
  }
%}

将 foo 的实际实现公开为 unsafe_foo。

或者，如果 Python 用户没有理由能够调用 unsafe_ignore ，您可以使用 %ignore ：

%module test

%{
#include "test.h"
#include <iostream>
%}

%rename (foo) foo_safe;    
%inline %{
  void foo_safe() {
    std::cout << "Hello world" << std::endl;
    foo();
  }
%}

%ignore foo;    
%include "test.h"

最后看起来您的目标实际上只是在真正的C函数的调用。如果是这种情况，您也可以通过几种方法来做到这一点，例如您可以在使用 pythonprepend 进行真正的函数调用之前添加 python 代码：

%feature("pythonprepend") foo() %{
   print "hello world"
   # check args and raise possibly 
%}

或者最后您可以使用 %exception< /code> 功能也是如此，类似（未经测试）：

%exception inplace {
   // Check args and possibly throw
   $action
}

$action 将自动替换为真实的调用。