C++嵌入Python,以及两者混用

  以前项目中是C++嵌入Python,开发起来很便利,逻辑业务可以放到python中进行开发,容易修改,以及功能扩展。不过自己没有详细的研究过C++嵌入python的细节,这次详细的研究一下。首先我们简单的使用C++调用一个Python的py脚本,然后通过Python使用C++中的对象和方法。我们使用的Python是2.7.11

  1. 使用C++使用python的功能,比如我们写一个show.py,代码如下:  

def show(name):
    return "hello " + name

  这个python脚本实在是太简单了,不需要任何解释了。然后简单的写一个C++函数,来简单的调用这个show.py中的函数show:

#include <Python.h>
#include <iostream>
using namespace std;

void python_test() {
    Py_SetPythonHome("D:/Python27");
    Py_Initialize();

    PyObject* pModule = PyImport_ImportModule("show");
    if (!pModule) {
        cout << "import python module test failed." << endl;
        return;
    }

    PyObject* pFunc = PyObject_GetAttrString(pModule, "show");
    if (!pFunc) {
        cout << "import python func failed." << endl;
        return;
    }

    PyObject* pParam = Py_BuildValue("(s)", "hahaha");
    PyObject* pResult = PyObject_CallObject(pFunc, pParam);
    if (pResult) {
        char* pBuf = NULL;
        int nBufSize = 0;
        //if (PyArg_ParseTuple(pResult, "si", &pBuf, &nBufSize))
        //{
        //    cout << "buf=" << pBuf << endl;
        //    cout << "buf size=" << nBufSize << endl;
        //}

        if (PyArg_Parse(pResult, "s", &pBuf))
        {
            cout << "buf=" << pBuf << endl;
        }
    }

    Py_DECREF(pParam);
    Py_DECREF(pResult);

    Py_Finalize();
    return;
}

int main() {
    python_test();
}

  这里需要注意几个地方:

  (1) 首先Py_SetPythonHome("D:/Python27");这条语句是用来设置Python脚本的目录的,如果不设置这个目录,我们就不知道Python去哪个目录去读取我们的脚本了

  (2) Py_BuildValue("(s)", "hahaha"); 即使这里只需要一个参数,也需要使用tuple这样的方式传递参数,否则python解析模块会报错,它内部做了参数类型判断。

  (3) 如果show函数返回的是一个普通参数,我们使用PyArg_Parse来解析, 如果是一个元组,我们使用PyArg_ParseTuple来解析。不能混用,否则内部也会报错。

  从代码上看起来也是非常的简单,不过一开始部署环境不是这么简单,因为我们默认安装的Python是没有python27_d.lib 和python27_d.dll这2个文件的,具体如何解决python环境的问题,看第二节。

  

  2. python代码编译

  之前说了默认安装的Python是没有python27_d.lib 和python27_d.dll这2个文件的,我尝试过从网上单独下载这2个文件,不过小版本号不匹配也会出现运行时的crash。所以我选择了从网上下载了python2.7.11源代码,然后自己进行编译。不过这个编译总的来说是非常简单的,我是在windows下使用vs2012编译的,主要需要注意一下几点:

  (1) 使用PCbuild中的pcbuild.sln,直接打开,然后再vs中选中python项目,直接编译,我的编译过程是没有出现任何错误的,有些警告,我们直接忽略。在debug模式下,直接生成python27_d.lib 和python27_d.dll,还有python27_d.exe

  (2) 虽然我们有了python27_d.lib 和python27_d.dll,然后再在之前测试工程中添加好include和lib的目录,编译的时候,会提示找不到pyconfig.h这个文件。 这是因为这个文件是windows下特有的,我们需要在PC目录中copy这个文件到include目录下,然后再编译,就可以正常完成了。

  

  3. python调用C++对象

  python调用C++接口,有多种办法。通常python调用C++接口是一种功能扩展,将C++功能编译成动态库,然后python通过ctypes来导入库文件,在windows下是dll,linux下是so文件,这个使用比较简单,而且例子非常多,就不再介绍了。在很多复杂项目中,比如游戏中,我们希望python中操作玩家对象,那么如果将这个模块导成库文件,非常麻烦,而且不方便操作玩家对象实例。我们采用动态的方式来进行:

  示例中我们新建2个c++类,一个Person,一个PersonWrap。 Person对象代表某个人,PersonWrap是针对Person的Python接口扩展,Person.h代码如下:

#ifndef PERSON_H
#define PERSON_H

#include <string>
using namespace std;

class Person {
public:
    Person(){}
    ~Person(){}

    void setName(const string& _name) {
        name = _name;
    }

    string& getName() {
        return name;
    }

private:
    string name;
};

#endif

  PersonWrap.h代码如下:

#ifndef PERSON_WRAP_H
#define PERSON_WRAP_H

#include <Python.h>
#include "Person.h"

class PersonWrap {
public:
    static PyObject* SetName(PyObject* self, PyObject* args) {
        cout << "Wrap setName" << endl;
        int personAddr = 0;
        char* pName = NULL;
        if (!PyArg_ParseTuple(args, "is", &personAddr, &pName)) {
            return NULL;
        }
        Person* p = (Person*)personAddr;
        p->setName(pName);
        
        return Py_BuildValue("i", 0);
    }

    static PyObject* GetName(PyObject* self, PyObject* args) {
        int personAddr = 0;
        if (!PyArg_ParseTuple(args, "i", &personAddr)) {
            return NULL;
        }
        Person* p = (Person*)personAddr;

        string& name = p->getName();
        return Py_BuildValue("s", name.c_str());
    }

    static PyObject* GetDesc(PyObject* self, PyObject* args) {
        return Py_BuildValue("s", "whoknows");
    }

    static PyObject* CreatePerson(PyObject* self, PyObject* args) {
        cout << "Wrap create person" << endl;

        char* pName = NULL;
        if (!PyArg_ParseTuple(args, "s", &pName)) {
            return NULL;
        }

        Person* p = new Person();
        p->setName(pName);
        return Py_BuildValue("i", p);
    }
};

PyMethodDef WrapMethods[] = {
    {"SetName", PersonWrap::SetName, METH_VARARGS, "SetName"},
    {"GetName", PersonWrap::GetName, METH_VARARGS, "GetName"},
    {"GetDesc", PersonWrap::GetDesc, METH_VARARGS, "GetDesc"},
    {"CreatePerson", PersonWrap::CreatePerson, METH_VARARGS, "CreatePerson"},
    {NULL, NULL, 0, NULL}
};

PyMODINIT_FUNC initPythonWrap() {
    PyObject* module;
    module = Py_InitModule("PythonWrap", WrapMethods);
}

#endif

  Person类的代码非常简单,不需要解释了。PersonWrap针对Person的接口进行了封装,可以看出PersonWrap中都是static函数,这是为了能够导出接口供Python使用,同时定义一个WrapMethods数组,将这些接口用Python方法的定义方式导出。最后用一个initPythonWrap方法来对这个模块进行动态初始化。这样我们的ptyhon脚本就可以调用了。

  不过需要在main函数中,新增initPythonWrap();的调用,否则不会生效。我们测试的python代码如下:

import sys
import PythonWrap

def show(name):
    person = PythonWrap.CreatePerson("tom")
    PythonWrap.SetName(person, "jim")
    return "hello " + PythonWrap.GetName(person)

  从python脚本可以看出,我们import了我们动态生成的PythonWrap模块,然后就能像其他普通python模块一样随意的调用其接口。需要注意的是,我们的Person对象是一个C++对象,根据文档查询,如果不利于第三方插件是不能直接将C++对象传递给Python的,所以我们在传出和传入的时候,是将Person对象指针通过整数的方式进行传递的,然后强制进行指针转换。

  如果在debug模式下,在我们调用python的show函数时,使用到了PythonWrap中的接口时,会进入我们的C++代码,调试起来还是比较方便的。不过还存在一些问题,就是如果我们的SetName接口写成这样:

static PyObject* SetName(PyObject* self, PyObject* args) {
        cout << "Wrap setName" << endl;
        int personAddr = 0;
        char* pName = NULL;
        if (!PyArg_ParseTuple(args, "is", &personAddr, &pName)) {
            return NULL;
        }
        Person* p = (Person*)personAddr;
        p->setName(pName);
        
        return NULL;
    }

  那么这个接口就只能被调用一次,第二次调用的时候就不会再触发,应该是针对返回值,python模块代码中做了特殊的处理,现在还不知道具体原因。等后面弄明白之后再来补充。

原文地址:https://www.cnblogs.com/chobits/p/5045946.html