用C語言擴展Python的功能

Python是一門功能強大的高級腳本語言,它的強大不僅表現(xiàn)在其自身的功能上巧骚,而且還表現(xiàn)在其良好的可擴展性上个从,正因如此,Python已經(jīng)開始受到越來越多人的青睞鸭轮,并且被屢屢成功地應用于各類大型軟件系統(tǒng)的開發(fā)過程中臣淤。

與其它普通腳本語言有所不同,Python程序員可以借助Python語言提供的API窃爷,使用C或者C++來對Python進行功能性擴展邑蒋,從而即可以利用Python方便靈活的語法和功能,又可以獲得與C或者C++幾乎相同的執(zhí)行性能按厘。執(zhí)行速度慢是幾乎所有腳本語言都具有的共性医吊,也是倍受人們指責的一個重要因素,Python則通過與C語言的有機結合巧妙地解決了這一問題逮京,從而使腳本語言的應用范圍得到了很大擴展卿堂。

在用Python開發(fā)實際軟件系統(tǒng)時,很多時候都需要使用C/C++來對Python進行擴展懒棉。最常見的情況是目前已經(jīng)存在一個用C編寫的庫御吞,需要在Python語言中使用該庫的某些功能,此時就可以借助Python提供的擴展功能來實現(xiàn)漓藕。此外,由于Python從本質上講還是一種腳本語言挟裂,某些功能用Python實現(xiàn)可能很難滿足實際軟件系統(tǒng)對執(zhí)行效率的要求享钞,此時也可以借助Python提供的擴展功能,將這些關鍵代碼段用C或者C++實現(xiàn),從而提供程序的執(zhí)行性能栗竖。

本文主要介紹Python提供的C語言擴展接口暑脆,以及如何使用這些接口和C/C++語言來對Python進行功能性擴展,并輔以具體的實例講述如何實現(xiàn)Python的功能擴展狐肢。

二添吗、Python的C語言接口

Python是用C語言實現(xiàn)的一種腳本語言,本身具有優(yōu)良的開放性和可擴展性份名,并提供了方便靈活的應用程序接口(API)碟联,從而使得C/C++程序員能夠在各個級別上對Python解釋器的功能進行擴展。在使用C/C++對Python進行功能擴展之前僵腺,必須首先掌握Python解釋所提供的C語言接口鲤孵。

2.1 Python對象(PyObject)

Python是一門面向對象的腳本語言,所有的對象在Python解釋器中都被表示成PyObject辰如,PyObject結構包含Python對象的所有成員指針普监,并且對Python對象的類型信息和引用計數(shù)進行維護。在進行Python的擴展編程時琉兜,一旦要在C或者C++中對Python對象進行處理凯正,就意味著要維護一個PyObject結構。

在Python的C語言擴展接口中豌蟋,大部分函數(shù)都有一個或者多個參數(shù)為PyObject指針類型廊散,并且返回值也大都為PyObject指針。

2.2 引用計數(shù)

為了簡化內存管理夺饲,Python通過引用計數(shù)機制實現(xiàn)了自動的垃圾回收功能奸汇,Python中的每個對象都有一個引用計數(shù),用來計數(shù)該對象在不同場所分別被引用了多少次往声。每當引用一次Python對象擂找,相應的引用計數(shù)就增1,每當消毀一次Python對象浩销,則相應的引用就減1贯涎,只有當引用計數(shù)為零時伯铣,才真正從內存中刪除Python對象荧止。

下面的例子說明了Python解釋器如何利用引用計數(shù)來對Pyhon對象進行管理:


7例1:refcount.py

classrefcount:

# etc.

r1=refcount()# 引用計數(shù)為1

r2=r1# 引用計數(shù)為2

del(r1)# 引用計數(shù)為1

del(r2)# 引用計數(shù)為0,刪除對象

在C/C++中處理Python對象時舷蟀,對引用計數(shù)進行正確的維護是一個關鍵問題普筹,處理不好將很容易產(chǎn)生內存泄漏败明。Python的C語言接口提供了一些宏來對引用計數(shù)進行維護,最常見的是用Py_INCREF()來增加使Python對象的引用計數(shù)增1太防,用Py_DECREF()來使Python對象的引用計數(shù)減1妻顶。

2.3 數(shù)據(jù)類型

Python定義了六種數(shù)據(jù)類型:整型、浮點型、字符串讳嘱、元組幔嗦、列表和字典,在使用C語言對Python進行功能擴展時沥潭,首先要了解如何在C和Python的數(shù)據(jù)類型間進行轉化邀泉。

2.3.1 整型、浮點型和字符串

在Python的C語言擴展中要用到整型钝鸽、浮點型和字符串這三種數(shù)據(jù)類型時相對比較簡單汇恤,只需要知道如何生成和維護它們就可以了。下面的例子給出了如何在C語言中使用Python的這三種數(shù)據(jù)類型:


17例2:typeifs.c

// build an integer

PyObject*pInt=Py_BuildValue("i",2003);

assert(PyInt_Check(pInt));

inti=PyInt_AsLong(pInt);

Py_DECREF(pInt);

// build a float

PyObject*pFloat=Py_BuildValue("f",3.14f);

assert(PyFloat_Check(pFloat));

floatf=PyFloat_AsDouble(pFloat);

Py_DECREF(pFloat);

// build a string

PyObject*pString=Py_BuildValue("s","Python");

assert(PyString_Check(pString);

intnLen=PyString_Size(pString);

char*s=PyString_AsString(pString);

Py_DECREF(pString);

2.3.2 元組

Python語言中的元組是一個長度固定的數(shù)組寞埠,當Python解釋器調用C語言擴展中的方法時屁置,所有非關鍵字(non-keyword)參數(shù)都以元組方式進行傳遞。下面的例子示范了如何在C語言中使用Python的元組類型:



17例3:typetuple.c

// create the tuple

PyObject*pTuple=PyTuple_New(3);

assert(PyTuple_Check(pTuple));

assert(PyTuple_Size(pTuple)==3);

// set the item

PyTuple_SetItem(pTuple,0,Py_BuildValue("i",2003));

PyTuple_SetItem(pTuple,1,Py_BuildValue("f",3.14f));

PyTuple_SetItem(pTuple,2,Py_BuildValue("s","Python"));

// parse tuple items

inti;

floatf;

char*s;

if(!PyArg_ParseTuple(pTuple,"ifs",&i,&f,&s))

PyErr_SetString(PyExc_TypeError,"invalid parameter");

// cleanup

Py_DECREF(pTuple);

2.3.3 列表

Python語言中的列表是一個長度可變的數(shù)組仁连,列表比元組更為靈活蓝角,使用列表可以對其存儲的Python對象進行隨機訪問。下面的例子示范了如何在C語言中使用Python的列表類型:

Python


24例4:typelist.c

//createthelist

PyObject*pList=PyList_New(3);//newreference

assert(PyList_Check(pList));

//setsomeinitialvalues

for(inti=0;i<3;++i)

PyList_SetItem(pList,i,Py_BuildValue("i",i));

//insertanitem

PyList_Insert(pList,2,Py_BuildValue("s","inserted"));

//appendanitem

PyList_Append(pList,Py_BuildValue("s","appended"));

//sortthelist

PyList_Sort(pList);

//reversethelist

PyList_Reverse(pList);

//fetchandmanipulatealistslice

PyObject*pSlice=PyList_GetSlice(pList,2,4);//newreference

for(intj=0;j<PyList_Size(pSlice);++j){

PyObject*pValue=PyList_GetItem(pList,j);

assert(pValue);

}

Py_DECREF(pSlice);

//cleanup

Py_DECREF(pList);

2.3.4 字典

Python語言中的字典是一個根據(jù)關鍵字進行訪問的數(shù)據(jù)類型饭冬。下面的例子示范了如何在C語言中使用Python的字典類型:

Python



21例5:typedic.c

//createthedictionary

PyObject*pDict=PyDict_New();//newreference

assert(PyDict_Check(pDict));

//addafewnamedvalues

PyDict_SetItemString(pDict,"first",

Py_BuildValue("i",2003));

PyDict_SetItemString(pDict,"second",

Py_BuildValue("f",3.14f));

//enumerateallnamedvalues

PyObject*pKeys=PyDict_Keys();//newreference

for(inti=0;i<PyList_Size(pKeys);++i){

PyObject*pKey=PyList_GetItem(pKeys,i);

PyObject*pValue=PyDict_GetItem(pDict,pKey);

assert(pValue);

}

Py_DECREF(pKeys);

//removeanamedvalue

PyDict_DelItemString(pDict,"second");

//cleanup

Py_DECREF(pDict);

三使鹅、Python的C語言擴展

3.1 模塊封裝

在了解了Python的C語言接口后,就可以利用Python解釋器提供的這些接口來編寫Python的C語言擴展昌抠,假設有如下一個C語言函數(shù):

Python


8例6:example.c

intfact(intn)

{

if(n<=1)

return1;

else

returnn*fact(n-1);

}

該函數(shù)的功能是計算某個給定自然數(shù)的階乘患朱,如果想在Python解釋器中調用該函數(shù),則應該首先將其實現(xiàn)為Python中的一個模塊炊苫,這需要編寫相應的封裝接口裁厅,如下所示:



21例7:wrap.c

#include

PyObject*wrap_fact(PyObject*self,PyObject*args)

{

intn,result;

if(!PyArg_ParseTuple(args,"i:fact",&n))

returnNULL;

result=fact(n);

returnPy_BuildValue("i",result);

}

staticPyMethodDefexampleMethods[]=

{

{"fact",wrap_fact,METH_VARARGS,"Caculate N!"},

{NULL,NULL}

};

voidinitexample()

{

PyObject*m;

m=Py_InitModule("example",exampleMethods);

}

一個典型的Python擴展模塊至少應該包含三個部分:導出函數(shù)、方法列表和初始化函數(shù)侨艾。

3.2 導出函數(shù)

要在Python解釋器中使用C語言中的某個函數(shù)执虹,首先要為其編寫相應的導出函數(shù),上述例子中的導出函數(shù)為wrap_fact唠梨。在Python的C語言擴展中袋励,所有的導出函數(shù)都具有相同的函數(shù)原型:

1

PyObject*method(PyObject*self,PyObject*args);

該函數(shù)是Python解釋器和C函數(shù)進行交互的接口,帶有兩個參數(shù):self和args当叭。參數(shù)self只在C函數(shù)被實現(xiàn)為內聯(lián)方法(built-in method)時才被用到茬故,通常該參數(shù)的值為空(NULL)。參數(shù)args中包含了Python解釋器要傳遞給C函數(shù)的所有參數(shù)蚁鳖,通常使用Python的C語言擴展接口提供的函數(shù)PyArg_ParseTuple()來獲得這些參數(shù)值磺芭。

所有的導出函數(shù)都返回一個PyObject指針,如果對應的C函數(shù)沒有真正的返回值(即返回值類型為void)醉箕,則應返回一個全局的None對象(Py_None)钾腺,并將其引用計數(shù)增1甘邀,如下所示:

1

2

3

4

5PyObject*method(PyObject *self,PyObject *args)

{

Py_INCREF(Py_None);

returnPy_None;

}

3.3 方法列表

方法列表中給出了所有可以被Python解釋器使用的方法,上述例子對應的方法列表為:

1

2

3

4

5staticPyMethodDefexampleMethods[]=

{

{"fact",wrap_fact,METH_VARARGS,"Caculate N!"},

{NULL,NULL}

};

方法列表中的每項由四個部分組成:方法名垮庐、導出函數(shù)、參數(shù)傳遞方式和方法描述坞琴。方法名是從Python解釋器中調用該方法時所使用的名字哨查。參數(shù)傳遞方式則規(guī)定了Python向C函數(shù)傳遞參數(shù)的具體形式,可選的兩種方式是METH_VARARGS和METH_KEYWORDS剧辐,其中METH_VARARGS是參數(shù)傳遞的標準形式寒亥,它通過Python的元組在Python解釋器和C函數(shù)之間傳遞參數(shù),若采用METH_KEYWORD方式荧关,則Python解釋器和C函數(shù)之間將通過Python的字典類型在兩者之間進行參數(shù)傳遞溉奕。

3.4 初始化函數(shù)

所有的Python擴展模塊都必須要有一個初始化函數(shù),以便Python解釋器能夠對模塊進行正確的初始化忍啤。Python解釋器規(guī)定所有的初始化函數(shù)的函數(shù)名都必須以init開頭加勤,并加上模塊的名字。對于模塊example來說同波,則相應的初始化函數(shù)為:

1

2

3

4

5voidinitexample()

{

PyObject*m;

m=Py_InitModule("example",exampleMethods);

}

當Python解釋器需要導入該模塊時鳄梅,將根據(jù)該模塊的名稱查找相應的初始化函數(shù),一旦找到則調用該函數(shù)進行相應的初始化工作未檩,初始化函數(shù)則通過調用Python的C語言擴展接口所提供的函數(shù)Py_InitModule()戴尸,來向Python解釋器注冊該模塊中所有可以用到的方法。

3.5 編譯鏈接

要在Python解釋器中使用C語言編寫的擴展模塊冤狡,必須將其編譯成動態(tài)鏈接庫的形式孙蒙。下面以RedHat Linux 8.0為例,


-I/usr/lib/python2.2/config

example.cwrapper.c


3.6 引入Python解釋器

當生成Python擴展模塊的動態(tài)鏈接庫后悲雳,就可以在Python解釋器中使用該擴展模塊了挎峦,與Python自帶的模塊一樣,擴展模塊也是通過import命令引入后再使用的怜奖,如下所示:



Python2.2.1(#1, Aug 30 2002, 12:15:30)

[GCC3.220020822(RedHatLinuxRawhide3.2-4)]onlinux2

Type"help","copyright","credits"or"license"formoreinformation.

>>>importexample

>>>example.fact(4)

24

>>>

四浑测、結束語

作為一門功能強大的腳本語言,Python將被更加廣泛地應用于各個領域歪玲。為了克服腳本語言執(zhí)行速度慢的問題迁央,Python提供了相應的C語言擴展接口,通過將影響執(zhí)行性能的關鍵代碼用C語言實現(xiàn)滥崩,可以很大程度上提高用Python編寫的腳本在運行時的速度岖圈,從而滿足實際需要。

學好python你需要一個良好的環(huán)境钙皮,一個優(yōu)質的開發(fā)交流群蜂科,群里都是那種相互幫助的人才是可以的顽决,我有建立一個python學習交流群,在群里我們相互幫助导匣,相互關心才菠,相互分享內容,這樣出問題幫助你的人就比較多贡定,群號是301赋访,還有056,最后是051缓待,這樣就可以找到大神聚合的群蚓耽,如果你只愿意別人幫助你,不愿意分享或者幫助別人旋炒,那就請不要加了步悠,你把你會的告訴別人這是一種分享。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末瘫镇,一起剝皮案震驚了整個濱河市鼎兽,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌汇四,老刑警劉巖接奈,帶你破解...
    沈念sama閱讀 216,496評論 6 501
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異通孽,居然都是意外死亡序宦,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,407評論 3 392
  • 文/潘曉璐 我一進店門背苦,熙熙樓的掌柜王于貴愁眉苦臉地迎上來互捌,“玉大人,你說我怎么就攤上這事行剂★踉耄” “怎么了?”我有些...
    開封第一講書人閱讀 162,632評論 0 353
  • 文/不壞的土叔 我叫張陵厚宰,是天一觀的道長腌巾。 經(jīng)常有香客問我,道長铲觉,這世上最難降的妖魔是什么澈蝙? 我笑而不...
    開封第一講書人閱讀 58,180評論 1 292
  • 正文 為了忘掉前任,我火速辦了婚禮撵幽,結果婚禮上灯荧,老公的妹妹穿的比我還像新娘。我一直安慰自己盐杂,他們只是感情好逗载,可當我...
    茶點故事閱讀 67,198評論 6 388
  • 文/花漫 我一把揭開白布哆窿。 她就那樣靜靜地躺著,像睡著了一般厉斟。 火紅的嫁衣襯著肌膚如雪挚躯。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,165評論 1 299
  • 那天擦秽,我揣著相機與錄音秧均,去河邊找鬼。 笑死号涯,一個胖子當著我的面吹牛,可吹牛的內容都是我干的锯七。 我是一名探鬼主播链快,決...
    沈念sama閱讀 40,052評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼眉尸!你這毒婦竟也來了域蜗?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 38,910評論 0 274
  • 序言:老撾萬榮一對情侶失蹤噪猾,失蹤者是張志新(化名)和其女友劉穎霉祸,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體袱蜡,經(jīng)...
    沈念sama閱讀 45,324評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡丝蹭,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,542評論 2 332
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了坪蚁。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片奔穿。...
    茶點故事閱讀 39,711評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖敏晤,靈堂內的尸體忽然破棺而出贱田,到底是詐尸還是另有隱情,我是刑警寧澤嘴脾,帶...
    沈念sama閱讀 35,424評論 5 343
  • 正文 年R本政府宣布男摧,位于F島的核電站,受9級特大地震影響译打,放射性物質發(fā)生泄漏耗拓。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 41,017評論 3 326
  • 文/蒙蒙 一扶平、第九天 我趴在偏房一處隱蔽的房頂上張望帆离。 院中可真熱鬧,春花似錦结澄、人聲如沸哥谷。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,668評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽们妥。三九已至猜扮,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間监婶,已是汗流浹背旅赢。 一陣腳步聲響...
    開封第一講書人閱讀 32,823評論 1 269
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留惑惶,地道東北人煮盼。 一個月前我還...
    沈念sama閱讀 47,722評論 2 368
  • 正文 我出身青樓,卻偏偏與公主長得像带污,于是被迫代替她去往敵國和親僵控。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 44,611評論 2 353

推薦閱讀更多精彩內容