7.3.1 错误处理：QR 示例

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/interoperability-with-cpp/error-handling-qr.html

7.3.1 错误处理：QR 示例

QR 码生成器是一个示例：用布尔值传达成功与失败，且成功结果可以跨 FFI 边界传递：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


// Copyright 2023 Google LLC
// SPDX-License-Identifier: Apache-2.0
#[cxx::bridge(namespace = "qr_code_generator")]
mod ffi {
 extern "Rust" {
 fn generate_qr_code_using_rust(
 data: &[u8],
 min_version: i16,
 out_pixels: Pin<&mut CxxVector<u8>>,
 out_qr_size: &mut usize,
 ) -> bool;
 }
}

学员可能对 out_qr_size 输出的语义感到好奇。这不是向量的大小，而是 QR 码的大小（而且老实说有点多余——它是向量大小的平方根）。

7.3.2 错误处理：PNG 示例

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/interoperability-with-cpp/error-handling-png.html

7.3.2 错误处理：PNG 示例

PNG 解码器原型说明了当成功结果不能跨 FFI 边界传递时可以怎么做：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


// Copyright 2023 Google LLC
// SPDX-License-Identifier: Apache-2.0
#[cxx::bridge(namespace = "gfx::rust_bindings")]
mod ffi {
 extern "Rust" {
 /// 这返回 `Result<PngReader<'a>, ()>` 的 FFI 友好等价物。
 fn new_png_reader<'a>(input: &'a [u8]) -> Box<ResultOfPngReader<'a>>;

 /// `crate::png::ResultOfPngReader` 类型的 C++ 绑定。
 type ResultOfPngReader<'a>;
 fn is_err(self: &ResultOfPngReader) -> bool;
 fn unwrap_as_mut<'a, 'b>(
 self: &'b mut ResultOfPngReader<'a>,
 ) -> &'b mut PngReader<'a>;

 /// `crate::png::PngReader` 类型的 C++ 绑定。
 type PngReader<'a>;
 fn height(self: &PngReader) -> u32;
 fn width(self: &PngReader) -> u32;
 fn read_rgba8(self: &mut PngReader, output: &mut [u8]) -> bool;
 }
}

PngReader 与 ResultOfPngReader 是 Rust 类型——这些类型的对象若不经 Box<T> 间接就不能跨 FFI 边界。我们不能有 out_parameter: &mut PngReader，因为 CXX 不允许 C++ 按值存储 Rust 对象。

7.3 CXX 错误处理 on 编程那些事儿

7.3.1 错误处理：QR 示例

7.3.1 错误处理：QR 示例

7.3.2 错误处理：PNG 示例

7.3.2 错误处理：PNG 示例