安裝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 。