SwiftのEquatable・Hashable・Codable適合パターンと落とし穴を徹底解説！初心者でも安心

1. Equatableとは？

1. Equatableとは？

Equatableは、「この2つは同じもの？」という判定をSwiftに教えるためのプロトコルです。プログラミングでは、数字や文字だけでなく、自分で作ったデータ同士を比較したい場面がよくあります。そのときに活躍するのがEquatableです。

例えば、名簿に登録されている学生が「同一人物かどうか」を調べたい場合、idやnameが両方同じなら「同じ学生」と判断したいですよね。Equatableに適合すると、==演算子が使えるようになり、こうした比較が直感的に書けます。

struct Student: Equatable {
    var id: Int
    var name: String
}

let a = Student(id: 1, name: "Taro")
let b = Student(id: 1, name: "Taro")
print(a == b)  // true

true

この例では、aとbはどちらもidとnameが同じなので、「等しい」と判定されます。Swiftでは、すべてのプロパティが比較可能な型であれば、このような比較処理を自動で用意してくれるのも初心者にやさしいポイントです。

2. Hashableとは？

2. Hashableとは？

Hashableは、Swiftで「この値は他と同じかどうか」を判断できるようにするためのプロトコルです。少し難しく聞こえますが、簡単に言うと同じデータを重複させないための仕組みです。SetやDictionaryでは、このHashableに対応している型しか使えません。

たとえば、名簿やID管理のように「同じ人を2回登録したくない」場面で役立ちます。Swiftは内部で「ハッシュ値」という番号を使って、高速に同じ値かどうかを判断しています。

struct Student: Hashable {
    var id: Int
    var name: String
}

上の例では、Student構造体がHashableに対応しています。これにより、idやnameが同じ学生は「同一のデータ」として扱われます。

let students: Set = [
    Student(id: 1, name: "Taro"),
    Student(id: 2, name: "Hanako"),
    Student(id: 1, name: "Taro") // 重複
]

print(students.count)

2

このように、Setでは同じ値が自動的にまとめられ、重複したデータは除外されます。プログラミング未経験の方でも、「同じものは1つだけ残る」と覚えておけばOKです。

3. Codableとは？

3. Codableとは？

Codableとは、Swiftでよく使われる「データの変換」をとても簡単にしてくれる仕組みです。アプリの中で使っているデータを、JSON形式に変換して保存したり、逆にJSONからSwiftのデータとして読み込んだりできます。難しそうに聞こえますが、「Swiftのデータ ⇄ JSON」を自動でやってくれる便利機能だと思ってOKです。

例えば、アプリでユーザー情報や学生データを保存したいとき、そのままでは保存できません。そこでCodableを使うと、特別な処理を書かなくても、安全で分かりやすい形に変換できます。初心者の方でも、構造体にCodableを付けるだけで使えるのが大きな特徴です。

import Foundation

// 学生データを表す構造体
struct Student: Codable {
    var id: Int
    var name: String
}

// データを作成
let student = Student(id: 1, name: "Taro")

// JSONに変換
let encoder = JSONEncoder()
if let data = try? encoder.encode(student) {
    let jsonString = String(data: data, encoding: .utf8)!
    print(jsonString)
}

{"id":1,"name":"Taro"}

このサンプルでは、StudentというデータをJSON文字列に変換しています。Codableを使うことで、複雑な処理を書かずに、データの保存や読み込みができるようになります。

4. 自動合成と落とし穴

4. 自動合成と落とし穴

SwiftではEquatableやHashable、Codableは多くの場合自動的に実装されます。しかし、条件によっては自分で定義が必要になることがあります。

• 計算プロパティ（var age: Int { ... }など）は自動合成に含まれません。
• 循環参照がある場合、Codableの自動生成はエラーになります。
• 一部のプロパティだけを比較や保存対象にしたい場合は、カスタム実装が必要です。

5. カスタム実装の例

5. カスタム実装の例

例えば、Equatableで名前だけを比較したい場合は、自分で==演算子を定義します。

struct Student: Equatable {
    var id: Int
    var name: String

    static func ==(lhs: Student, rhs: Student) -> Bool {
        return lhs.name == rhs.name
    }
}

let x = Student(id: 1, name: "Taro")
let y = Student(id: 2, name: "Taro")
print(x == y)  // true

true

この場合、IDが違っても名前が同じならtrueになります。自動合成では実現できない柔軟な判定が可能です。

6. 初心者が注意すべきポイント

6. 初心者が注意すべきポイント

プログラミングを始めたばかりの人がよくつまずくのは、「自動でやってくれるはずなのにエラーになる」という場面です。例えば、プロパティの中に別の非対応型（EquatableやCodableに適合していない型）があると、自動実装は使えません。その場合は、手動で実装する必要があります。

また、Hashableを使うときは、ユニークさを保証するための情報（IDなど）をきちんと持たせることが大切です。そうしないと意図せず重複判定されることがあります。