拡張と埋め込み FAQ¶
C で独自の関数を作ることはできますか?¶
はい。関数、変数、例外、そして新しいタイプまで含んだビルトインモジュールを C で作れます。これはドキュメント Python インタプリタの拡張と埋め込み で説明されています。
ほとんどの中級から上級の Python 本もこの話題を扱っています。
C++ で独自の関数を作ることはできますか?¶
はい。
C++ 内にある C 互換機能を使ってできます。
extern "C" { ... } で Python のインクルードファイルを囲み、 extern "C" を Python インタプリタから呼ぶ各関数の前に置いてください。
コンストラクタを持つグローバルな C++ オブジェクトや静的な C++ オブジェクトを使うのは、おそらく望ましくありません。
C を書くのは大変です。他の方法はありませんか?¶
何をしたいかに応じて、C 拡張を自分で書く以外にもいくつかの方法があります。 推奨されるサードパーティツール には、Python の C/C++ 拡張をより簡単に作るものや、より高度な方法を提供するものがあります。
C から任意の Python 文を実行するにはどうしますか?¶
これを行う最高水準の関数は PyRun_SimpleString() で、一つの文字列引数を取り、モジュール __main__ のコンテキストでそれを実行し、成功なら 0、例外 (SyntaxError を含む) が発生したら -1 を返します。更に制御したければ、 PyRun_String() を使ってください。ソースは Python/pythonrun.c の 'PyRun_SimpleString() を参照してください。
C から任意の Python 式を評価するにはどうしますか?¶
先の質問の PyRun_String() を、スタートシンボル Py_eval_input を渡して呼び出してください。これは式を解析し、評価してその値を返します。
Python オブジェクトから C の値を取り出すにはどうしますか?¶
オブジェクトの型に依ります。タプルなら、 PyTuple_Size() が長さを返し、 PyTuple_GetItem() が指定されたインデックスの要素を返します。リストにも同様の関数 PyList_Size() と PyList_GetItem() があります。
bytes では、 PyBytes_Size() がその長さを返し、 PyBytes_AsStringAndSize() がその値へのポインタと長さを提供します。 Python の bytes オブジェクトは null を含むこともできるので、 C の strlen() を使うべきではないことに注意してください。
オブジェクトの型を検査するには、まず最初にそれが NULL でないことを確かめた上で、 PyBytes_Check() 、 PyTuple_Check() 、 PyList_Check() などを使います。
いわゆる 'abstract' インターフェースから提供される、 Python オブジェクトに対する高レベル API もあります -- より詳しいことは Include/abstract.h を読んでください。これを使うと、数値型プロトコル (PyNumber_Index() など) や PyMapping API のマップ型プロトコルなどの役に立つプロトコルに加え、 PySequence_Length() や PySequence_GetItem() などの任意の種類の Python シーケンスへのインターフェースにアクセスできます。
Py_BuildValue() で任意長のタプルを作るにはどうしますか?¶
できません。代わりに PyTuple_Pack() を使ってください。
C からオブジェクトのメソッドを呼び出すにはどうしますか?¶
PyObject_CallMethod() 関数でオブジェクトの任意のメソッドを呼び出せます。パラメタは、オブジェクト、呼び出すメソッドの名前、 Py_BuildValue() で使われるようなフォーマット文字列、そして引数です:
PyObject *
PyObject_CallMethod(PyObject *object, const char *method_name,
const char *arg_format, ...);
これは、組み込みかユーザー定義かを問わず、メソッドを持つ任意のオブジェクトに使えます。
返り値を使い終わったら、呼び出し側で Py_DECREF() する責任があります。
例えば、あるファイルオブジェクトの "seek" メソッドを 10, 0 を引数として呼ぶとき (ファイルオブジェクトのポインタを "f" とします):
res = PyObject_CallMethod(f, "seek", "(ii)", 10, 0);
if (res == NULL) {
... 例外が発生した場合の処理 ...
}
else {
Py_DECREF(res);
}
なお、 PyObject_CallObject() の引数リストには 常に タプルが必要です。
関数を引数なしで呼び出すには、フォーマットに "()" を渡し、関数を一つの引数で呼び出すには、引数の書式を括弧で囲んで例えば "(i)" としてください。
PyErr_Print() (その他 stdout/stderr に印字するもの) からの出力を受け取るにはどうしますか?¶
Python コード内で、 write() メソッドをサポートするオブジェクトを定義してください。そのオブジェクトを sys.stdout と sys.stderr に代入してください。print_error を呼び出すか、単に標準のトレースバック機構を作動させてください。そうすれば、出力は write() が送る任意の所に行きます。
最も簡単な方法は、 io.StringIO クラスを使うことです:
>>> import io, sys
>>> sys.stdout = io.StringIO()
>>> print('foo')
>>> print('hello world!')
>>> sys.stderr.write(sys.stdout.getvalue())
foo
hello world!
これと同じことをするカスタムオブジェクトは次のようになるでしょう:
>>> import io, sys
>>> class StdoutCatcher(io.TextIOBase):
... def __init__(self):
... self.data = []
... def write(self, stuff):
... self.data.append(stuff)
...
>>> import sys
>>> sys.stdout = StdoutCatcher()
>>> print('foo')
>>> print('hello world!')
>>> sys.stderr.write(''.join(sys.stdout.data))
foo
hello world!
C から Python で書かれたモジュールにアクセスするにはどうしますか?¶
以下のようにモジュールオブジェクトへのポインタを得られます:
module = PyImport_ImportModule("<modulename>");
そのモジュールがまだインポートされていない (つまり、まだ sys.modules に現れていない) なら、これはモジュールを初期化します。そうでなければ、単純に sys.modules["<modulename>"] の値を返します。なお、これはモジュールをいかなる名前空間にも代入しません。これはモジュールが初期化されて 'sys.modules に保管されていることを保証するだけです。
これで、モジュールの属性 (つまり、モジュールで定義された任意の名前) に以下のようにアクセスできるようになります:
attr = PyObject_GetAttrString(module, "<attrname>");
PyObject_SetAttrString() を呼んでモジュールの変数に代入することもできます。
Python から C++ へインターフェースするにはどうしますか?¶
やりたいことに応じて、いろいろな方法があります。手動でやるなら、 "拡張と埋め込み" ドキュメント を読むことから始めてください。なお、Python ランタイムシステムにとっては、 C と C++ はあまり変わりません。だから、C 構造体 (ポインタ)型に基づいて新しい Python の型を構築する方針は C++ オブジェクトに対しても有効です。
C++ ライブラリに関しては、 C を書くのは大変です。他の方法はありませんか? を参照してください。
セットアップファイルでモジュールを追加しようとしたらメイクに失敗しました。なぜですか?¶
セットアップは改行で終わらなければならなくて、改行がないと、ビルド工程は失敗します。(これを直すには、ある種の醜いシェルスクリプトハックが必要ですが、このバグは小さいものですから努力に見合う価値はないでしょう。)
拡張をデバッグするにはどうしますか?¶
When using GDB with dynamically loaded extensions, enable pending breakpoints
to set a breakpoint before the extension is loaded. For example, to stop in
a function named myfunction:
$ gdb /local/bin/python
(gdb) set breakpoint pending on
(gdb) break myfunction
(gdb) run myscript.py
GDB resolves the breakpoint when the extension is loaded and stops when the
function is called. You can also set a pending breakpoint directly in your
extension's source code, for example with break myfunction.c:50.
Linux システムで Python モジュールをコンパイルしたいのですが、見つからないファイルがあります。なぜですか?¶
パッケージとして配布されている Python の多くでは、Python 拡張のコンパイルに必要なファイルの一部が省かれています。
Red Hat では、必要なファイルを入手するために python3-devel RPM をインストールしてください。
Debian では apt-get install python3-dev を実行してください。
"不完全 (incomplete) な入力" を "不適切 (invalid) な入力" から区別するにはどうしますか?¶
Python インタラクティブインタプリタでは、入力が不完全なとき (例えば、 "if" 文の始まりをタイプした時や、カッコや三重文字列引用符を閉じていない時など) には継続プロンプトを与えられますが、入力が不適切であるときには即座に構文エラーメッセージが与えられます。このようなふるまいを模倣したいことがあります。
Python では構文解析器のふるまいに十分に近い codeop モジュールが使えます。例えば IDLE がこれを使っています。
これを C で行う最も簡単な方法は、 PyRun_InteractiveLoop() を (おそらく別のスレッドで) 呼び出し、Python インタプリタにあなたの入力を扱わせることです。独自の入力関数を指定するのに PyOS_ReadlineFunctionPointer() を設定することもできます。詳しいヒントは、 Modules/readline.c や Parser/myreadline.c を参照してください。
未定義の g++ シンボル __builtin_new や __pure_virtual を見つけるにはどうしますか?¶
g++ モジュールを動的にロードするには、Python を再コンパイルし、それを g++ で再リンク (Python Modules Makefile 内の LINKCC を変更) し、拡張を g++ でリンク (例えば g++ -shared -o mymodule.so mymodule.o) しなければなりません。
メソッドのいくつかは C で、その他は Python で実装されたオブジェクトクラスを (継承などで) 作ることはできますか?¶
はい、 int 、 list 、 dict などのビルトインクラスから継承できます。
The Boost Python Library (BPL, https://www.boost.org/libs/python/doc/index.html) を使えば、これを C++ からできます。 (すなわち、BPL を使って C++ で書かれた拡張クラスを継承できます).