//-------------------------------------------------------------------------
// 函數(shù)    : initPyExt
// 功能    : 初始化函數(shù)
// 返回值   :PyMODINIT_FUNC
// 附注    : 注意，這個(gè)函數(shù)的名字不能改動(dòng)。必須是init+模塊名字，
// 我們的模塊名字是PyExt，所以函數(shù)名是initPyExt。Python在導(dǎo)入
// 我們的PyExt模塊時(shí)，會找到這個(gè)函數(shù)，并調(diào)用。這個(gè)函數(shù)實(shí)現(xiàn)的
// 功能很簡單，通過調(diào)用Py_InitModule將模塊名字和映射表結(jié)合起
// 來，它的意思是說PyExt這個(gè)模塊使用PyExtMethods這個(gè)映射表。
//-------------------------------------------------------------------------
PyMODINIT_FUNCinitPyExt()
{
    Py_InitModule("PyExt",PyExtMethods);
}

/*
   方法列表，這個(gè)是一個(gè)C結(jié)構(gòu)數(shù)組。把需要擴(kuò)展的函數(shù)都映射到這個(gè)表里。
   那么Python就知道你的這個(gè)擴(kuò)展模塊支持一些什么方法了。表的第一個(gè)字
   段是方法名字，也是通過Python來調(diào)用時(shí)的名字。第二個(gè)字段是導(dǎo)出函數(shù)，
   是真正調(diào)用的函數(shù)，也是C\C++實(shí)現(xiàn)的函數(shù)。第三個(gè)參數(shù)是指明Python向
   C\C++函數(shù)傳遞參數(shù)的形式?？蛇x的兩種方式是METH_VARARGS和
   METH_KEYWORDS，其中METH_VARARGS是參數(shù)傳遞的標(biāo)準(zhǔn)形式，它通
   過Python的元組在Python解釋器和C函數(shù)之間傳遞參數(shù)，若采用
   METH_KEYWORD方式，則Python解釋器和C函數(shù)之間將通過Python的字典
   類型在兩者之間進(jìn)行參數(shù)傳遞。第四個(gè)字段是這個(gè)函數(shù)的說明。如果你在
   python里來help這個(gè)函數(shù)，將顯示這個(gè)說明。相當(dāng)于在python里的函數(shù)的文檔說明。
*/
staticPyMethodDefPyExtMethods[]=
{
    {"Add", Add,METH_VARARGS,"Addtwo number - edit by magictong."},
    {"ExecSystem",ExecSystem,METH_VARARGS,"Execute a shell command - edit bymagictong." },
    {NULL,NULL, 0,NULL}
};

//-------------------------------------------------------------------------
// 函數(shù)    : Add
// 功能    : 這是一個(gè)加法函數(shù)
// 返回值   :PyObject*
// 參數(shù)    : PyObject*self 這個(gè)參數(shù)我們暫時(shí)不用理會
// 參數(shù)    : PyObject*args 是一個(gè)參數(shù)列表，我們需要從它解析出參數(shù)
// 附注    :
// 所有的導(dǎo)出函數(shù)都具有相同的原型：
// PyObject*method(PyObject* self, PyObject* args);
//PyArg_ParseTuple來完成解析參數(shù)任務(wù)。它的第一個(gè)參數(shù)是args，
// 就是我們要轉(zhuǎn)換的參數(shù)。第二個(gè)是格式符號。"s"代表是個(gè)string。
// 從args里提取一個(gè)參數(shù)就寫"s"，兩個(gè)的話就寫"s|s"，如果是一個(gè)
// string，一個(gè)int，就寫"s|i"，有點(diǎn)和printf類似哦。第三個(gè)參數(shù)就是
// 提取出來的參數(shù)放置的真正位置。必須傳遞這個(gè)參數(shù)的地址。
//-------------------------------------------------------------------------
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);
    /*
      調(diào)用完之后我們需要返回結(jié)果。這個(gè)結(jié)果是c的type或者是我們自己定義的類型。
      必須把他轉(zhuǎn)換成PyObject，讓python認(rèn)識。這個(gè)用Py_BuildValue來完成。他
      是PyArg_ParseTuple的逆過程。他的第一個(gè)參數(shù)和PyArg_ParseTuple的第二個(gè)
      參數(shù)一樣，是個(gè)格式化符號。第三個(gè)參數(shù)是我們需要轉(zhuǎn)換的參數(shù)。Py_BuildValue
      會把所有的返回只組裝成一個(gè)tutple給python。
 
      如果對應(yīng)的C函數(shù)沒有返回值（即返回值類型為void），則應(yīng)返回一個(gè)全局的None
      對象(Py_None)，并將其引用計(jì)數(shù)增，如下所示：
      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);
}