15. 関連関数 — ::new とコンストラクタ

impl ブロックには self を取らない関数も書けます。これを関連関数と呼び、Circle::new(3.5) のように「型名::関数名」で呼び出します。String::from もこの形です。

もっともよく使うのはインスタンスを作る new で、Rust にはコンストラクタ構文がない代わりにこの慣習があります。初期化のロジックを new に集めておけば、フィールドの構成が変わっても呼び出し側の修正を最小限にできます。

戻り値の型は Self と書くと「この impl の対象の型」を指せます。型名を繰り返さずに済むので、new の戻り値は -> Self と書くのが定番です。

▶ サンプルコードを実行してみよう(自由に書き換えてOK)

Rust

struct Circle {
    radius: f64,
}

impl Circle {
    fn new(radius: f64) -> Self {
        Circle { radius } // フィールド名と変数名が同じなら省略形が使える
    }

    fn diameter(&self) -> f64 {
        self.radius * 2.0
    }
}

fn main() {
    let c = Circle::new(3.5); // 型名:: で呼ぶ
    println!("直径 = {}", c.diameter());
}

公式ドキュメントで詳しく ↗