Go语言通过Cgo调用C变参函数：策略与实践

// #include <curl/curl.h> // 假设需要包含curl库头文件
// #include <stdlib.h> // For malloc/free if needed within the wrapper

// my_setopt_wrapper.h
void my_setopt_wrapper(CURL *curl, CURLoption *options_list, int num_options);

// my_setopt_wrapper.c
#include "my_setopt_wrapper.h"

// 注意：此包装函数仅演示如何接收和处理CURLoption数组。
// curl_easy_setopt的变参通常是每个选项的特定值，而非仅选项本身。
// 实际应用中，此包装函数需要更复杂的逻辑来解析Go传递过来的选项及其对应的值。
void my_setopt_wrapper(CURL *curl, CURLoption *options_list, int num_options) {
    for (int i = 0; i < num_options; ++i) {
        // 这是一个简化的示例，假设CURLoption可以直接作为curl_easy_setopt的变参
        // 在实际的curl_easy_setopt调用中，每个CURLoption后面还需要一个对应的值。
        // 例如：curl_easy_setopt(curl, options_list[i], value_for_this_option);
        // 因此，一个更完善的包装函数需要Go传递选项和值对。
        // 为了与原始问答中的Go代码示例保持一致，此处仅展示如何处理CURLoption数组。
        // curl_easy_setopt(curl, options_list[i], /* 缺失的对应值 */);
    }
}

package mycurl

// #cgo LDFLAGS: -lcurl
// #include <curl/curl.h>
// #include <stdlib.h> // For malloc/free

// // my_setopt_wrapper.h
// void my_setopt_wrapper(CURL *curl, CURLoption *options_list, int num_options);
import "C"
import (
    "unsafe"
)

// Option 是 C.CURLoption 的 Go 语言别名，用于公共 API
type Option C.CURLoption

// Easy 结构体，持有CURL句柄和错误码
type Easy struct {
    curl unsafe.Pointer // 对应 C.CURL *
    code C.CURLcode
}

func (e *Easy) SetOption(options ...Option) {
    if len(options) == 0 {
        return // 没有选项，无需继续
    }

    // 计算单个 Option 结构体在内存中的大小
    // unsafe.Sizeof 返回类型或变量在内存中的字节大小
    size := int(unsafe.Sizeof(options[0]))

    // 在C堆上分配内存，用于存储 Go 切片中的 Option 元素
    // C.malloc 返回一个 C.void 类型的指针，需要强制转换为 unsafe.Pointer
    list := C.malloc(C.size_t(size * len(options)))

    // 使用 defer 确保在函数返回时释放C语言分配的内存
    // 这是 Go 语言中管理 C 内存的关键实践，防止内存泄漏
    defer C.free(unsafe.Pointer(list))

    // 遍历 Go 切片，将每个 Option 元素复制到 C 语言分配的内存中
    for i := range options {
        // 计算当前元素在 C 内存块中的偏移地址
        // uintptr(list) 将 C 指针转换为 Go 的 uintptr 类型，以便进行指针算术
        // uintptr(size * i) 计算当前元素的偏移量
        // unsafe.Pointer() 将计算后的 uintptr 转换回 unsafe.Pointer
        ptr := unsafe.Pointer(uintptr(list) + uintptr(size*i))

        // 将 Go 切片中的 Option 值复制到 C 内存中的对应位置
        // *(*C.CURLoption)(ptr) 将 unsafe.Pointer 强制转换为 C.CURLoption 类型的指针，然后解引用赋值
        *(*C.CURLoption)(ptr) = C.CURLoption(options[i])
    }

    // 调用C语言包装函数，传递CURL句柄、C语言数组指针和数组长度
    // C.int(len(options)) 将 Go 的 int 类型长度转换为 C 的 int 类型
    e.code = C.my_setopt_wrapper(e.curl, (*C.CURLoption)(list), C.int(len(options)))
}