SwiftのCustomStringConvertibleとIdentifiableで表現力を上げる！初心者向け解説

1. CustomStringConvertibleとは？

1. CustomStringConvertibleとは？

CustomStringConvertibleは、インスタンスを文字列に変換するときに、開発者がわかりやすい説明文を返せるようにするプロトコルです。初心者向けに言えば「オブジェクトの名札を自分で書ける仕組み」と考えるとわかりやすいです。

struct Book: CustomStringConvertible {
    var title: String
    var author: String

    var description: String {
        return "『\(title)』 by \(author)"
    }
}

let book = Book(title: "Swift入門", author: "Yamada")
print(book)

『Swift入門』 by Yamada

このように、printで出力するときに、自分で指定した見やすい文字列が表示されます。これがないと、型の情報だけが出てしまい、内容がわかりにくいのです。

2. Identifiableとは？

2. Identifiableとは？

Identifiableは、オブジェクトに固有の識別子（ID）を持たせるためのプロトコルです。アプリでデータを管理するとき、ひとつひとつのデータを区別するためにIDが必要になります。

struct User: Identifiable {
    var id: UUID = UUID()
    var name: String
}

let user = User(name: "Hanako")
print(user.id)
print(user.name)

6D2F38C1-5C9B-4F2E-A6A9-2C7E4B123456
Hanako

このように、自動生成されるUUID（ユニークID）が各ユーザーに割り当てられるので、同じ名前のユーザーでも区別できます。

3. CustomStringConvertibleとIdentifiableを組み合わせる

3. CustomStringConvertibleとIdentifiableを組み合わせる

実際の開発では、この二つを組み合わせるととても便利です。例えば、ユーザー一覧を表示するときに「誰なのか」と「どのIDなのか」を両方表現できます。

struct User: Identifiable, CustomStringConvertible {
    var id: UUID = UUID()
    var name: String

    var description: String {
        return "User: \(name), ID: \(id.uuidString)"
    }
}

let user = User(name: "Taro")
print(user)

User: Taro, ID: 6D2F38C1-5C9B-4F2E-A6A9-2C7E4B123456

これにより、開発中のデバッグやログ出力が格段に見やすくなります。チーム開発でも「どのデータがどのユーザーなのか」がすぐわかるため、とても役立ちます。

4. 実務での活用シーン

4. 実務での活用シーン

SwiftUIではIdentifiableが特に多用されます。リスト表示で一意のIDが必要になるからです。また、CustomStringConvertibleはデバッグやログ確認のときに非常に便利です。例えば、ネットワーク通信で取得したデータを出力する場合も、人間が読める形にしておくとエラーの特定が簡単になります。

初心者がアプリ開発を進めるときにも、この二つを理解しておくと「データを見やすく扱う力」が大きく向上します。

5. 初心者が注意すべき落とし穴

5. 初心者が注意すべき落とし穴

便利なプロトコルですが、いくつか注意点もあります。

• descriptionプロパティはユーザー向けではなく、あくまで開発者向けの出力に使うのが基本です。
• IdentifiableのIDを手動で設定する場合は、ユニークであることを必ず保証する必要があります。
• UUIDはランダムに生成されるため、同じデータを読み込むたびに別のIDが付く可能性があります。永続化するときは固定のIDを考えましょう。

このように仕組みを正しく理解すれば、Swiftでのアプリ開発や学習がぐっとスムーズになります。