安全な Rust アプリケーション開発の指針命名
命名
Rust では、標準ライブラリが命名規約の事実上の標準となっている。 この規約を明文化する取り組みは、RFC 43 で行われ、のちに Rust API Guidelines でも行われた。
基本規則 (C-CASE) は、次のものを使うことである。
- 型、トレイト、列挙型のバリアント、ジェネリック型パラメータには
UpperCamelCase - 関数、メソッド、マクロ、変数、モジュールには
snake_case - 静的変数、定数、ジェネリック定数パラメータには
SCREAMING_SNAKE_CASE - ライフタイムには
'lowercase
Rust API Guidelines は、特定の構文について、さらに細かい命名規約も 定めている。
- 変換メソッド(
as_、to_、into_)については(C-CONV) - ゲッターについては
(C-GETTER) - イテレータを生成するメソッドについては
(C-ITER) - イテレータ型については
(C-ITER-TY) - フィーチャ(条件付きで有効になる機能)の命名については
(C-FEATURE) - 語順の一貫性については
(C-WORD-ORDER)
基本規則 (C-CASE) は、コンパイラが(nonstandard_style のリント群によって)検査する。
コンパイラに加えて、clippy ツールも、style カテゴリのリントによって命名規約の採用を助けることができる。
たとえば、wrong_self_convention リントは、(C-CONV) に従って、変換メソッドの名前とそのレシーバの型(self、&self、&mut self)との整合性を検査する。
安全なアプリケーションの開発は、Rust API Guidelines に示されている 命名規約に従わなければならない。