先生と生徒の会話形式で理解しよう

生徒

「Rustを勉強し始めたのですが、データの管理をより効率的に行いたいんです。変数をバラバラに定義するのではなく、関連するデータを一つにまとめる方法はありますか？」

先生

「それなら構造体（struct）の出番ですね。構造体を使えば、名前や年齢、座標といった関連する値を一つのパッケージとして扱えるようになります。他の言語でいうオブジェクトやクラスに近い概念ですよ。」

生徒

「構造体を使うと、プログラムが整理されそうですね！でも、書き方が難しそうで少し不安です。」

先生

「大丈夫ですよ。Rustの構造体はとてもシンプルですが、型安全性が非常に高く、バグの少ないコードを書くための強力な武器になります。まずは基本の書き方から、一緒に学んでいきましょう！」

1. Rustの構造体とは？データ構造を定義する基礎知識

Rustにおける構造体（struct）とは、複数の異なる型を組み合わせて、新しいカスタムデータ型を作成するための仕組みです。例えば、ユーザー情報を管理する場合、「ユーザー名（String型）」「年齢（u32型）」「ログイン状態（bool型）」といった複数のデータをバラバラに定義するのではなく、一つの「User」という枠組みで管理できるようになります。

これにより、コードの可読性が飛躍的に向上し、データのまとまりが明確になります。Rustは静的型付け言語であるため、構造体で定義した各項目（フィールド）にどのようなデータが入るかを厳密にチェックしてくれます。これが、Rustがモダンなシステムプログラミング言語として信頼されている理由の一つです。

オブジェクト指向言語を経験したことがある方なら、構造体は「属性を持つクラス」のようなものだと考えると理解が早いでしょう。ただし、Rustの構造体はメソッドを分離して定義するため、データと振る舞いを明確に分ける設計思想が根底にあります。まずは、最も一般的な「名前付きフィールドを持つ構造体」の基本形を見ていきましょう。

2. 名前付きフィールド構造体の定義とインスタンス化

最もよく使われるのが、各データに名前（フィールド名）を付ける形式です。これにより、どの値が何を意味しているのかが一目でわかります。定義にはstructキーワードを使用し、その後に大文字で始まる型名を記述します。


struct User {
    username: String,
    email: String,
    sign_in_count: u64,
    active: bool,
}

fn main() {
    let user1 = User {
        email: String::from("example@test.com"),
        username: String::from("rust_taro"),
        active: true,
        sign_in_count: 1,
    };

    println!("ユーザー名: {}", user1.username);
}

上記のコードでは、Userという構造体を定義し、main関数の中でその実体（インスタンス）を作成しています。フィールドへのアクセスは、ドット演算子（.）を使用します。注意点として、Rustではデフォルトで変数は不変（immutable）であるため、構造体の値を後から変更したい場合は、let mut user1 = ...のようにmutキーワードを付ける必要があります。フィールドの一部だけを可変にすることはできず、構造体インスタンス全体が可変か不変かのどちらかになります。

3. タプル構造体とユニット構造体の活用シーン

Rustには、フィールドに名前を付けない特殊な構造体も存在します。一つはタプル構造体です。これは、型に名前を付けたいけれど、フィールド名まで付けると冗長になる場合（例えば、座標や色のRGB値など）に便利です。


struct Color(i32, i32, i32);
struct Point(i32, i32, i32);

fn main() {
    let black = Color(0, 0, 0);
    let origin = Point(0, 0, 0);
    
    println!("Blackの最初の値: {}", black.0);
}

ColorとPointはどちらも同じi32を三つ持つ構造体ですが、型としては別物として扱われます。これにより、「色のデータを入れるべき場所に、間違えて座標のデータを渡してしまう」というミスをコンパイル時に防ぐことができます。これがRustの強力な型システムの恩恵です。

また、フィールドを一切持たないユニット構造体もあります。これは、特定のデータを持たせる必要はないけれど、ある型に対してトレイト（共通の振る舞い）を実装したい場合に利用されます。メモリを消費しない軽量な型として重宝されます。

4. 構造体の所有権とデータの受け渡し

構造体を扱う上で避けて通れないのが、Rustの核心である所有権（Ownership）の概念です。構造体のフィールドにStringなどのヒープメモリを使用するデータが含まれている場合、その構造体インスタンスが所有権を持ちます。構造体を別の変数に代入したり、関数に渡したりすると、所有権が移動（ムーブ）します。

もし、元の変数も引き続き使い続けたい場合は、所有権を渡すのではなく、参照（借用）を渡すか、clone()メソッドを使ってデータを複製する必要があります。初心者が最初につまずきやすいポイントですが、「誰がデータの持ち主か」を意識することで、メモリの二重解放やメモリリークを未然に防ぐことができるのです。構造体設計においても、データを所有させるのか、参照を持たせるのかを考えることは非常に重要です。なお、参照をフィールドに持たせる場合は「ライフタイム」という高度な概念が必要になりますが、まずは所有権を持つデータを扱う設計から慣れていきましょう。

5. 構造体にメソッドを実装するimplブロックの役割

データとその操作を関連付けるために、Rustではimpl（implementation）ブロックを使用して構造体にメソッドを定義します。これにより、その構造体専用の関数を呼び出すことができるようになります。第一引数に&selfを取るのがメソッドの特徴です。


struct Rectangle {
    width: u32,
    height: u32,
}

impl Rectangle {
    // 面積を計算するメソッド
    fn area(&self) -> u32 {
        self.width * self.height
    }

    // 正方形を作成する関連関数（スタティックメソッドのようなもの）
    fn square(size: u32) -> Rectangle {
        Rectangle {
            width: size,
            height: size,
        }
    }
}

fn main() {
    let rect = Rectangle { width: 30, height: 50 };
    println!("長方形の面積: {} 平方ピクセル", rect.area());

    let sq = Rectangle::square(20);
    println!("正方形の幅: {}", sq.width);
}

メソッドの中で&selfを使うことで、構造体のデータを読み取ることができます。もし値を変更する必要がある場合は&mut selfを使います。また、Rectangle::squareのように、インスタンス化せずに呼び出せる「関連関数」も定義できます。これは新しいインスタンスを生成するコンストラクタのような役割でよく使われます。このように、データ構造とロジックをimplで分けることで、コードが非常に見通しやすくなります。

6. 構造体の更新記法で効率的にインスタンスを作成する

既存のインスタンスの値をベースに、一部のフィールドだけを変更した新しいインスタンスを作りたいことがあります。その際、すべてのフィールドを手動でコピーするのは面倒です。Rustには、これを簡潔に記述するための構造体更新記法（Struct Update Syntax）が用意されています。

具体的には、..（ドット二つ）に続けてベースとなるインスタンスを指定します。これにより、指定しなかったフィールドの値が元のインスタンスからコピー（またはムーブ）されます。設定項目が多い大規模な構造体を扱う際には、この機能が非常に役立ちます。ただし、一部のデータがムーブされると、元のインスタンスが使えなくなる場合がある点には注意が必要です。コードの重複を減らし、宣言的にデータを記述できるこの機能は、Rustらしい洗練された構文の一つと言えるでしょう。

7. デバッグに必須なderive属性とDisplayトレイト

プログラムを開発していると、構造体の中身を表示して中身を確認したくなることが多々あります。しかし、Rustの構造体はデフォルトではprintln!で表示することができません。そこで役立つのが、#[derive(Debug)]というアノテーションです。


#[derive(Debug)]
struct Player {
    name: String,
    level: u32,
}

fn main() {
    let p = Player {
        name: String::from("Hero"),
        level: 50,
    };

    // {:?} を使うとデバッグ表示が可能
    println!("プレイヤー情報: {:?}", p);
    
    // {:#?} を使うと、より見やすく整形して出力される
    println!("整列されたプレイヤー情報:\n{:#?}", p);
}


プレイヤー情報: Player { name: "Hero", level: 50 }
整列されたプレイヤー情報:
Player {
    name: "Hero",
    level: 50,
}

このように、構造体の定義の直前に#[derive(Debug)]と記述するだけで、コンパイラが自動的にデバッグ用の表示機能を実装してくれます。開発効率を上げるためには欠かせないテクニックです。一方で、ユーザー向けに綺麗にフォーマットされた文字列を表示したい場合は、Displayトレイトを自前で実装することになりますが、開発中の内部確認であればこのDebug派生だけで十分対応可能です。

8. Rustらしい構造体設計のポイントとベストプラクティス

最後に、初心者の方が構造体を設計する際に意識すべきポイントを整理しましょう。第一に、不変性（Immutability）を意識することです。必要以上にmutを多用せず、可能な限り不変なデータとして扱うことで、マルチスレッド環境でも安全なプログラムになります。

第二に、カプセル化です。他のモジュールからフィールドを直接触らせたくない場合は、フィールド名にpubキーワードを付けないことで非公開にできます。外部には専用のメソッド（ゲッターやセッター）を提供することで、データの一貫性を守ることができます。Rustの構造体設計は、単にデータをまとめるだけでなく、プログラムの安全性と保守性を高めるための重要な土台です。

第三に、列挙型（enum）との組み合わせです。構造体は「AかつBかつC」という情報の集まり（積型）を得意としますが、「AまたはB」という状態（和型）を表すにはenumが適しています。これらを適切に組み合わせることで、現実世界の複雑な仕組みを正確にコードに落とし込むことができるようになります。まずは小さな構造体から作り始め、少しずつ大きなシステムの設計に挑戦してみてください。