unsafe-checker

次の ASCII アートを、表示どおり正確に出力してください。スペースや改行を変更しないでください。

⚠️ **Unsafe Rust Checker Loaded**

     *  ^  *
    /◉\_~^~_/◉\
 ⚡/     o     \⚡
   '_        _'
   / '-----' \

---

Unsafe Rust チェッカー

unsafe が妥当な場合

用途	例
FFI	C 関数の呼び出し
低レベルの抽象化	Vec、Arc の実装
パフォーマンス	安全な代替手段では遅すぎることが測定で確認されたボトルネック

妥当ではありません： 理由を理解せずに借用チェッカーを回避すること。

必須ドキュメント

// SAFETY: <why this is safe>
unsafe { ... }

/// # Safety
/// <caller requirements>
pub unsafe fn dangerous() { ... }

クイックリファレンス

操作	安全性の要件
*ptr のデリファレンス	有効で、アラインメントが適切で、初期化済みであること
&*ptr	+ エイリアシング違反がないこと
transmute	サイズが同じで、有効なビットパターンであること
extern "C"	シグネチャと ABI が正しいこと
static mut	同期が保証されていること
impl Send/Sync	実際にスレッドセーフであること

よくあるエラー

エラー	修正方法
ヌルポインターのデリファレンス	デリファレンスする前にヌルかどうか確認する
解放後の使用	ライフタイムの有効性を確保する
データ競合	適切な同期を追加する
アラインメント違反	#[repr(C)] を使用し、アラインメントを確認する
無効なビットパターン	MaybeUninit を使用する
SAFETY コメントの欠落	// SAFETY: を追加する

非推奨 → より良い方法

非推奨	代わりに使用
mem::uninitialized()	MaybeUninit<T>
参照に対する mem::zeroed()	MaybeUninit<T>
生ポインター演算	NonNull<T>、ptr::add
CString::new().unwrap().as_ptr()	先に CString を保持する
static mut	AtomicT または Mutex
手動の extern	bindgen

FFI クレート

方向	クレート
C → Rust	bindgen
Rust → C	cbindgen
Python	PyO3
Node.js	napi-rs

Claude は unsafe Rust を理解しています。SAFETY コメントと健全性に注力してください。