PythonオブジェクトをC/C++でラップする方法｜Boost.Pythonライブラリの活用

C/C++からPythonオブジェクトを扱いたい場合、Boost.Pythonライブラリを利用するのが効果的な方法です。このライブラリを使えば、C++のコードとPythonをシームレスに連携させることができます。

Boost.Pythonライブラリとは

Boost.Pythonは、PythonとC++をつなぐためのインターフェースフレームワークです。特別なツールを必要とせず、普段使っているC++コンパイラだけで、C++のクラス・関数・オブジェクトをPython側に公開したり、その逆にPythonオブジェクトをC++側から操作したりすることが可能になります。

Boost.Pythonの主な特徴

• 非侵入的なラップ設計： 既存のC++コードを一切変更せずにラップできるよう設計されているため、サードパーティ製ライブラリをPythonから利用可能にする用途に最適です。
• 追加ツールが不要： C++コンパイラさえあればよく、独自のコードジェネレーターなどの特別なツールは必要ありません。
• 高度なメタプログラミング技術： ライブラリ内部で高度なメタプログラミング技法が活用されており、ユーザーは非常に簡潔な構文でラップコードを記述できます。その結果、コードは宣言型のインターフェース定義言語（IDL）のような見た目になります。

簡単な使用例

例えば、C++の関数をPythonから呼び出せるようにするには、次のように記述します。

#include <boost/python.hpp>

int add(int a, int b) {
    return a + b;
}

BOOST_PYTHON_MODULE(example) {
    boost::python::def("add", &add);
}

このモジュールをコンパイルすると、Python側から以下のように利用できます。

import example
print(example.add(3, 4))  # 7 と出力される

まとめ

Boost.Pythonを活用すれば、既存のC++資産をほとんど手を加えることなくPythonから利用でき、逆にPythonの柔軟性をC++アプリケーションに組み込むこともできます。C++とPythonの連携を検討しているなら、まずはBoost.Pythonから試してみる価値は十分にあります。