Cpp2Rust: C++を安全なRustへ自動翻訳
Cpp2Rust: Translates C++ to safe Rust automatically (github.com)
要約
Cpp2Rustは、C++コードを完全に安全なRustコードへ自動的に変換するツールです。Clangの抽象構文木(AST)に基づいた構文駆動型のトランスレーターであり、安全なRustコードを生成します。参照カウントモデルがデフォルトで使用され、必要に応じてランタイムライブラリ(libcc2rs)が利用されます。
全文翻訳
Cpp2Rust
Cpp2Rustは、C++コードを完全に安全なRustコードに自動翻訳します。これはclangのASTを基盤とした構文駆動型のトランスレーターです。
Cpp2Rustのアルゴリズムは、PLDI 2026で発表された論文「Cpp2Rust: Automatic Translation of C++ to Safe Rust」で説明されています。
開発者マニュアルでは、Cpp2Rustが内部でどのように動作するか、またどのように拡張できるかが説明されています。
概要
Cpp2Rustはまず、clangを使用して入力C++ファイルをパースし、ASTを生成します。次にASTをトラバースし、必要に応じて(例えば、生のポインタセマンティクスの場合に)libcc2rsランタイムライブラリへの呼び出しを挿入しながら、Rustコードを文字列として出力します。最後に、生成されたRustコードはrustfmtを使用して単一の.rsファイルに整形されます。
デフォルトでは参照カウントモデルが使用され、完全に安全なRustが生成されます。デバッグやパフォーマンス比較のために、--model=unsafeコマンドライン引数を通じて非安全なRustのジェネレーターも利用可能です。
ランタイムライブラリ (libcc2rs)
生成されるコードは、翻訳プロセスを簡略化するために設計されたランタイムライブラリに依存します。Cのポインタはlibcc2rsが提供するPtr<T>型に変換されます。Ptr<T>は、null、算術演算、エイリアシングを含むCポインタのセマンティクスをモデル化しつつ、チェックされた実行時操作を通じてRustの借用チェッカーを満たします。
要件
Ubuntuでは、以下のコマンドで必要な依存関係をインストールします。
sudo apt install libclang-23-dev clang++-23 ninja-build cmake
pip install ruff==0.15.22
ビルド
mkdir build
cd build
cmake -GNinja ..
ninja
ninja check
実行
単一ファイルの翻訳
./build/cpp2rust/cpp2rust --file=<file>.cpp -o=<file>.rs
デフォルトでは参照カウントモデルが使用され(完全な安全な出力)、非安全なRustを生成するには次のようにします。
./build/cpp2rust/cpp2rust --file=<file>.cpp -o=<file>.rs --model=unsafe
最小限の例。 hello.cppの場合:
#include <cstdio>
int main() {
printf("hello world\n");
return 0;
}
./build/cpp2rust/cpp2rust --file=hello.cpp -o=hello.rsを実行すると、以下が生成されます。
pub fn main() {
std::process::exit(main_0());
}
fn main_0() -> i32 {
println!("hello world");
return 0;
}
以下でコンパイルして実行します。
rustc hello.rs -L build/libcc2rs-target/release
./hello
プログラム全体の翻訳
まず、プロジェクトのcompile_commands.jsonを生成します。CMakeを使用している場合は、追加で1つのフラグを設定します。
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..
次に実行します。
./build/cpp2rust/cpp2rust --dir=<dir> -o <output>.rs
<dir>はcompile_commands.jsonを含むディレクトリである必要があります。
テストスイート
# 全てのテストを実行
ninja check
# 単体テストのみを実行
ninja check-unit
# libcc2rsの単体テストを実行
ninja check-libcc2rs
# libcc2rs-macrosの単体テストを実行
ninja check-libcc2rs-macros
# 意図的な変更後に単体テストの期待される出力を再生成
REPLACE_EXPECTED=1 ninja check-unit