予測可能な API

命名規則に従い、一般的なトレイトを実装することで、API を予測可能に保ちましょう。

// Copyright 2025 Google LLC
// SPDX-License-Identifier: Apache-2.0

/* これはどのトレイトを実装すべきでしょうか？ */
pub struct ApiToken(String);

impl ApiToken {
    // このメソッドは何と呼ぶべきでしょうか？
    pub unsafe fn ____(String) -> ApiToken;
}

  • 予測可能な API とは、名前、型、シグネチャといった表面的な詳細に基づいて、ユーザーが API の一部について推測できる API のことです。

  • ここでは、Rust における一般的な命名規則を見ていきます。これにより、ユーザーは自分のニーズに合うメソッドをすばやく探し、既存のコードもすばやく理解できるようになります。

  • また、型が実装する一般的なトレイトと、自分で定義する型に対してそれらをいつ実装すべきかも見ていきます。