如何用Cython实现可被C调用的可变参数函数以适配retro_log_printf_t？

我正在编写一个Python库libretro.py，用来测试实现特定C API的DLL，这个库还会通过运行时获取的回调函数向原生DLL暴露功能。现在需要实现一个特定函数，其C声明如下：

enum retro_log_level; // 为简洁起见省略定义

// 类似printf的函数类型定义
typedef void (RETRO_CALLCONV *retro_log_printf_t)(enum retro_log_level level, const char *fmt, ...);

struct retro_log_callback
{
   // 在Python中定义，由C调用
   retro_log_printf_t log;
};

问题在于retro_log_printf_t是可变参数函数，而ctypes无法实现这类函数作为回调。我没法修改这个API，所以想通过Cython实现一个兼容的函数来绕过这个限制。

我的问题是：如何用Cython声明并实现一个可被C调用、且与上述retro_log_printf_t兼容的可变参数函数？

步骤1：声明C类型与函数原型 #

先在Cython文件中对齐原C API的类型定义，确保调用约定、类型匹配：

cdef extern from "retro_api.h":
    # 根据实际API补充枚举值
    ctypedef enum retro_log_level:
        RETRO_LOG_DEBUG,
        RETRO_LOG_INFO,
        RETRO_LOG_WARN,
        RETRO_LOG_ERROR

    # 匹配原API的调用约定（RETRO_CALLCONV通常为__cdecl/__stdcall，按需调整）
    ctypedef void (*retro_log_printf_t)(retro_log_level level, const char *fmt, ...) nogil

    ctypedef struct retro_log_callback:
        retro_log_printf_t log

# 导入C标准库的可变参数处理工具
cdef extern from "stdarg.h":
    ctypedef void* va_list
    void va_start(va_list ap, const char *fmt)
    int vsnprintf(char *str, size_t size, const char *format, va_list ap)
    void va_end(va_list ap)

步骤2：实现可变参数回调函数 #

用Cython编写C风格的可变参数函数，通过va_list处理参数，再转发到Python侧的日志逻辑：

# 存储Python侧的日志回调对象
cdef object py_log_handler

# 实现符合retro_log_printf_t类型的C回调函数
cdef void retro_log_callback_impl(retro_log_level level, const char *fmt, ...) nogil:
    cdef va_list args
    cdef char log_buf[4096]  # 按需调整缓冲区大小
    cdef int buf_len

    # 初始化并格式化可变参数到缓冲区
    va_start(args, fmt)
    buf_len = vsnprintf(log_buf, sizeof(log_buf), fmt, args)
    va_end(args)

    # 切换回Python GIL环境，调用Python侧处理逻辑
    with gil:
        # 转换C类型到Python类型
        py_level = level
        py_msg = log_buf.decode('utf-8', errors='replace')
        py_log_handler(py_level, py_msg)

步骤3：导出回调函数并关联到结构体 #

将实现的函数指针暴露给C，同时提供Python侧的配置入口：

# 导出函数指针，供C代码调用
cdef public retro_log_printf_t get_retro_log_callback():
    return &retro_log_callback_impl

# Python层API：设置自定义的日志处理函数
def set_python_log_handler(callback):
    global py_log_handler
    py_log_handler = callback

步骤4：集成到Python库 #

1. 将Cython文件编译为Python扩展模块
2. 在libretro.py中导入该模块，调用set_python_log_handler传入你的Python日志处理函数
3. 获取get_retro_log_callback()返回的函数指针，填充到retro_log_callback结构体后传递给原生DLL

关键注意事项 #

• 调用约定必须和原API完全一致，否则会导致栈溢出或崩溃
• 缓冲区大小需根据实际日志场景调整，避免日志截断
• 回调可能在非Python线程触发，必须通过nogil和with gil正确切换线程环境
• 转换C字符串到Python字符串时，需指定正确的编码格式，避免乱码

内容的提问来源于stack exchange，提问作者JesseTG