【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>
相关推荐
EutoCool27 分钟前
Qt:布局管理器Layout
开发语言·c++·windows·嵌入式硬件·qt·前端框架
寻月隐君2 小时前
想用 Rust 开发游戏?这份超详细的入门教程请收好!
后端·rust·github
LuckyLay5 小时前
使用 Docker 搭建 Rust Web 应用开发环境——AI教你学Docker
前端·docker·rust
SoniaChen335 小时前
Rust基础-part3-函数
开发语言·后端·rust
真的想上岸啊6 小时前
学习C++、QT---21(QT中QFile库的QFile读取文件、写入文件的讲解)
c++·qt·学习
醇醛酸醚酮酯8 小时前
Qt项目锻炼——TODO(五)
开发语言·qt
mit6.8249 小时前
论容器化 | 分析Go和Rust做医疗的后端服务
docker·golang·rust
Source.Liu13 小时前
【unitrix】 4.21 类型级二进制数基本结构体(types.rs)
rust
SoniaChen3314 小时前
Rust基础-part2-变量和可变类型
开发语言·后端·rust
寻月隐君14 小时前
Rust 错误处理终极指南:从 panic! 到 Result 的优雅之道
后端·rust·github