Rustの構造体徹底解説！タプル構造体と通常構造体の違いと使い分けガイド

Rustのタプル構造体と通常構造体の違い

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

生徒

「Rustでデータをまとめるとき、構造体を使えばいいのはわかったんですが、書き方がいくつかあって迷っています。」

先生

「Rustには、フィールドに名前をつける『名前付きフィールド構造体』と、名前をつけない『タプル構造体』、そして中身のない『ユニット構造体』の3種類があります。用途に合わせて使い分けるのがコツですね。」

生徒

「タプル構造体と普通の構造体、どうやって使い分ければいいんでしょうか？」

先生

「データに意味のある名前をつけたいなら通常構造体、単純な値の集まりや、特定の型を包んで新しい型を作りたい場合はタプル構造体が便利です。詳しく深掘りしていきましょう！」

1. Rustの構造体とは？データを一つにまとめる基本の仕組み

Rustにおける構造体（Struct）は、複数の関連する値を一つのまとまりとして扱うためのカスタムデータ型です。プログラミングにおいて、関連性のない変数をバラバラに管理するとコードが複雑になり、バグの原因になります。そこで、意味のある単位でデータをパッケージ化するのが構造体の役割です。

Rustは静的型付け言語であり、メモリ管理に厳格です。構造体を使うことで、どのようなデータがどのような型で保持されているかを明確に定義できます。これは、開発者が意図しないデータの混入を防ぎ、コンパイル時にエラーを検出できるという「型安全」の恩恵を受けることにつながります。初心者がまず覚えるべきは、最も汎用性が高い「通常構造体（名前付きフィールド構造体）」と、特定の用途で威力を発揮する「タプル構造体」の二つです。

2. 通常構造体の特徴とメリット！名前付きフィールドの重要性

通常構造体は、各データ（フィールド）に「名前」をつけて定義します。これが最大の特徴であり、最大のメリットです。例えば、ユーザー情報を扱う際、「名前」「年齢」「メールアドレス」というフィールド名があれば、プログラムを読んだ瞬間にそのデータが何を指しているのかが直感的に理解できます。

この形式は、オブジェクト指向言語のクラスにおけるプロパティに近い感覚で使用できるため、多くのプログラマーにとって親しみやすいものです。フィールドの順序を気にする必要がなく、名前によってアクセスできるため、フィールドの数が増えても可読性が落ちにくいという特徴があります。複雑なビジネスロジックや、設定情報、エンティティの定義など、Rustの開発において最も頻繁に利用される形式です。

以下に、通常構造体の定義と使い方の基本例を示します。


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_user"),
        active: true,
        sign_in_count: 1,
    };

    println!("User {}'s email is {}", user1.username, user1.email);
}


User rust_user's email is example@test.com

3. タプル構造体の定義と構文！名前のないフィールドの活用

タプル構造体は、構造体自体には名前がありますが、その中身（フィールド）には名前をつけず、型だけを指定する形式です。記述が非常にシンプルになるため、データ構造が単純な場合によく使われます。アクセスする際は、名前ではなく `0`, `1`, `2` といったインデックス番号を使用します。

一見すると普通のタプル（例: `(i32, i32)`）と同じように見えますが、大きな違いは「名前が付いた型である」ということです。単なるタプルは同じ型の構成であれば同一視されますが、タプル構造体は名前が異なれば別の型として扱われます。これにより、同じ数値データであっても「色のRGB値」と「座標のXYZ値」を明確に区別し、誤って代入することを防ぐことができます。このように型を厳密に区別する手法は、安全性向上に寄与します。

次に、タプル構造体を使用した色の表現と座標の例を見てみましょう。


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 RGB: ({}, {}, {})", black.0, black.1, black.2);
    println!("Origin Point: ({}, {}, {})", origin.0, origin.1, origin.2);
    
    // black = origin; // これはコンパイルエラーになります。型が異なるためです。
}


Black RGB: (0, 0, 0)
Origin Point: (0, 0, 0)

4. タプル構造体と通常構造体の決定的な違いとは？

これら二つの最大の違いは、「情報の自己説明性」と「アクセスのしやすさ」にあります。通常構造体は、フィールド名があることで「そのデータが何であるか」をコード上で語ってくれます。一方でタプル構造体は、フィールド名が省略されているため、各要素の意味は文脈やインデックス番号から判断しなければなりません。

そのため、フィールドが3つ以上になる場合や、データの意味が多岐にわたる場合は、通常構造体を選択するのがベストプラクティスです。逆に、2次元や3次元の座標、あるいは単一の値をラップするだけ（Newtypeパターン）の場合は、タプル構造体の方がコードがスッキリします。また、メモリレイアウトの観点ではどちらも効率的ですが、開発者がコードをメンテナンスする際の負荷は通常構造体の方が低くなる傾向があります。初心者のうちは、迷ったら「名前をつける（通常構造体）」方を選んでおくと、後から見返した時に理解しやすいコードになります。

5. Newtypeパターンによる安全性向上！タプル構造体の真骨頂

タプル構造体の最も強力な活用法の一つが「Newtypeパターン」です。これは、既存の型（例えば `f64` や `String`）を一つのフィールドだけを持つタプル構造体で包む手法です。なぜこれが必要なのでしょうか？例えば「メートル」と「マイル」という二つの単位を扱う場合、どちらも `f64` 型で定義してしまうと、誤ってメートルをマイルとして計算してしまう可能性があります。

ここで、`struct Meters(f64);` と `struct Miles(f64);` を定義すれば、Rustのコンパイラはこれらを全く別の型として扱います。もしメートルを受け取る関数にマイルを渡そうとすれば、実行前（コンパイル時）にエラーとして教えてくれます。これがRustの「ゼロコスト抽象化」の一つであり、実行時のパフォーマンスを落とさずに型の安全性だけを最大化できる手法です。プログラムの堅牢性を高めるために、非常に重要なテクニックとなります。

以下に、Newtypeパターンを使った単位変換の概念的な例を示します。


struct Meters(f64);
struct Kilometers(f64);

fn print_distance(dist: Kilometers) {
    println!("距離は {} キロメートルです。", dist.0);
}

fn main() {
    let m = Meters(5000.0);
    // let km = Kilometers(m.0 / 1000.0); // 明示的な変換が必要
    let converted_km = Kilometers(m.0 / 1000.0);
    
    print_distance(converted_km);
    
    // print_distance(m); // エラー：Meters型をKilometers型に直接渡すことはできない
}


距離は 5 キロメートルです。

6. enumと構造体を組み合わせた柔軟なデータ設計

構造体について学んだ後は、Rustのもう一つの強力な武器である `enum`（列挙型）についても触れておく必要があります。構造体が「AとBとCを全て持っている（AND）」というデータ構造であるのに対し、enumは「A、B、Cのいずれかである（OR）」というデータ構造を表現します。Rustのenumは非常に高機能で、それぞれのバリアント（選択肢）にデータを持たせることができます。

驚くべきことに、enumのバリアントの中身には、今回学んだ「通常構造体形式」や「タプル構造体形式」をそのまま組み込むことができます。例えば、アプリケーションの状態を管理する際、ログイン中ならユーザー情報（構造体）、ログアウト中なら単純なフラグ、といった具合に柔軟に設計できます。構造体とenumを適切に組み合わせることで、無効な状態（不正なデータ）をそもそも作り出せないようにする「型による設計」が可能になります。これは大規模開発において極めて強力な防御策となります。

最後に、enumと構造体を組み合わせたメッセージ送信システムの例を見てみましょう。


enum Message {
    Quit,                       // データなし
    Move { x: i32, y: i32 },    // 名前付きフィールド（通常構造体形式）
    Write(String),              // タプル形式
    ChangeColor(i32, i32, i32), // タプル形式（複数）
}

impl Message {
    fn call(&self) {
        match self {
            Message::Quit => println!("終了します"),
            Message::Move { x, y } => println!("座標移動: x={}, y={}", x, y),
            Message::Write(text) => println!("メッセージ: {}", text),
            Message::ChangeColor(r, g, b) => println!("色変更: R={}, G={}, B={}", r, g, b),
        }
    }
}

fn main() {
    let m1 = Message::Write(String::from("こんにちは"));
    let m2 = Message::Move { x: 10, y: 20 };
    
    m1.call();
    m2.call();
}


メッセージ: こんにちは
座標移動: x=10, y=20

7. 構造体設計におけるベストプラクティスと使い分けの基準

初心者がRustの構造体設計で迷ったときは、まず「そのデータに名前をつける価値があるか？」を自問自答してみてください。例えば、Web APIのレスポンスやデータベースのレコードを表現する場合は、ほぼ間違いなく通常構造体が適しています。フィールド名がそのままドキュメントの役割を果たし、チーム開発でのコミュニケーションを円滑にするからです。

一方で、数学的なベクトルや、極めて短命な一時データの保持、あるいは先ほど紹介したNewtypeパターンのように「特定の型であることを保証したいだけ」の場合は、タプル構造体を選びます。また、Rustには「ユニット構造体」という、フィールドを一切持たない構造体もあります。これは主にトレイト（共通の振る舞い）を実装する際に、データ自体は必要ないが型としての存在が必要な場合に使用されます。これらの使い分けをマスターすれば、Rustらしい、メモリ効率が良く安全なプログラムを書くための第一歩を踏み出したと言えるでしょう。一歩ずつ、実際にコードを書いてその挙動を確かめてみてください。

---

本記事では、Rustの構造体の基本から、通常構造体とタプル構造体の詳細な違い、そしてNewtypeパターンやenumとの組み合わせといった応用的な設計手法までを解説しました。これらの仕組みを理解し、適切に使い分けることで、バグが少なくメンテナンス性の高いRustコードを書くことができるようになります。