Python 调用 ctypes 详解

什么是 ctypes？

ctypes 是 Python 标准库中的一个模块，用于调用 C 兼容的共享库（如 Windows 的 .dll 或 Linux/macOS 的 .so 文件）。它允许你在不编写任何 C 扩展代码的情况下，直接从 Python 调用 C 函数。

这在需要高性能计算、访问操作系统底层功能或复用现有 C 库时非常有用。

基本使用步骤

1. 编写或获取一个 C 语言编写的动态链接库（例如 libmath.so 或 math.dll）。
2. 在 Python 中使用 ctypes.CDLL() 或 ctypes.WinDLL() 加载该库。
3. 定义函数的参数类型（argtypes）和返回类型（restype）。
4. 像普通函数一样调用 C 函数。

示例：调用自定义 C 函数

假设我们有一个 C 函数 add(int a, int b)，编译为 libmath.so（Linux）或 math.dll（Windows）：

// math.c
#include <stdio.h>

int add(int a, int b) {
    return a + b;
}
// 编译命令（Linux）: gcc -shared -fPIC -o libmath.so math.c
// 编译命令（Windows）: gcc -shared -o math.dll math.c

Python 调用代码如下：

# python_ctypes_example.py
import ctypes
import os

# 加载动态库（路径根据系统调整）
if os.name == 'nt':  # Windows
    lib = ctypes.CDLL('./math.dll')
else:                # Linux/macOS
    lib = ctypes.CDLL('./libmath.so')

# 设置函数签名
lib.add.argtypes = (ctypes.c_int, ctypes.c_int)
lib.add.restype = ctypes.c_int

# 调用函数
result = lib.add(3, 5)
print("3 + 5 =", result)  # 输出: 3 + 5 = 8

支持的数据类型

ctypes 提供了多种 C 类型的 Python 映射：

• ctypes.c_int → int
• ctypes.c_char_p → 字符串（bytes）
• ctypes.c_double → 浮点数
• ctypes.POINTER(ctypes.c_int) → 指针
• 结构体可通过继承 ctypes.Structure 定义

常见应用场景

• 调用系统 API（如 Windows API）
• 集成高性能数值计算库（如 BLAS、LAPACK）
• 硬件控制或嵌入式通信（通过驱动 DLL）
• 避免重写已有 C/C++ 代码

注意事项与最佳实践

• 务必设置 argtypes 和 restype，否则可能导致崩溃或错误结果。
• 注意内存管理：C 函数分配的内存需手动释放（若适用）。
• 跨平台时注意库文件命名差异（.dll vs .so vs .dylib）。
• 对于复杂接口，可考虑使用 cffi 或 Cython 替代。