python嵌入要点(c/c++版)

python嵌入即在非python语言中使用python语言，这与python扩展正好相反。

扩展与嵌入的对象均是python语言：
嵌入即嵌入python，在其他语言中嵌入python，在其他语言中调用python；
扩展即扩展python，使用其他语言扩展python，在python中使用其他语言。

python嵌入一般流程如下：
先把一些数据从c的表示形式转化成python的表示形式。
然后调用python的API。
最后，把python的调用结果转化成c的表示形式。

转换c数据到python数据：
PyAPI_FUNC(PyObject *) Py_BuildValue(const char *, ...)

PyObject* PyFloat_FromDouble(double v)
PyObject* PyInt_FromLong(long ival)
PyAPI_FUNC(PyObject *) PyString_FromString(const char *)

转换python数据到c数据：
PyAPI_FUNC(int) PyArg_ParseTuple(PyObject *, const char *, ...)
PyAPI_FUNC(int) PyArg_ParseTupleAndKeywords(PyObject *, PyObject *, const char *,  char **, ...)
PyArg_Parse(不推荐使用)

PyAPI_FUNC(double) PyFloat_AsDouble(PyObject *pyfloat)
PyAPI_FUNC(long) PyInt_AsLong(PyObject *)
PyAPI_FUNC(char *) PyString_AsString(PyObject *)

调用python：
首先必不可少的要import：
PyAPI_FUNC(PyObject *) PyImport_ImportModule(const char *name)

调用函数：
PyAPI_FUNC(PyObject *) PyObject_CallMethod(PyObject *o, char *method, char *format, ...)：
o.method(arg)

PyAPI_FUNC(PyObject *) PyObject_CallFunction(PyObject *callable_object, char *format, ...)：
callable_object(arg)

PyAPI_FUNC(PyObject *) PyObject_CallObject(PyObject *callable_object, PyObject *args)

PyAPI_FUNC(PyObject *) PyObject_Call(PyObject *callable_object, PyObject *args, PyObject *kw)：
args不能为NULL(PyObject_CallObject不受此限)，此时()即空tuple可以接受。

其他函数：
Py_Initialize()、Py_Finalize
int PyRun_SimpleString(const char *cmd)
PyObject *PyModule_GetDict(PyObject *module) [相当于模块的__dict__属性]
PyObject *PyObject_GetAttrString(PyObject *obj， char *attr) [获取对象obj的attr属性或者函数]

引用计数：
部分返回borrowed reference的函数：
PyImport_GetModuleDict、PyModule_GetDict、
PyList_GetItem、PyList_GET_ITEM、PyTuple_GetItem、PyTuple_GET_ITEM
PyDict_GetItem、PyDict_GetItemString

部分steal reference的函数：
PyTuple_SetItem、PyTuple_SET_ITEM、PyList_SetItem、PyList_SET_ITEM