### Python 中通过 `ctypes` 和 `cffi` 调用 C 头文件 #### 使用 `ctypes` 尽管 `.h` 文件本身无法被直接加载到 Python 中，因为它们只是声明而不是实现部分。然而，如果有一个对应的 DLL 或共享库（`.so`），则可以通过 `ctypes` 来间接调用这些函数。 以下是具体操作流程： 1. **加载动态链接库** 动态链接库通常由头文件中的函数定义编译而成。使用 `ctypes.CDLL` 可以加载该库。 2. **定义参数类型和返回值类型** 需要显式告诉 Python 函数的输入参数以及返回值的数据类型。 3. **调用函数** 完成上述设置后可以直接调用目标函数。 下面是一个简单的例子[^3]： ```python import ctypes # 假设 sample.dll 是基于某个 .h 文件生成的动态库 libc = ctypes.cdll.LoadLibrary('sample.dll') # 如果 HelloWorld 接受两个字符串作为参数并返回浮点数，则需如下配置 libc.HelloWorld.argtypes = [ctypes.c_char_p, ctypes.c_char_p] libc.HelloWorld.restype = ctypes.c_double result = libc.HelloWorld(b"arg1", b"arg2") # 调用 dll 内部函数 print(result) ``` 需要注意的是，在实际应用中可能还需要处理更复杂的情况，例如传递数组、结构体或者回调函数等。此时可查阅官方文档获取进一步指导[^2]。 --- #### 使用 `cffi` 相比起 `ctypes` 的繁琐设定过程，`cffi` 提供了一种更加简洁的方式来绑定 C 库。它允许开发者直接嵌入 C 代码片段甚至整个头文件内容至脚本之中。 基本步骤包括以下几个方面： 1. **初始化接口对象** 创建一个 FFI 实例用于描述外部功能签名及其关联数据结构形式。 2. **解析源码或头文件** 将原始 C 源程序复制粘贴进来或将路径指向相应位置处已存在的预处理器输出结果。 3. **验证与执行** 编译完成后便可像平常一样访问所暴露出来的 API 成员变量啦！ 示例如下所示[^4]: ```python from cffi import FFI ffi = FFI() # 添加C头部信息 ffi.cdef(""" double add(double a, double b); """) # 加载.so/.dll文件 lib = ffi.dlopen("./example_lib.so") res = lib.add(5.0, 3.7) print(res) # 输出8.7 ``` 在这里，“add”是从某些地方获得的一个简单加法运算符；而 example_lib 则代表了我们之前提到过的那种包含了完整逻辑实现版本号等等额外元数据在内的二进制镜像制品。 --- 无论是采用哪种方式都需要确保本地环境中存在正确的依赖项并且正确安装好相应的开发工具链以便顺利完成最终构建工作。