Section 36.5.4 Exception unrolling 在 SWIG 文档中:
对于将方法调用路由到 Python 的导向器,以及将它们路由到 C++ 的代理,异常处理是一个重要的问题。默认情况下,导向器会忽略在 Python 中解析的方法调用期间发生的异常。要正确处理此类异常,有必要将它们临时转换为 C++ 异常。这可以通过 %feature("director:except") 指令来完成。在大多数情况下,以下代码就足够了:
%feature("director:except") {
if ($error != NULL) {
throw Swig::DirectorMethodException();
}
}
此代码将在每次从控制器调用 Python 方法后检查 Python 错误状态,如果发生错误则抛出 C++ 异常。可以在 C++ 中捕获此异常以实现错误处理程序。目前没有关于 Python 错误的信息存储在 Swig::DirectorMethodException 对象中,但这可能会在未来发生变化。
方法调用可能源自 Python,通过代理类传递到 C++,然后通过导向器方法返回到 Python。如果此时 Python 中发生异常,该异常最好能找到返回给原始调用者的方式。这可以通过将普通的 %exception 指令与上面显示的 director:except 处理程序结合起来来完成。这是一个合适的异常处理程序的示例:
%exception {
try { $action }
catch (Swig::DirectorException &e) { SWIG_fail; }
}
本例中使用的类 Swig::DirectorException 实际上是 Swig::DirectorMethodException 的基类,所以它会捕获这个异常。因为在抛出 Swig::DirectorMethodException 时仍然设置 Python 错误状态,所以一旦 C 包装函数返回,Python 就会注册该异常。
示例
下面是一个示例test.i,说明了该技术:
%module test
%module(directors="1") test
%feature("director");
%feature("director:except") {
if ($error != NULL) {
throw Swig::DirectorMethodException();
}
}
%exception {
try { $action }
catch (Swig::DirectorException &e) { SWIG_fail; }
}
%inline %{
class MyError {
int m_n;
public:
MyError(int n = 0) : m_n(n) {}
~MyError() {}
int get() const { return m_n; }
};
class Demo {
public:
Demo() {}
virtual ~Demo() {}
virtual MyError test() { return MyError(5); }
};
int func(Demo* d) { return d->test().get(); }
%}
swigging和编译后,一个demo:
>>> import test
>>> d=test.Demo() # default class implementation
>>> test.func(d) # Call virtual method in a C++ test function.
5
以上工作正常。以下覆盖错误:
>>> class Demo2(test.Demo): # New class
... def test(self): # Override virtual function
... return 7 # But don't return a MyError object.
...
>>> d=Demo2()
>>> test.func(d)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: SWIG director type mismatch in output value of type 'MyError'
它捕获了异常并返回了一个有用的异常。下面正确覆盖:
>>> class Demo2(test.Demo):
... def test(self):
... return test.MyError(7)
...
>>> d=Demo2()
>>> test.func(d)
7