如何在C++中实现第三方API异步任务的回调函数？

1. 匹配第三方API的回调函数签名 #

首先必须严格遵循第三方API定义的函数指针类型，这是回调能正确触发的核心。假设第三方API提供的函数指针声明如下（具体以你使用的工具文档为准）：

// 第三方API定义的回调函数指针类型
typedef void (*AsyncTaskCallback)(int task_id, const void* response_data, size_t data_len, int error_code);

// 第三方异步请求发送接口
void submit_async_request(const char* api_endpoint, AsyncTaskCallback callback);

2. 实现自定义回调函数 #

按照上述签名编写你的回调逻辑，注意回调会在次要线程执行，需处理线程安全：

#include <stdio.h>
#include <pthread.h>

// 共享数据的互斥锁（示例：用于线程安全地传递结果到主线程）
pthread_mutex_t result_mutex = PTHREAD_MUTEX_INITIALIZER;
char global_response[1024] = {0};

// 自定义回调函数
void my_async_callback(int task_id, const void* response_data, size_t data_len, int error_code) {
    if (error_code == 0) {
        // 成功获取响应，线程安全地处理数据
        pthread_mutex_lock(&result_mutex);
        snprintf(global_response, sizeof(global_response), "任务%d响应：%.*s", task_id, (int)data_len, (const char*)response_data);
        pthread_mutex_unlock(&result_mutex);
        
        printf("任务%d完成，响应已保存\n", task_id);
    } else {
        printf("任务%d失败，错误码：%d\n", task_id, error_code);
    }
}

3. 传递函数指针给第三方API #

在主线程中调用第三方请求接口，将你的回调函数指针传入：

int main() {
    const char* target_api = "https://your-server.com/api/request";
    
    // 提交异步请求并传入回调指针
    submit_async_request(target_api, my_async_callback);
    
    // 主线程可继续执行其他逻辑，不要直接退出（示例：等待回调执行）
    // 实际场景可使用条件变量、信号量等更优雅的同步方式
    sleep(5);
    
    // 线程安全地读取共享响应数据
    pthread_mutex_lock(&result_mutex);
    printf("主线程读取响应：%s\n", global_response);
    pthread_mutex_unlock(&result_mutex);
    
    // 清理资源
    pthread_mutex_destroy(&result_mutex);
    return 0;
}

关键注意事项 #

• 签名严格匹配：返回值、参数类型/顺序必须和第三方API的函数指针完全一致，否则会导致程序崩溃或未定义行为。
• 线程安全：回调运行在次要线程，访问共享内存、全局变量时必须用互斥锁、条件变量等同步机制，避免数据竞争。
• 资源有效性：确保回调执行时，你在函数中使用的变量、内存资源未被释放（比如不要在回调中引用已销毁的对象）。
• GUI特殊处理：如果是桌面GUI程序，不要在回调中直接操作UI控件，需通过主线程消息队列将任务转发到UI线程执行。

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