上篇文章中讲到Python中调用外部c文件可以有两种方法,一是使用cffi.verify()的形式使用,但是该种方式仍然需要进行函数声明。二是将外部c文件编译成为函数库,然后通过cffi进行使用。

由于第二种方法比较常用,在开源项目中使用较多,因此就第二种方法进行简单实验,主要分为两个步骤:编写c函数并创建动态链接库,在Python中使用链接库中的函数。

(一)创建动态链接库

将文件test_add.c及test_sub.c编译成一个动态库:libtest.so

文件test_add.c及test_sub.c内容如下:

//test_add.c

#include

void add (int a, intb)

{

printf("%d + %d = %d\n", a,b,a+b);

}//test_sub.c

#include

void sub(int a, intb)

{

printf("%d - %d = %d\n", a,b,a-b);

}

使用命令:gcc test_add.c test_sub.c -fpic -shared -o libtest.so将上述文件编译成动态库libtest.so,其中-fpic为编译选项,pic为position independent code,表示生成位置无关的代码,-shared是链接选项,表示编译器生成动态库而不是可执行文件。结果如下:

56f9aa2a060c0ecfa6ca026c4e8d6002.png

以下编写程序调用动态链接库中的函数,编写对应的头文件test_so.h声明动态库中可用的函数:

//test_so.h

#ifndef __TEST_SO__#define __TEST_SO__

void add(int a, intb);void sub(int a, intb);#endif

编写test.c调用动态库中的函数:

//test.c

#include #include"test_so.h"

int main(void)

{

add(3,4);

sub(5,2);return 0;

}

执行gcc test.c -L. -ltest -o test 将test.c与动态库libtest.so链接生成可执行文件test。-L.表示要链接的库在当前目录中,-ltest则为编译器查找动态链接库时隐含的命名规则,即在给出的名字前面加上lib,后面加上.so来确定库的名称。结果如下:

cfe386ad71e104e9bf2ca3fe36f3192b.png

可以看到运行test时会显示找不到libtest.so,可以通过两种方式进行解决:

(1)设置环境变量LD_LIBRARY_PATH指向libtest.so的路径:

dcc984d369fbf41554c7742e70f6dbb3.png

(2)将共享库移动到/usr/local/lib文件夹下或其他lib文件夹下,然后执行ldconfig,重新编译执行即可:

1e37e610dfb23ab0ed52c358efde1811.png

51a6c0e261bafefa2bb8c2a571e9bc8a.png

ldconfig命令主要是在默认搜寻目录(/lib和/usr/lib)以及动态库配置文件/etc/ld.so.conf内所列的目录下, 搜索出可共享的动态链接库(格式如lib*.so*), 进而创建出动态装入程序(ld.so)所需的连接和缓存文件,缓存文件默认为/etc/ld.so.cache。要在运行的程序中使用动态链接库,需要指定系统的动态链接搜索的路径,让系统找到运行所需的动态链接库才可以。系统中的配置文件/etc/ld.so.conf是动态链接库的搜索路径配置文件。在这个文件内,存放着可被Linux共享的动态链接库所在目录的名字(系统目录/lib,/usr/lib除外),多个目录名间以空白字符(空格,换行等)或冒号或逗号分隔。查看该文件的内容:

402589d9d8be675de7dcec538a981194.png

可见其为包含ld.so.conf.d目录下的所有配置文件,进入该目录查看:

d630c4b0ab311da3a923402e9833575f.png

可见该目录下libc.conf文件中包含了路径/usr/local/lib等。但若该目录下没有配置文件包含上述路径,如下:

05d9637a020844e470de8db225e7caf3.png

这种情况下在执行ldconfig之前,需要将新共享库目录加入到共享库配置文件/etc/ld.so.conf中,如下:

echo "/usr/local/lib" >> /etc/ld.so.conf

ldconfig

618a312018378541ddc4312bb926f1ad.png

之后将共享库移动到/usr/local/lib,重新编译执行即可找到对应链接库中的函数。

(二)Python中通过cffi调用上述链接库中的函数

为了通过include的方式可以找到该头文件,需要将该头文件移动至/usr/include目录下。相应地之前的test.c若要正常执行也需要将include “test_so.h”替换为include ,之后重新编译执行。

类似地编写setup.py:

#!/usr/bin/env python

importosimportsysfrom setuptools importsetup, find_packages

os.chdir(os.path.dirname(sys.argv[0])or ".")

setup(

name="cffi-test",

version="0.1",

packages=find_packages(),

install_requires=["cffi>=1.0.0"],

setup_requires=["cffi>=1.0.0"],

cffi_modules=["./cffi_test/build_test.py:ffi", #指定需要生成的ffi实例

],

)

在cffi_test文件夹下编写test.h:

//test.h//按照test_so.h声明需要使用的test链接库中的c函数

void add(int a, intb);void sub(int a, int b);

build_test.py:这里需要注意链接库的头文件以及所需调用的库的名称

#build_test.py

importosfrom cffi importFFI

ffi=FFI()

ffi.set_source("_test","#include ", #动态链接库libtest的头文件,在/usr/include文件下

#包含需要使用的库

libraries=["test"], #库的名称,按照之前所编写的则为test

)

with open(os.path.join(os.path.dirname(__file__), "test.h")) as f: #这里的test.h为当前目录下编写的需要引用的链接库中的函数的声明

ffi.cdef(f.read())if __name__ == "__main__":

ffi.compile()

test.py:

#test.py

from _test import ffi, lib #从产生的模块中引入ffi实例

lib.add(3,5)

lib.sub(5,3)

同样地,执行python setup.py build

python setup.py install 生成build等文件

39bffd23a89bda419cf1471b078f25a7.png

进入cffi_test目录,执行python build_test.py生成.c .o .so文件

afe922a57515ab2aa32a40548d57068e.png

最后执行python test.py即可实现对自定义函数库中函数的调用

c09882005d182320e98621883f1e6069.png

以上即可实现在Python中调用外部c函数

Logo

开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!

更多推荐