python調用C和C++代碼

安裝python
後，會有一個chm
格式的python
手冊。要搞明白如何讓python
調用C/C++
代碼(
也就是寫python
的 extension)
，你需要征服手冊中的<<Extending && embedding>>
厚厚的一章。在昨天花了一個小時看地頭暈腦脹，仍然不知道如何寫python
的extension
後，查閱了一些其他 書籍，最終在<<Python Programming On Win32>>
書中找到了教程。

下面記錄一下如何在visual studio 2005
中，寫一段C/C++
的MessageBox
代碼，然後提供後python
調用，最後的結果當然是顯示一個MessageBox.

1.
首先要明白的是，所謂的python
擴充（也就是你提供給python
的c/c++
代碼，不一定是c/c++
代碼，可以是其他語言寫的代碼)
是一個 dll,
並且這個dll
放在本機python
安裝目錄下的DLLs
目錄下（譬如我機器上的路徑是：F:/Program Files/Python25/DLLs)
，假如我們接下來要寫的擴充module
名為mb,python
調用的代碼為：
    import mb
    mb.showMsg("Python's really amazing, I kindda love it!")

python
怎麼找到我們的mb
模組呢？就是上面說的，我們要產生一個mb.dll
，然後拷貝到Dlls
目錄下面，為了區別普通的dll
和python
專用擴充的dll,
我們的 mb.dll
修改成mb.pyd(python dll)

2.
搭建環境，我們要使用python
提供的c
標頭檔和lib
庫來進行擴充的開發。

在vs 2005
下點擊菜單 "
工具"->"
選項",
開啟選項對話方塊，選擇"
項目和解決方案->VC++
目錄",
然後在右邊"
顯示以下內容的目錄"
得comboBox
上選擇"
包含檔案”
，添加python
的include
目錄(
我的機器上是"F:/Program Files/Python25/include"),
然後選擇庫檔案,
添加python
的libs
目錄(
我的機器上是"F:/Program Files/Python25/libs")
。

既然擴充是一個dll,
接下來我們要建立一個“
動態連結程式庫”
工程，然後開始寫代碼：

#include <python.h> //python.h
是包含python
一些定義的標頭檔，在python
的include
目錄下

/*
   
我的python
版本是2.5,
因為安裝python
後它沒提供debug
下的lib
庫檔案，因此你必鬚生成release
版的dll
，
   
想要產生dll
版本的，你要到python
官網上自己去下載python
原始碼,
當然你可以繼續產生release
版本的dll,
但dll
中包含調試資訊
*/
#pragma comment(lib, "python25.lib")

//
先不管
static PyObject* mb_showMsg(PyObject* self, PyObject *args);

/*
   
如果你的擴充是mb,
那麼必須實現一個initmb
函數，並且從dll
中匯出這個函數，但我們在python
中調用import mb
時，python
會去dll
裡去調用
    initmb
函數，這個函數告訴python
我們有些什麼函數,
該怎麼告訴python
我們有一個showMsg
函數呢？下面詳解
*/

//
必須extern "C"
下，這樣不會在C++
編譯器裡不會更改掉匯出的函數名字，我第一次就犯了這樣的錯誤
extern "C" __declspec(dllexport) void initmb()
{
/*
   
當調用mb.showMsg("Python's really amazing, I kindda love it!")
時， 相當於你告訴python
我有一個showMsg
函數，我們怎麼告訴python
去調用我們dll
裡的mb_showMsg
函數呢？技巧就是下面的方式， 定義一個字典資料結構，key => showMsg, value =>mb_showMsg,METH_VARARGS
是函數調用方式，仔細查手冊吧
*/
    static PyMethodDef mbMethods[] = {
        {"showMsg", mb_showMsg, METH_VARARGS},
        {NULL, NULL, NULL} /*sentinel
，哨兵，用來標識結束*/
    };

    //
告訴python
我們的模組名叫mb,
模組包含的函數都在mbMethods
字典裡
    PyObject *m = Py_InitModule("mb", mbMethods);
}

/*
   
接下來實現核心功能showMsg
*/
//
第一個self
參數我們用不著，具體查手冊，第二個參數是python
傳給我們的參數,
它是一個python
的參數tuple
static PyObject* mb_showMsg(PyObject* self, PyObject *args)
{
    //
我們的showMsg
函數需要的是一個字串參數
    const char* msg = NULL;

    /*
       
調用特殊參數解碼python
傳遞給我們的參數,s
是string,
我們傳遞接收參數的變數地址,
       
如果你的功能函數需要兩個參數，在PyArg_parseTuple
後面繼續添加接受參數的變數地址，
       
這個函數的原型是類似printf
的不定參數的形式
        PyAPI_FUNC(int) PyArg_ParseTuple(PyObject *, const char *, ...);

    */
    if (!PyArg_ParseTuple(args, "s", &msg))
        return NULL;

    //
調用MB
    int r = ::MessageBox(NULL, "hello", "Caption:Form C module", MB_ICONINFORMATION | MB_OK);

    //
傳回值
    return Py_BuildValue("i", r);
}

將上面這段混雜著大量注釋的代碼拷貝到你的編輯器裡，然後編譯產生mb.dll,
修改尾碼成mb.pyd,
然後拷貝到python
的DLLs
目錄下，開啟idle(python
的互動程式）,
寫入代碼：
    import mb
    mb.showMsg("Python's really amazing, I kindda love it!")

可以看到彈出來一個MessageBox
。