使用C++扩展Python的功能详解

//-------------------------------------------------------------------------
// 函数    : initPyExt
// 功能    : 初始化函数
// 返回值   :PyMODINIT_FUNC
// 附注    : 注意，这个函数的名字不能改动。必须是init+模块名字，
// 我们的模块名字是PyExt，所以函数名是initPyExt。Python在导入
// 我们的PyExt模块时，会找到这个函数，并调用。这个函数实现的
// 功能很简单，通过调用Py_InitModule将模块名字和映射表结合起
// 来，它的意思是说PyExt这个模块使用PyExtMethods这个映射表。
//-------------------------------------------------------------------------
PyMODINIT_FUNCinitPyExt()
{
    Py_InitModule("PyExt",PyExtMethods);
}

/*
   方法列表，这个是一个C结构数组。把需要扩展的函数都映射到这个表里。
   那么Python就知道你的这个扩展模块支持一些什么方法了。表的第一个字
   段是方法名字，也是通过Python来调用时的名字。第二个字段是导出函数，
   是真正调用的函数，也是C\C++实现的函数。第三个参数是指明Python向
   C\C++函数传递参数的形式。可选的两种方式是METH_VARARGS和
   METH_KEYWORDS，其中METH_VARARGS是参数传递的标准形式，它通
   过Python的元组在Python解释器和C函数之间传递参数，若采用
   METH_KEYWORD方式，则Python解释器和C函数之间将通过Python的字典
   类型在两者之间进行参数传递。第四个字段是这个函数的说明。如果你在
   python里来help这个函数，将显示这个说明。相当于在python里的函数的文档说明。
*/
staticPyMethodDefPyExtMethods[]=
{
    {"Add", Add,METH_VARARGS,"Addtwo number - edit by magictong."},
    {"ExecSystem",ExecSystem,METH_VARARGS,"Execute a shell command - edit bymagictong." },
    {NULL,NULL, 0,NULL}
};

//-------------------------------------------------------------------------
// 函数    : Add
// 功能    : 这是一个加法函数
// 返回值   :PyObject*
// 参数    : PyObject*self 这个参数我们暂时不用理会
// 参数    : PyObject*args 是一个参数列表，我们需要从它解析出参数
// 附注    :
// 所有的导出函数都具有相同的原型：
// PyObject*method(PyObject* self, PyObject* args);
//PyArg_ParseTuple来完成解析参数任务。它的第一个参数是args，
// 就是我们要转换的参数。第二个是格式符号。"s"代表是个string。
// 从args里提取一个参数就写"s"，两个的话就写"s|s"，如果是一个
// string，一个int，就写"s|i"，有点和printf类似哦。第三个参数就是
// 提取出来的参数放置的真正位置。必须传递这个参数的地址。
//-------------------------------------------------------------------------
staticPyObject*Add(PyObject*self,PyObject*args)
{
    intx = 0 ;
    inty = 0;
    intz = 0;
    if(!PyArg_ParseTuple(args,"i|i", &x, &y))
       returnNULL;
    z=x +y;
    returnPy_BuildValue("i",z);
    /*
      调用完之后我们需要返回结果。这个结果是c的type或者是我们自己定义的类型。
      必须把他转换成PyObject，让python认识。这个用Py_BuildValue来完成。他
      是PyArg_ParseTuple的逆过程。他的第一个参数和PyArg_ParseTuple的第二个
      参数一样，是个格式化符号。第三个参数是我们需要转换的参数。Py_BuildValue
      会把所有的返回只组装成一个tutple给python。
 
      如果对应的C函数没有返回值（即返回值类型为void），则应返回一个全局的None
      对象(Py_None)，并将其引用计数增，如下所示：
      Py_INCREF(Py_None);
      returnPy_None;
   */
}

intcmd(constchar* arg)
{
    returnsystem(arg);
}
 
staticPyObject*ExecSystem(PyObject*self,PyObject*args)
{
    constchar*command;
    if(!PyArg_ParseTuple(args,"s", &command))
       returnNULL;
    intn =cmd(command);
    returnPy_BuildValue("i",n);
}