当前位置：首页 > article >正文

【CXX】6.4 CxxString — std::string

article 2025/3/12 11:40:08

std::string 的 Rust 绑定称为 CxxString。有关 Rust API 的文档，请参见链接。

限制：

Rust 代码永远不能通过值获取 CxxString。C++ 的 string 需要一个移动构造函数，并且可能持有内部指针，这与 Rust 的移动行为不兼容。因此，在 Rust 代码中，我们只能通过引用或智能指针来查看 CxxString，例如 &CxxString、Pin<&mut CxxString> 或 UniquePtr。

为了在 Rust 中在栈上构造一个 CxxString，你必须使用 let_cxx_string! 宏，该宏会正确地固定字符串。下面的代码在一个地方使用了这个宏，链接中涵盖了其语法。

示例

这个示例使用 C++17 的 std::variant 来构建一个玩具 JSON 类型。JSON 可以包含各种类型，包括字符串，而 JSON 的对象类型是一个带有字符串键的映射。该示例演示了 Rust 如何索引到这些映射之一。

// src/main.rs

use cxx::let_cxx_string;

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

    #[cxx_name = "json"]
    type Json;
    #[cxx_name = "object"]
    type Object;

    fn isNull(self: &Json) -> bool;
    fn isNumber(self: &Json) -> bool;
    fn isString(self: &Json) -> bool;
    fn isArray(self: &Json) -> bool;
    fn isObject(self: &Json) -> bool;

    fn getNumber(self: &Json) -> f64;
    fn getString(self: &Json) -> &CxxString;
    fn getArray(self: &Json) -> &CxxVector<Json>;
    fn getObject(self: &Json) -> &Object;

    #[cxx_name = "at"]
    fn get<'a>(self: &'a Object, key: &CxxString) -> &'a Json;

    fn load_config() -> UniquePtr<Json>;
}
}

fn main() {
let config = ffi::load_config();

let_cxx_string!(key = "name");
println!("{}", config.getObject().get(&key).getString());
}

// include/json.h

#pragma once
#include <map>
#include <memory>
#include <string>
#include <variant>
#include <vector>

class json final {
public:
static const json null;
using number = double;
using string = std::string;
using array = std::vector<json>;
using object = std::map<string, json>;

json() noexcept = default;
json(const json &) = default;
json(json &&) = default;
template <typename... T>
json(T &&...value) : value(std::forward<T>(value)...) {}

bool isNull() const;
bool isNumber() const;
bool isString() const;
bool isArray() const;
bool isObject() const;

number getNumber() const;
const string &getString() const;
const array &getArray() const;
const object &getObject() const;

private:
std::variant<std::monostate, number, string, array, object> value;
};

using object = json::object;

std::unique_ptr<json> load_config();

// include/json.cc

#include "example/include/json.h"
#include <initializer_list>
#include <utility>

const json json::null{};
bool json::isNull() const { return std::holds_alternativestd::monostate(value); }
bool json::isNumber() const { return std::holds_alternative<number>(value); }
bool json::isString() const { return std::holds_alternative<string>(value); }
bool json::isArray() const { return std::holds_alternative<array>(value); }
bool json::isObject() const { return std::holds_alternative<object>(value); }
json::number json::getNumber() const { return std::get<number>(value); }
const json::string &json::getString() const { return std::get<string>(value); }
const json::array &json::getArray() const { return std::get<array>(value); }
const json::object &json::getObject() const { return std::get<object>(value); }

std::unique_ptr<json> load_config() {
return std::make_unique<json>(
std::in_place_typejson::object,
std::initializer_list<std::pair<const std::string, json>>{
{"name", "cxx-example"},
{"edition", 2021.},
{"repository", json::null}});
}