C++使用ffpython嵌入和扩展python

在服务器编程中，经常会用到python脚本技术。Python是最流行的脚本之一，并且python拥有定义良好的C API接口，同时又有丰富的文档，与C++结合非常的适合。通常情况下使用C++封装机制，而用python脚本实现策略或者是控制。使用python和C++结合的技术拥有如下优势：

l  主体系统使用C++实现，保持系统的高效。

l  控制部分使用python，增加开发效率，python的内存垃圾回收，丰富的类库都使C++开发者获益匪浅。

l  Python脚本可以运行期重载，可以实现控制部分不停机热更新。

C++与python的编程范式有很大不同，当使用python C API调用python时，python中的一些特有机制会给C++开发者带来很多困惑。常常使用python C API时需要注意如下几点:

l  Python 使用引用计数管理内存，调用python C API时对于返回值返回的是借用的引用还是新的引用，需要根据文档仔细确认。否则轻则出现内存泄露，重则程序崩溃。

l  Python中的数据结构与C++的有很大不同。Python常用的有tuple，list，dict。而c++常用的事vector，list，map，并且c++是强类型的。当c++与python进行交互时，C++层希望操作python数据结构就像操作c++ STL一样方便，而在python脚本层，又希望c++传入的参数或返回值都是原生的python数据

l  C++中常用的指针传递对象，当嵌入python时，需要把c++对象传递到python中。

Ffpython是专门方便C++嵌入python开发的类库，基于ffpython一方面可以轻松的将python集成到C++系统，另一方面，C++对象或接口也可以很容易被python使用，总之ffpython简化了c++与python的交互操作。

最简单的使用python的方式是把python脚本当作配置，如获取脚本中的一个字符串变量。Python的脚本文件会被python虚拟机import为module，和python的标准库的module实际上是相似的概念。Ffpython封装了获取python module中的变量的操作。

上面的代码获取python标准库中sys的version变量值，ffpython通过模板函数的自动将python的str类型自动适配到c++的string类型。get_global_var是获取变量的接口，与之对应的是设置变量的借口get_global_var：

调用python函数是嵌入python非常常用的操作，ffpython中提供了call接口用于调用python中的module的函数：

上面的代码调用time模块的asctime方法，我们也可以使用call接口调用我们自己编写的函数：

Call被定义为模版函数，传入的参数会自动适配到python相应的类型。对应的python函数为：

上面的python函数接受三个参数，c++传入了三个标准类型参数，实际上call接口最多支持9个泛型参数，常用的stl 参数是被支持的：

对应调用的python函数为：

不但STL泛型被支持，嵌套定义的类似vector<list<string> > 的结构都是被支持的，vector和list都会转换成python的list结构，而map则转换为dict结构。

调用call接口必须指定接收的返回值类型，可以使用void忽略返回值，除了可以使用标准类型，stl接口也可以被使用，python中的tuple和list可以转换成vector和list，dict则可以被转换成map。需要注意的是，若类型没有匹配，call函数将会抛出异常。用户可以catch标准异常，what接口返回的字符串包含了异常的traceback信息方便排查错误。示例如下：

Ffpython 可以注册static函数到python中，全局的C风格的static函数和类中定义的static函数都可以被注册到python中，示例如下： 

以上代码注册了两个接口给python，然后调用fftest文件中的test_reg_function测试两个接口，fftest.py中定义测试代码：

这两个接口虽然简单，但是说明了ffpython注册的接口支持多个参数，参数类型可以是标准C++类型，也可以是STL泛型。同样返回值的类型也是如此。

使用ffpython 注册C++的对象也很容易，ffpython支持注册c++类的构造函数，成员变量，成员方法到python，示例代码如下：

当c++类型被注册到python中后，python中使用该类型就像python内建的类型一样方便，需要注意的是，如果python中动态的创建了c++对象，那么他是被python的GC管理生命周期的，所以当变量不在被引用时，c++对象的析构函数被调用。对应的fftest.py中测试的脚本代码为：

同前边所诉的原则相同，支持C++ 标准内建类型和STL 泛型。当这个python函数返回时，foo_t的析构函数会被调用。

dumy_t是foo_t的子类。使用ffpython可以方便表示两个类型的关系。如果基类已经定义的接口，子类不需要重复定义，比如要注册子类：

只需要单独注册一下子类特有的接口，其他接口自动从foo_t基类中继承而来，相应的测试python脚本代码为：

Ffpython中一个非常用用的特性是，c++创建的对象可以传递到python中，而python使用起来就像正常的python对象一样，另外python创建的c++对象也可以传递到c++中，简单示例代码：

相应的fftest.py中的测试脚本代码为：

l  Ffpython 支持c++调用python函数，获取和设置模块内的变量

l  Ffpython call接口最多支持9个泛型参数，支持的类型包括c++内建的类型和STL 泛型。以及已经被注册的c++类的指针类型。返回值的类型约束同样如此。c++ STL中的vector和list对应于python的tuple和list，map类型则对应于dict。

l  Ffpython支持将c++的静态函数注册到python中。

l  Ffpython支持c++类的注册，并且支持继承。Python中操作c++对象就像操作原生python对象一样。

l  Ffpython注册的c++类在python中被创建后，将会由python GC负责回收内存。

l  Ffpython 类库只有一个文件，并且不依赖其他第三方库，非常容易集成到项目中。而且ffpython遵从开源协议。

l  Ffpython使用c++模板技术，封装了python C API的使用细节，保持精巧和简洁，效率和完全的python C API编写的代码几乎相同。Ffpython的实现可以作为非常好的python C API的示例。