Rustの構造体（struct）設計を完全ガイド！初心者でもわかるデータ構造の作り方

Rustの構造体定義とフィールド設計の基本

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

生徒

「Rustでプログラムを書いていると、関連するデータをひとまとめにして扱いたい場面が増えてきました。C言語の構造体のようなものはRustにもありますか？」

先生

「もちろんです！Rustでは構造体（struct）を使って、独自のデータ型を作ることができます。これを使うことで、プログラムの可読性と再利用性が格段に向上しますよ。」

生徒

「Rustの構造体って、他の言語と何か違う特徴があるんでしょうか？設計するときに気をつけるポイントを知りたいです！」

先生

「Rustの構造体は、単にデータを並べるだけではありません。所有権（Ownership）の概念が関わってくるのが大きな特徴ですね。また、メソッドを定義したり、列挙型と組み合わせたりすることで、非常に強力なツールになります。まずは基本の定義方法からじっくり見ていきましょう！」

1. Rustの構造体とは何か

Rustにおける構造体（struct）は、複数の関連する値をひとまとめにして、名前を付けたカスタムデータ型です。オブジェクト指向言語の「クラス」におけるデータ保持の役割に似ていますが、Rustではデータと振る舞い（メソッド）を分離して定義するのが一般的です。構造体を利用することで、複雑な情報を一つの単位として関数に渡したり、整理してメモリ上に配置したりすることが可能になります。これにより、コードの意図が明確になり、バグの混入を防ぐ設計が実現できます。

Rustの構造体には主に「名前付きフィールド構造体」「タプル構造体」「ユニット構造体」の3種類があります。最も頻繁に使われるのは、各データに名前を付けて管理する名前付きフィールド構造体です。これにより、どの値が何を意味しているのかを一目で理解できるようになります。例えば、ユーザー情報を扱う際に、名前、メールアドレス、年齢といった属性をバラバラの変数で管理するのではなく、一つの「User」構造体として定義することで、プログラム全体の構造が非常にスッキリします。

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

最も一般的な構造体の形式は、各フィールドに名前を付ける方法です。これは、プログラムの中で「どのデータが何を表しているか」を明示的に示したい場合に最適です。定義にはstructキーワードを使用し、波括弧の中にフィールド名と型を記述します。インスタンスを作成（インスタンス化）する際は、定義したすべてのフィールドに値を割り当てる必要があります。Rustでは未初期化の変数を許容しないため、安全性が保証されています。


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

fn main() {
    // インスタンスの作成
    let user1 = User {
        email: String::from("example@example.com"),
        username: String::from("rust_user"),
        active: true,
        sign_in_count: 1,
    };

    println!("User: {}, Email: {}", user1.username, user1.email);
}


User: rust_user, Email: example@example.com

上記の例では、Userという名前の構造体を定義しました。フィールドの順番は定義時とインスタンス作成時で異なっていても問題ありません。また、構造体のフィールドにアクセスするにはドット（.）記法を使用します。注意点として、インスタンス全体をmut（可変）として宣言しない限り、特定のフィールドだけを書き換えることはできません。Rustの不変性の原則がここでも適用されていることがわかります。

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

フィールドに名前を付けるほどではないけれど、型として区別したい場合には「タプル構造体」が便利です。これは、フィールド名を持たず、型だけを並べた形式です。例えば、座標系（x, y, z）や色のRGB値など、順番自体に意味があるデータを扱う際に多用されます。タプル構造体を使うことで、同じ(i32, i32, i32)という型のデータでも、「Color」なのか「Point」なのかをコンパイラに厳密に区別させることができ、型の安全性が高まります。


// タプル構造体の定義
struct Color(i32, i32, i32);
struct Point(i32, i32, i32);

fn main() {
    let black = Color(0, 0, 0);
    let origin = Point(0, 0, 0);

    // black と origin は型が違うため、混ぜて使うことはできません
    println!("Color RGB: ({}, {}, {})", black.0, black.1, black.2);
}


Color RGB: (0, 0, 0)

また、フィールドを一切持たない「ユニット構造体」というものもあります。これは、特定のデータを持たせる必要はないが、あるトレイト（機能）を実装したい場合などに利用されます。状態を持たないマーカーのような役割を果たすことが多く、Rustの高度なジェネリクスやメタプログラミングにおいて重要な役割を担います。初心者のうちはあまり使う機会がありませんが、ライブラリの開発などでは頻出するパターンです。

4. 構造体のフィールド設計と所有権の考慮

構造体を設計する上で最も重要なのが、フィールドの「所有権」です。Rustの構造体は、そのインスタンスがフィールドのデータを所有するのが基本です。先ほどの例でString型を使っていたのは、構造体が文字列データの所有権を持つためです。もしここで文字列スライス（&str）のような「参照」をフィールドに持たせようとすると、Rustは「その参照がいつまで有効か」を保証するために、ライフタイムという概念を要求します。

初心者のうちは、構造体のフィールドには所有権を持つ型（String, Vec, 数値型など）を使用することをおすすめします。参照をフィールドに持つ設計は非常に難易度が高く、借用チェッカーとの戦いになりがちだからです。データをコピーして持たせる（cloneする）ことで、所有権の複雑さを回避し、まずは正しく動作するデータ構造を作ることに集中しましょう。この「所有権を持たせる設計」は、データの生存期間を構造体そのものと一致させるため、メモリ管理のバグを根本から排除するRustらしい設計手法と言えます。

5. メソッド定義によるデータと振る舞いの統合

構造体はデータを持つだけではありません。impl（implementation）ブロックを使用することで、その構造体に関連付けられた関数やメソッドを定義できます。これにより、オブジェクト指向的なカプセル化に近い表現が可能になります。メソッドの第一引数には、自分自身を指す&self（読み取り専用参照）や&mut self（可変参照）を取ることが一般的です。


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

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

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

fn main() {
    let rect1 = Rectangle { width: 30, height: 50 };
    let sq = Rectangle::square(20);

    println!("The area of rect1 is {} square pixels.", rect1.area());
    println!("The area of sq is {} square pixels.", sq.area());
}


The area of rect1 is 1500 square pixels.
The area of sq is 400 square pixels.

メソッドを使うことで、構造体の内部状態に基づいた計算や操作を、その構造体のインターフェースとして公開できます。また、selfを受け取らない関数は「関連関数」と呼ばれ、インスタンス化のためのファクトリメソッドとしてよく使われます。このようにデータとロジックを一箇所にまとめることで、コードの保守性が飛躍的に向上します。Rustでは、一つの構造体に対して複数のimplブロックを定義することも可能であり、機能ごとに整理して記述することもできます。

6. enumとの組み合わせによる柔軟な設計

Rustの真価は、構造体とenum（列挙型）を組み合わせた時に発揮されます。Rustの列挙型は、他の言語のものよりも強力で、各バリアントにデータを持たせることができます。構造体のフィールドの中に列挙型を含めることで、「状態」や「種類」に応じた柔軟なデータ保持が可能になります。例えば、ウェブサーバーのリクエストを扱う場合、GETリクエストならパスの文字列を、POSTリクエストならボディのデータを持つ、といった設計が簡単に行えます。


enum Message {
    Quit,
    Move { x: i32, y: i32 },
    Write(String),
    ChangeColor(i32, i32, i32),
}

struct Screen {
    width: u32,
    height: u32,
    last_message: Message,
}

fn main() {
    let msg = Message::Move { x: 10, y: 20 };
    let screen = Screen {
        width: 1920,
        height: 1080,
        last_message: msg,
    };

    match screen.last_message {
        Message::Move { x, y } => println!("Moved to x:{}, y:{}", x, y),
        _ => println!("Other message"),
    }
}


Moved to x:10, y:20

この設計の素晴らしい点は、コンパイラが「すべてのパターンを網羅しているか」をチェックしてくれることです。match式と組み合わせることで、構造体の中にある複雑な列挙型の状態を、安全かつ漏れなく処理できます。これは「代数的データ型」と呼ばれる概念で、Rustにおけるプログラム設計の核心部分です。構造体でデータの「枠組み」を作り、列挙型でその中の「バリエーション」を表現する。この役割分担を理解することが、Rust上達への近道です。

7. フィールドの可視性とカプセル化

Rustでは、構造体のフィールドやメソッドはデフォルトで「プライベート」です。つまり、その構造体が定義されているモジュール（通常は同じファイル内）の外からはアクセスできません。外部からアクセス可能にするには、pubキーワードを明示的に付ける必要があります。この仕様により、ライブラリの作成者は内部の実装詳細を隠蔽し、安全なAPIだけを公開する「カプセル化」を自然に実践できます。

フィールドをプライベートにしておき、専用の「ゲッター（getter）」や「セッター（setter）」メソッドを提供することで、データの整合性を保つことができます。例えば、年齢を保持するフィールドをプライベートにし、セッターメソッドの中で「0歳未満はエラーにする」といったバリデーションを挟むことが可能です。構造体を設計する際は、すべてのフィールドを安易にpubにするのではなく、本当に外部からの直接操作が必要なものだけを公開するように心がけましょう。これにより、将来的なコードの変更による影響範囲を最小限に抑えることができます。

8. 構造体の更新記法と効率的なコード

既存の構造体インスタンスの一部だけを変更して、新しいインスタンスを作成したい場合には「構造体更新記法」が役立ちます。これは、二つのドット（..）を使って、残りのフィールドを別のインスタンスからコピーまたはムーブする構文です。これを使うことで、大量のフィールドを持つ構造体であっても、必要な部分だけを指定して簡潔に新しいデータを作ることができます。特に設定値（Config）のような、デフォルト値が多く一部だけをカスタマイズしたい場面で非常に重宝されます。

ただし、ここで注意が必要なのが、やはり「所有権」です。数値型などのCopyトレイトを実装している型は単にコピーされますが、Stringなどの所有権を持つ型はムーブが発生します。元のインスタンスから特定のフィールドがムーブしてしまうと、元のインスタンスは以後使用できなくなる場合があります。このように、一見便利な構文の裏側でも常にRustの所有権ルールが働いていることを意識することが大切です。Rustの構造体設計は、単なるデータの箱作りではなく、プログラムの生存期間と安全性を定義するクリエイティブな作業なのです。

9. デバッグを容易にする派生トレイト

構造体を作った後、中身をサクッと表示して確認したいことがよくあります。しかし、Rustでは標準のprintln!で構造体をそのまま表示することはできません。ここで役立つのが#[derive(Debug)]というアノテーションです。これを構造体の定義の直前に置くことで、デバッグ用の表示機能を自動的に実装してくれます。開発効率を上げるためには欠かせないテクニックです。他にも、比較機能を追加するPartialEqや、値をコピー可能にするCloneなど、便利な機能を一行で追加できるのがRustの強みです。

初心者のうちは、自作の構造体にはとりあえず#[derive(Debug, Clone)]を付けておくくらいの気持ちで良いでしょう。これにより、デバッグが容易になり、所有権で詰まったときにも.clone()で一時的に回避するといった柔軟な対応が可能になります。構造体設計の基本を押さえ、これらの便利な機能を使いこなすことで、あなたのRustプログラミングはより楽しく、より確実なものへと進化していくはずです。基本をマスターしたら、次はさらに高度なトレイトの実装やジェネリクスを活用した設計にも挑戦してみてください。