C++跨平台库/SDK设计：内存、列表传递与闭包回调问题

问题1：替代std::unique_ptr关联内部类的安全方案 #

用**不透明指针（Opaque Pointer）**完全隔离内部实现与外部STL依赖，既保留内部自动内存管理，又规避跨版本STL兼容问题：

1. 对外头文件仅声明不完整类型：

// 仅声明句柄，不暴露内部结构
struct InternalFuncHandle;

// 对外提供生命周期管理接口
InternalFuncHandle* CreateInternalFunc();
void DestroyInternalFunc(InternalFuncHandle* handle);

// 对外业务接口，通过句柄操作内部逻辑
void DoSomethingWithInternal(InternalFuncHandle* handle);

2. 内部实现中定义完整结构：

#include "InternalFunctionality.h"
#include <memory>

struct InternalFuncHandle {
    std::unique_ptr<InternalFunctionality> impl;
};

InternalFuncHandle* CreateInternalFunc() {
    return new InternalFuncHandle{std::make_unique<InternalFunctionality>()};
}

void DestroyInternalFunc(InternalFuncHandle* handle) {
    delete handle;
}

void DoSomethingWithInternal(InternalFuncHandle* handle) {
    handle->impl->DoWork();
}

该方式无需实现复杂的拷贝/移动构造，外部仅接触纯C风格的指针接口，彻底消除STL兼容风险。

问题2：无拷贝传递列表数据的高效方案 #

结合跨DLL STL兼容限制，分场景提供无拷贝方案：

方案1：传递原始指针与长度（只读临时场景） #

若内部仅需临时读取用户侧数据，直接传递std::vector的底层指针和大小，完全无拷贝：

// 对外接口
void ProcessRawData(const int* data, size_t count);

// 用户侧调用
std::vector<int> user_data = {1,2,3,4};
ProcessRawData(user_data.data(), user_data.size());

注意：需确保用户侧数据在接口执行期间保持有效，内部不持有指针。

方案2：库侧提供容器句柄（持久持有场景） #

若内部需要长期持有数据，对外暴露自定义容器句柄，内部用std::vector实现：

// 对外头文件
struct DataListHandle;

DataListHandle* CreateDataList();
void AddToList(DataListHandle* list, int value);
int GetFromList(DataListHandle* list, size_t index);
size_t GetListSize(DataListHandle* list);
void DestroyDataList(DataListHandle* list);

// 内部实现
struct DataListHandle {
    std::vector<int> data;
};

// 对应实现Create/Add/Get/Destroy逻辑

用户侧通过库提供的接口操作数据，完全规避跨STL容器的兼容问题，且无额外拷贝。

问题3：虚基类回调方案的可行性分析 #

你给出的虚基类回调方案仅在DLL与用户侧使用完全相同的编译器、编译选项及STL版本时可行，跨环境场景下存在严重风险：

• 不同编译器的虚函数表布局可能不一致，导致调用回调时崩溃；
• 若用户侧继承CallBack1并在自己的代码中销毁对象，跨DLL的析构函数实现不兼容会引发内存泄漏或崩溃。

更安全的替代方案：C风格回调+上下文指针
完全规避虚函数依赖，兼容所有编译环境：

// 对外头文件
typedef void (*CallbackFunc)(void* context);

void RegisterCallback(CallbackFunc func, void* context);

// 用户侧使用示例
#include <string>

struct MyCallbackContext {
    int id;
    std::string msg;
};

void MyCallbackImpl(void* context) {
    MyCallbackContext* ctx = static_cast<MyCallbackContext*>(context);
    // 处理回调逻辑：使用ctx->id、ctx->msg
}

// 注册回调
MyCallbackContext* ctx = new MyCallbackContext{100, "callback triggered"};
RegisterCallback(MyCallbackImpl, ctx);

用户侧可将需要捕获的变量封装到上下文结构体中，通过void*传递，既实现闭包效果，又保证跨DLL兼容性。

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