分类: C/C++
2008-08-07 17:41:20
常用的Python/C API介绍 执行一段Python代码,就好象是在__main__ 函数里面执行一样。例: 导入一个Python模块,参数name可以是*.py文件的文件名。相当于Python内建函数__import__()。例: 相当于Python模块对象的__dict__ 属性,得到模块名称空间下的字典对象。例: 执行一段Python代码。 解构Python数据为C的类型,这样C程序中才可以使用Python里的数据。例: 返回模块对象o中的attr_name 属性或函数,相当于Python中表达式语句:o.attr_name。例: 构建一个参数列表,把C类型转换为Python对象,使Python可以使用C类型数据,例: 此函数有两个参数,都指向Python对象指针,pfunc是要调用的Python 函数,通常可用PyObject_GetAttrString()获得;pargs是函数的参数列表,通常可用Py_BuildValue()构建。例: 关闭Python解释器,释放解释器所占用的资源。例:
Python2.4环境没有提供调试版本的Python24d.lib,所以上述示例在release模式下编译。编译完成后,把可行文件和附2给出的mymod.py文件放在一起,再点击即可运行。为了简化编程,附3
给出了simplepy.h。这样,调用mymod.transform变成如下形式: 接下来,我们来用C 为Python编写扩展模块(动态链接库),并在Python程序中调用C 开发的扩展功能函数。生成一个取名为pyUtil的Win32
DLL工程,除了pyUtil.cpp文件以外,从工程中移除所有其它文件,并填入如下的代码:
下面是例子中用到的几个Python/C
API的简要介绍及示例代码。注意,这并不是这些函数的详细介绍,而仅仅是我们所用到的功能简介,更详细内容请参考文档[1]、[2]、[3]、[4]。
打开Microsoft Visual Studio .NET 2003,新建一个控制台程序,#include
//先定义一些变量
char *cstr;
PyObject *pstr, *pmod, *pdict;
PyObject *pfunc, *pargs;
1. void Py_Initialize( )
初始化Python解释器,在C 程序中使用其它Python/C API之前,必须调用此函数,如果调用失败,将产生一个致命的错误。例:Py_Initialize();
2. int PyRun_SimpleString( const char *command)
PyRun_SimpleString("from time import time,ctime\n"
"print ''Today is'',ctime(time())\n");
3. PyObject* PyImport_ImportModule( char *name)
pmod = PyImport_ImportModule("mymod"); //mymod.py
4. PyObject* PyModule_GetDict( PyObject *module)
pdict = PyModule_GetDict(pmod);
5. PyObject* PyRun_String( const char *str, int start, PyObject *globals, PyObject *locals)
pstr = PyRun_String("message", Py_eval_input, pdict, pdict);
6. int PyArg_Parse( PyObject *args, char *format, ...)
/* convert to C and print it*/
PyArg_Parse(pstr, "s", &cstr);
printf("%s\n", cstr);
7. PyObject* PyObject_GetAttrString( PyObject *o, char *attr_name)
/* to call mymod.transform(mymod.message) */
pfunc = PyObject_GetAttrString(pmod, "transform");
8. PyObject* Py_BuildValue( char *format, ...)
cstr="this is hjs''s test, to uppercase";
pargs = Py_BuildValue("(s)", cstr);
9. PyEval_CallObject(PyObject* pfunc, PyObject* pargs)
pstr = PyEval_CallObject(pfunc, pargs);
PyArg_Parse(pstr, "s", &cstr);
printf("%s\n", cstr);
10. void Py_Finalize( )
Py_Finalize();
//#include”simplepy.h”
CSimplepy py;
py.ImportModule("mymod");
std::string str=py.CallObject("transform",
"this is hjs''s test, to uppercase");
printf("%s\n", str.c_str());
// pyUtil.cpp
#ifdef PYUTIL_EXPORTS
#define PYUTIL_API __declspec(dllexport)
#else
#define PYUTIL_API __declspec(dllimport)
#endif
#include
在Python代码中调用这个动态链接库:
import pyUtil
result = pyUtil.Recognise("input url of specific data")
print "the result is: " result
用C 为Python写扩展时,如果您愿意使用Boost.Python库的话,开发过程会变得更开心J,要编写一个与上述pyUtil同样功能的动态链接库,只需把文件内容替换为下面的代码。当然,编译需要boost_python.lib支持,运行需要boost_python.dll支持。
#include
所有示例都在Microsoft Windows XP Professional Microsoft Visual Studio .NET 2003 Python2.4环境下测试通过,本文所用的Boost库为1.33版本。
参考资料
附1 text.txt
this is test text in text.txt.
附2 mymod.py
import string
message = ''original string''
message =message message
msg_error=""
try:
text_file = open("text.txt", "r")
whole_thing = text_file.read()
print whole_thing
text_file.close()
except IOError, (errno, strerror):
print "I/O error(%s): %s" % (errno, strerror)
def transform(input):
#input = string.replace(input, ''life'', ''Python'')
return string.upper(input)
def change_msg(nul):
global message #如果没有此行,message是函数里头的局部变量
message=''string changed''
return message
def r_file(nul):
return whole_thing
def get_msg(nul):
return message
附3 simplepy.h
#ifndef _SIMPLEPY_H_
#define _SIMPLEPY_H_
// simplepy.h v1.0
// Purpose: facilities for Embedded Python.
// by hujinshan @2005年9月2日9:13:02
#include