以指向std::vector的二级指针作为API输出参数是否为最佳实践？

针对你用二级指针作为std::vector输出参数的场景，有几种更简洁安全的替代方案，既满足函数返回状态码的要求，又避免二级指针的繁琐：

方案1：使用一级指针的引用 #

直接传递指针的引用替代二级指针，减少指针层级，简化调用逻辑：

// 函数签名修改为
Status Interface::method(const std::vector<int>*& outVec);

// 函数实现
Status Interface::method(const std::vector<int>*& outVec) {
    outVec = nullptr; // 初始化避免野指针
    try {
        auto new_vec = new std::vector<int>();
        // 填充vector数据逻辑，例如：
        new_vec->push_back(42);
        new_vec->push_back(100);
        
        outVec = new_vec;
        return Status::OK;
    } catch (const std::bad_alloc&) {
        return Status::MEMORY_ERROR;
    }
}

// 用户调用示例
const std::vector<int>* result = nullptr;
Status status = interface_instance.method(result);
if (status == Status::OK) {
    // 使用result指向的vector
    delete result; // 注意手动释放内存，避免泄漏
}

方案2：使用std::unique_ptr作为输出参数（推荐） #

利用智能指针自动管理内存，无需用户手动delete，大幅降低内存泄漏风险：

// 函数签名修改为
Status Interface::method(std::unique_ptr<const std::vector<int>>& outVec);

// 函数实现
Status Interface::method(std::unique_ptr<const std::vector<int>>& outVec) {
    outVec.reset(); // 重置原有指针
    try {
        auto new_vec = std::make_unique<std::vector<int>>();
        // 填充数据
        new_vec->insert(new_vec->end(), {1, 2, 3});
        
        outVec = std::move(new_vec); // 转移所有权
        return Status::OK;
    } catch (const std::bad_alloc&) {
        return Status::MEMORY_ERROR;
    }
}

// 用户调用示例
std::unique_ptr<const std::vector<int>> result;
Status status = interface_instance.method(result);
if (status == Status::OK) {
    // 使用result，无需手动释放内存
}

方案3：返回状态码与结果的组合（最优雅） #

如果团队允许修改函数返回值形式，直接返回std::pair（或自定义结构体）打包状态码和智能指针，完全消除输出参数：

// 函数签名修改为
std::pair<Status, std::unique_ptr<const std::vector<int>>> Interface::method();

// 函数实现
std::pair<Status, std::unique_ptr<const std::vector<int>>> Interface::method() {
    try {
        auto new_vec = std::make_unique<std::vector<int>>();
        // 填充数据逻辑
        new_vec->push_back(7);
        
        return {Status::OK, std::move(new_vec)};
    } catch (const std::bad_alloc&) {
        return {Status::MEMORY_ERROR, nullptr};
    }
}

// 用户调用示例（C++17+结构化绑定）
auto [status, result] = interface_instance.method();
if (status == Status::OK && result) {
    // 使用result
}

方案选择建议 #

• 若必须保留输出参数形式，优先选方案2，兼顾简洁性与内存安全性；
• 若可以修改返回值，方案3是最符合现代C++风格的实现，语义清晰且代码最简洁；
• 方案1仅作为二级指针的轻量化替代，仍需手动管理内存，仅在无法使用智能指针的场景下考虑。

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