使用CXX进行Rust和C++的安全互操作

使用CXX进行Rust和C++的安全互操作

引用

搜狐

1.

https://m.sohu.com/a/790117851_121934862/?pvid=000115_3w_a

CXX是一个提供Rust和C++之间安全调用机制的库，能够避免使用bindgen或cbindgen生成不安全的C风格绑定时可能出现的各种问题。本文将展示如何配置和使用CXX库，探讨其主要特性，并提供一些示例代码。

CXX简介

CXX库提供了一种机制，可以从Rust调用C++代码，也可以从C++调用Rust代码。我们通过在一个Rust模块中定义两边的FFI边界，然后CXX进行静态分析，确保类型和函数签名的正确性。CXX会生成相应的extern "C"签名，来保证在构建过程中验证无误。生成的FFI桥接在运行时几乎没有开销，不会涉及复制、序列化、内存分配或运行时检查。

安装与配置

首先，我们需要在Rust项目的Cargo.toml文件中添加CXX库作为依赖项：

[dependencies]
cxx = "1.0"

[build-dependencies]
cxx-build = "1.0"

接下来，我们需要在项目的build.rs文件中配置CXX库。这个文件是Rust项目的构建脚本，用于在编译前执行一些预处理任务。在build.rs中，我们需要使用cxx_build模块来配置C++编译器和链接器。以下是一个简单的示例：

fn main() {
    println!("cargo:rerun-if-changed=src/cpp/hello.cpp");
    cc::Build::new()
        .cpp(true)
        .file("src/cpp/hello.cpp")
        .compile("hello");
}

在这个示例中，我们告诉CXX库在构建时重新检查src/cpp/hello.cpp文件的更改，并使用C++编译器编译这个文件。编译后的库将被命名为hello。

使用CXX

在Rust代码中使用CXX库，我们首先需要在Rust模块中定义FFI边界。这通常涉及到使用unsafe块和extern "C"声明。以下是一个简单的示例：

#[cxx::bridge]
mod ffi {
    unsafe extern "C++" {
        include!("hello.h");

        fn hello(name: &str) -> String;
    }
}

在这个示例中，我们定义了一个名为ffi的模块，其中包含了一个unsafe extern "C++"块。这个块包含了C++代码的头文件引用和函数声明。CXX库会根据这些声明生成相应的FFI桥接代码。

在C++代码中，我们需要实现这些声明的函数。以下是一个简单的示例：

#include <string>
#include <cxx/string>

std::string hello(const std::string& name) {
    return "Hello, " + name;
}

在这个示例中，我们实现了hello函数，它接受一个字符串参数并返回一个包含问候语的字符串。

总结

CXX库提供了一种安全且高效的方式来实现Rust和C++之间的互操作。通过使用CXX库，我们可以避免使用C风格绑定时可能出现的各种问题，同时保持高性能和类型安全性。对于需要在Rust和C++之间共享代码和数据的项目来说，CXX库是一个非常有价值的工具。