如何在C结构体中存储C++对象？适配跨语言C API场景

核心思路是在C结构体中添加一个不透明指针字段，用来指向关联的C对象。这种方式既保证C结构体的兼容性，又能将C与C数据绑定在一起，同时客户端无需进行复杂的指针运算。

具体实现步骤 #

1. 修改C结构体定义 #

在SomeCStruct中新增void*类型的不透明字段，客户端无需关心其内部指向的内容：

struct SomeCStruct {
    int i;
    bool b;
    // 不透明指针，仅C++侧维护其指向的C++对象
    void* __cpp_associated_data;
};

2. C++侧管理关联对象的生命周期 #

通过C API提供创建、销毁接口，在C实现中完成C对象的分配与绑定：

C API声明（对外暴露）

// 创建单个SomeCStruct实例，关联指定字符串
SomeCStruct* create_some_c_struct(int i, bool b, const char* initial_str);
// 销毁单个实例，释放关联的C++对象
void destroy_some_c_struct(SomeCStruct* obj);
// 创建SomeCStruct数组
SomeCStruct** create_some_c_struct_array(size_t count, const int* int_vals, const bool* bool_vals, const char** str_vals);
// 销毁数组及所有元素
void destroy_some_c_struct_array(SomeCStruct** array, size_t count);

C++侧实现

#include <string>
#include <cstring>

SomeCStruct* create_some_c_struct(int i, bool b, const char* initial_str) {
    SomeCStruct* c_obj = new SomeCStruct;
    c_obj->i = i;
    c_obj->b = b;
    // 将C++对象的指针存入不透明字段
    c_obj->__cpp_associated_data = new std::string(initial_str ? initial_str : "");
    return c_obj;
}

void destroy_some_c_struct(SomeCStruct* obj) {
    if (!obj) return;
    // 转换回原C++类型并销毁
    delete static_cast<std::string*>(obj->__cpp_associated_data);
    delete obj;
}

SomeCStruct** create_some_c_struct_array(size_t count, const int* int_vals, const bool* bool_vals, const char** str_vals) {
    SomeCStruct** array = new SomeCStruct*[count];
    for (size_t idx = 0; idx < count; ++idx) {
        array[idx] = create_some_c_struct(
            int_vals[idx],
            bool_vals[idx],
            str_vals ? str_vals[idx] : ""
        );
    }
    return array;
}

void destroy_some_c_struct_array(SomeCStruct** array, size_t count) {
    if (!array) return;
    for (size_t idx = 0; idx < count; ++idx) {
        destroy_some_c_struct(array[idx]);
    }
    delete[] array;
}

3. 客户端使用方式 #

客户端可以直接通过数组下标访问元素，无需指针运算：

// 示例：创建并使用数组
size_t count = 3;
int ints[] = {1, 2, 3};
bool bools[] = {true, false, true};
const char* strs[] = {"foo", "bar", "baz"};

SomeCStruct** array = create_some_c_struct_array(count, ints, bools, strs);
// 直接通过下标访问
printf("Element 0: i=%d, b=%d\n", array[0]->i, array[0]->b);
printf("Element 1: i=%d, b=%d\n", array[1]->i, array[1]->b);

// 用完销毁
destroy_some_c_struct_array(array, count);

方案优势 #

• C兼容性：结构体完全符合C标准，客户端无需处理C++相关逻辑
• 平台独立性：不依赖任何C++类型的大小或对齐规则，void*在所有平台均为标准类型
• 数据绑定：C与C++数据逻辑上绑定在一起，无需拆分数组
• 实现隐藏：客户端无法直接访问C++对象，保证封装性

为何不推荐你之前的char数组方案 #

直接用char __associatedData[N]存储C++对象的问题在于：

• 平台依赖：std::string的大小在32位/64位编译器、不同STL实现中差异很大（比如32位下可能是4字节，64位下是8字节）
• 对齐问题：C++对象可能要求特定的内存对齐（比如std::string通常要求8字节对齐），而char数组的对齐无法保证，会导致未定义行为
• 可维护性：一旦更换C++关联类型，需要重新调整数组大小，扩展性差

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