Python 関数を保持する :cppobject
インスタンス :cpp!f
が与えられたとき、C++ からその関数を呼び出す最も簡単な方法は、単にその関数呼び出し演算子を起動することである。 :
f("tea", 4, 2) // Python の f('tea', 4, 2) と同じ
また、当然のことながら :cppobject
インスタンス :cpp!x
のメソッドを呼び出すには対応する属性の関数呼び出し演算子を使用する。 :
x.attr("tea")(4, 2); // Python の x.tea(4, 2) と同じ
:cpp!object
インスタンスがない場合、:c!PyObject*
に対して Python の関数およびメソッドを呼び出すために、Boost.Python は 2 種類の関数テンプレート :cppcall
および :cppcall_method
を提供している。Python の関数オブジェクト(または Python の呼び出し可能オブジェクト)を呼び出すインターフェイスは次のようなものである。 :
call<ResultType>(callable_object, a1, a2... aN);
Python オブジェクトのメソッド呼び出しも同様に簡単である。 :
call_method<ResultType>(self_object, "method-name", a1, a2... aN);
この比較的低水準なインターフェイスは、Python でオーバーライド可能な C++ 仮想関数を実装するときに使用する。
引数はその型に従って Python に変換する。既定では引数 :cpp!a1
...:cpp!aN
は新しい Python オブジェクトにコピーされるが、:cppptr()
および ref() を使用してこの振る舞いを上書きすることができる。 :
class X : boost::noncopyable
{
...
};
void apply(PyObject* callable, X& x)
{
// callable を呼び出し、x への参照を保持する Python オブジェクトを渡す
boost::python::call<void>(callable, boost::ref(x));
}
以下の表において :cpp!x
は実際の引数オブジェクトであり、{cv}
は省略可能な CV 指定子(const
、volatile
あるいは const volatile
)である。
引数の型 | 振る舞い |
---|---|
:cpp!T cv& 、:cpp!T cv |
:cpp!T を返すラップした C++ 関数の戻り値と同じ方法で Python 引数を作成する。:cpp!T がクラス型の場合、通常は :cpp!x を新しい Python オブジェクト内にコピー構築する。 |
:cpp!T* |
:cppx == 0 の場合、Python 引数は None である。それ以外の場合、:cpp!T を返すラップする C++ 関数の戻り値と同じ方法で Python 引数を作成する。:cpp!T がクラス型の場合、通常は :cpp*x を新しい Python オブジェクト内にコピー構築する。 |
boost::reference_wrapper<> | Python の引数は(コピーではなく):cppx.get() へのポインタを持つ。注意:結果のオブジェクトへの参照を保持する Python コードが :cpp*x.get() の寿命を超えて存在しないようにしないと、*クラッシュする!* |
:cpppointer_wrapper\<T> |
:cppx.get() == 0 の場合、Python 引数は None である。それ以外の場合、Python の引数は(コピーではなく):cppx.get() へのポインタを持つ。注意:結果のオブジェクトへの参照を保持する Python コードが :cpp*x.get() の寿命を超えて存在しないようにしないと、*クラッシュする!* |
大抵の場合 :cppcall<ResultType>()
および :cppcall_method<ResultType>()
は、:cpp!ResultType
に対して登録したすべての lvalue および rvalue の from_python
変換器を利用し、結果のコピーである :cpp!ResultType
を返す。しかしながら :cpp!ResultType
がポインタか参照型の場合、Boost.Python は lvalue の変換器のみを探索する。懸垂ポインタおよび参照を避けるため、結果の Python オブジェクトの参照カウントが 1 の場合は例外を投げる。
通常 :cpp!a1
...:cpp!aN
に対応する Python の引数を得るには、それぞれについて新しい Python オブジェクトを作成しなければならない。C++ オブジェクトをその Python オブジェクトにコピーすべきだろうか、あるいは Python オブジェクトが単に C++ オブジェクトへの参照かポインタを保持すべきだろうか。大抵の場合、呼び出される関数はどこかに行ってしまった Python オブジェクトへの参照を保持する可能性があるため、後者の方法は安全ではない。C++ オブジェクトを破壊した後に Python オブジェクトを使用すると、Python がクラッシュする。
Python 側のユーザがインタープリタのクラッシュについて気を払うべきでないという原理を踏まえ、既定の振る舞いは C++ オブジェクトをコピーすることとなっており、コピーを行わない振る舞いはユーザが直接 :cppa1
と書く代わりに boost::ref(a1)
とした場合のみ認められる。こうすることで、少なくとも「意図せず」危険な振る舞いを遭遇することはない。コピーを伴わない(「参照」による)振る舞いは通常、クラス型でのみ利用可能であり、それ以外で使用すると実行時に Python の例外を送出して失敗する1ことも付記しておく。
しかしながらポインタ型が問題となる。方法の 1 つはいずれかの :cpp!aN
がポインタ型である場合にコンパイルを拒絶することである。何といってもユーザは「値渡し」として :cpp*aN
を渡すことができ、:cppref(*aN)
で参照渡しの振る舞いを示すことができる。しかしこれでは null ポインタから :py!None
への変換で問題が起こる。null ポインタ値を参照剥がしすることは違法である。
折衷案として私が下した決断は以下のとおりだ:
- 既定の振る舞いは値渡しとする。非 null ポインタを渡すと、参照先が新しい Python オブジェクトにコピーされる。それ以外の場合、対応する Python 引数は :py
!None
である。 - 参照渡しの振る舞いが必要な場合は、:cpp
!aN
がポインタであれば :cppptr(aN)
を、そうでなければ :cppref(aN)
を使用する。:cppptr(aN)
に null ポインタを渡すと、対応する Python 引数は :py!None
である。
戻り値についても類似の問題がある。:cpp!ResultType
にポインタ型か参照型を認めてしまうと、参照先のオブジェクトの寿命はおそらく Python オブジェクトに管理されることになる。この Python オブジェクトが破壊されるとポインタは懸垂する。:cpp!ResultType
が :cpp!char const*
の場合、特に問題は深刻である。対応する Python の String オブジェクトは一般に参照カウントが 1 であり、つまり :cppcall<char const*>(...)
が返った直後にポインタは懸垂する。
以前の Boost.Python v1 は :cppcall<char const*>()
のコンパイルを拒絶することでこの問題に対処したが、これは極端でありかつ何の解決にもならない。極端というのは、所有する Python の文字列オブジェクト(例えば Python のクラス名である場合)が呼び出しを超えて生存する可能性があるためである。また、他の型のポインタや参照の戻り値についてもまったく同様の問題があるため、結局は解決にならないわけである。
Boost.Python v2 では次のように対処した。
- コールバックの :cpp
!const char*
戻り値型に対するコンパイル時の制限を除去した。 - :cpp
!U
がポインタ型か参照型の場合、戻り値の Python オブジェクトの参照カウントが 1 である場合を検出し、:cppcall<U>(...)
内で例外を投げる。
ユーザは :cppcall<U>
内で :cpp!U
について明示的にポインタ、参照を指定しなければならないため安全であり、実行時の懸垂からも保護される。少なくとも :cppcall<U>(...)
の呼び出しから抜け出すには十分である。
:cpp
!int
や :cpp!char
のような非クラス型についてはコンパイル時に失敗させることも可能だろうが、それがこの制限を課す優れた方法であるか私にはよく分からない。↩