【CXX】6 内置绑定

除了所有基本类型(如 i32 <=> int32_t),以下常见类型可以用于共享结构体的字段以及外部函数的参数和返回值。

Rust 中的名称 C++ 中的名称 限制条件
String rust::String
&str rust::Str
&T rust::Slice 不能包含不透明的 C++ 类型
&mut T rust::Slice 不能包含不透明的 C++ 类型
CxxString std::string 不能按值传递
Box rust::Box 不能包含不透明的 C++ 类型
UniquePtr std::unique_ptr 不能包含不透明的 Rust 类型
SharedPtr std::shared_ptr 不能包含不透明的 Rust 类型
T; N std::array<T, N> 不能包含不透明的 C++ 类型
Vec rust::Vec 不能包含不透明的 C++ 类型
CxxVector std::vector 不能按值传递,不能包含不透明的 Rust 类型
*mut T, *const T T*, const T* 带有裸指针参数的函数必须声明为 unsafe 才能调用
fn(T, U) -> V rust::Fn<V(T, U)> 目前仅支持从 Rust 传递到 C++
Result throw/catch 仅允许作为返回类型

C++ 中 rust 命名空间的 API 由 CXX GitHub 仓库中的 include/cxx.h 文件定义。在使用这些类型时,你需要在 C++ 代码中包含此头文件。当使用 Cargo 和 cxx-build crate 时,可以通过 #include "rust/cxx.h" 包含此头文件。

rust 命名空间还提供了表中所有类型的小写别名,适用于偏好这种风格的代码库。例如,rust::String 和 rust::Vec 也可以写成 rust::string 和 rust::vec 等。

待实现的绑定

以下类型计划在"不久的将来"支持,但目前尚未实现。这些类型的实现预计不会太困难,但需要为每种类型在其非原生语言中设计一个良好的 API。

Rust 中的名称 C++ 中的名称
BTreeMap<K, V> 待定
HashMap<K, V> 待定
Arc 待定
Option 待定
待定 std::map<K, V>
待定 std::unordered_map<K, V>
相关推荐
孙启超5 天前
【AI开发之Rust】第 11 课:智能指针与内部可变性
开发语言·后端·rust
慧都小项5 天前
当边缘AI上产线:QtitanDocking 如何让工业 HMI 实现多视图协同
人工智能·qt·ui·边缘计算·qt6.3
mikuyyds5 天前
geo-toolbox 水文插件算法解析:从 Muskingum 到 Muskingum-Cunge
算法·rust·gis
PC2005-cloud5 天前
Rust学习笔记:模块系统——mod、use、pub与多文件项目
rust
Amos_Web5 天前
Rspack 源码解析(十二):JavaScript Chunk 是如何被渲染出来的
前端·rust·源码
柯南46685 天前
【AI开发之Rust】第 14 课:网络请求与 JSON —— reqwest + serde
rust·编程语言
Quz5 天前
QML SwipeDelegate 滑动委托
qt
恋喵大鲤鱼5 天前
Rust 格式化输出占位符详解
rust
Quz5 天前
QML 列表中的四种委托:ItemDelegate、CheckDelegate、RadioDelegate、SwitchDelegate
qt