Python 技術手冊 第三版

以 Python 的 C API 擴充 Python

|

725

#if PY_MAJOR_VERSION >= 3

PyInit_hello(void)

{

return PyModule_Create(&hello_module);

#else

inithello(void)

{

Py_InitModule3("hello",

hello_funcs, hello_docs);

#endif

}

將這儲存為

hello.c

，並以

distutils

，例如：

from setuptools import setup, Extension

setup(name='hello',

ext_modules=[Extension('hello',sources=['hello.c'])])

執行了

python setup.py install

之後，你就能使用新安裝的模組，例如從一個

Python 互動工作階段，像是：

>>> import hello

>>> print hello.hello()

Hello, Python extensions world!

>>>

Python C API 函式的回傳值

Python C API 中的所有函式都會回傳一個

int

或

PyObject*

。大多數函式會

在成功時回傳

0

，而回傳

-1

代表錯誤。某些函式會回傳是 true 或 false 的

結果：這些函式回傳

0

來表示 false，一個不等於

0

的整數則代表 true，而

永不指示錯誤。回傳

PyObject*

的函式會在錯誤的時候回傳

NULL ...