文章作者：Tyan
博客：noahsnail.com ?|? CSDN ?|? 簡書

1. 引言

眾所周知，Python語言簡單、易學、開源、具有豐富的庫，Python的第一個編譯器是用C語言實現的。但Python的缺點也非常明顯，最讓人詬病的就是Python的性能問題。因此，為了提高程序的運行效率，通常會將程序的關鍵部分使用C或C++重寫，編譯成動態鏈接庫，然后在Python（CPython）中進行調用。運行環境：Ubuntu 16.04、Python 2.7、Python 3.5。

2. Python C擴展

2.1 普通C函數

            
              void hello()
{
	printf("Hello World!\n");
}

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

            
          

2.2 Python C擴展

Python擴展模塊由以下幾部分組成：

• 頭文件
• 調用的C函數
• 模塊方法表
• 模塊初始化函數

具體實現 demo.c 如下：

            
              // 包含Python頭文件
#include 
              
                


// 兼容Python3
#if PY_MAJOR_VERSION >= 3
#define PYTHON3
#endif


// hello函數實現
static PyObject* hello(PyObject *self, PyObject *args)
{
    printf("Hello World\n");
    return Py_None;
}


// add函數實現
static PyObject* add(PyObject *self, PyObject *args)
{
    int a, b;
    if(!PyArg_ParseTuple(args, "ii", &a, &b))
    {
        return NULL;
    }
    return Py_BuildValue("i", a + b);
}


// 模塊方法表
static PyMethodDef TwoMethods[] = {
    { "hello", hello, METH_NOARGS, "Print Hello" },
    { "add", add, METH_VARARGS, "Add two integers"},
    { NULL, NULL, 0, NULL }
};


#ifdef PYTHON3
// Python3模塊定義結構體
static struct PyModuleDef testModule = {
	PyModuleDef_HEAD_INIT,
	"testModule",
	"Test Module",
	-1,
	TwoMethods
};


// Python3模塊初始化函數
PyMODINIT_FUNC PyInit_demo(void)
{
	return PyModule_Create(&testModule);
}


#else
// Python2模塊初始化函數
PyMODINIT_FUNC initdemo(void)
{
    Py_InitModule("demo", TwoMethods);
}
#endif

              
            
          

2.3 編譯并測試

編寫 setup.py 文件：

            
              from distutils.core import setup, Extension

demo = Extension('demo', sources = ['demo.c'])

setup(name = 'C extension module', version = '1.0', description = 'This is a demo', ext_modules = [demo])

            
          

生成動態鏈接庫的命令如下：

            
              #python2
$ python setup.py build_ext --inplace
running build_ext
building 'demo' extension
x86_64-linux-gnu-gcc -pthread -DNDEBUG -g -fwrapv -O2 -Wall -Wstrict-prototypes -fno-strict-aliasing -Wdate-time -D_FORTIFY_SOURCE=2 -g -fstack-protector-strong -Wformat -Werror=format-security -fPIC -I/usr/include/python2.7 -c demo.c -o build/temp.linux-x86_64-2.7/demo.o
x86_64-linux-gnu-gcc -pthread -shared -Wl,-O1 -Wl,-Bsymbolic-functions -Wl,-Bsymbolic-functions -Wl,-z,relro -fno-strict-aliasing -DNDEBUG -g -fwrapv -O2 -Wall -Wstrict-prototypes -Wdate-time -D_FORTIFY_SOURCE=2 -g -fstack-protector-strong -Wformat -Werror=format-security -Wl,-Bsymbolic-functions -Wl,-z,relro -Wdate-time -D_FORTIFY_SOURCE=2 -g -fstack-protector-strong -Wformat -Werror=format-security build/temp.linux-x86_64-2.7/demo.o -o /workspace/python-c/demo.so

#python3
$ python3 setup.py build_ext --inplace
running build_ext
building 'demo' extension
x86_64-linux-gnu-gcc -pthread -DNDEBUG -g -fwrapv -O2 -Wall -Wstrict-prototypes -g -fstack-protector-strong -Wformat -Werror=format-security -Wdate-time -D_FORTIFY_SOURCE=2 -fPIC -I/usr/include/python3.5m -c demo.c -o build/temp.linux-x86_64-3.5/demo.o
x86_64-linux-gnu-gcc -pthread -shared -Wl,-O1 -Wl,-Bsymbolic-functions -Wl,-Bsymbolic-functions -Wl,-z,relro -Wl,-Bsymbolic-functions -Wl,-z,relro -g -fstack-protector-strong -Wformat -Werror=format-security -Wdate-time -D_FORTIFY_SOURCE=2 build/temp.linux-x86_64-3.5/demo.o -o /workspace/python-c/demo.cpython-35m-x86_64-linux-gnu.so

            
          

hello ， add 函數測試：

            
              >>> from demo import hello, add
>>> hello()
Hello World
>>> add(2, 3)
5

            
          

參考資料

1. https://www.cnblogs.com/vamei/archive/2013/02/06/2892628.html
2. https://www.yanxurui.cc/posts/python/2017-06-18-3-ways-of-calling-c-functions-from-python/
3. https://swe.mirsking.com/languages/python/pythoncallcplusplus
4. https://www.jianshu.com/p/cd28e8b0cce1
5. https://docs.python.org/2.7/extending/extending.html
6. https://docs.python.org/2.7/extending/building.html
7. https://tutorialedge.net/python/python-c-extensions-tutorial/