【CXX】6.6 UniquePtr<T> — std::unique_ptr<T>
std::unique_ptr 的 Rust 绑定称为 UniquePtr。有关 Rust API 的文档,请参见链接。
限制:
目前仅支持 std::unique_ptr<T, std::default_delete>。未来可能会支持自定义删除器。
UniquePtr 不支持 T 为不透明的 Rust 类型。对于在语言边界传递不透明 Rust 类型的所有权,应使用 Box(C++ 中的 rust::Box)。
示例:
UniquePtr 通常用于将不透明的 C++ 对象返回给 Rust。此用例在 blobstore 教程中有所体现。
// src/main.rs
#[cxx::bridge]
mod ffi {
unsafe extern "C++" {
include!("example/include/blobstore.h");
type BlobstoreClient;
fn new_blobstore_client() -> UniquePtr<BlobstoreClient>;
// ...
}
}
fn main() {
let client = ffi::new_blobstore_client();
// ...
}
// include/blobstore.h
#pragma once
#include <memory>
class BlobstoreClient;
std::unique_ptr<BlobstoreClient> new_blobstore_client();
// src/blobstore.cc
#include "example/include/blobstore.h"
std::unique_ptr<BlobstoreClient> new_blobstore_client() {
return std::make_unique<BlobstoreClient>();
}