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

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

生徒

「先生、SwiftでCustomStringConvertibleとかIdentifiableって見かけたんですけど、これはどんなときに使うんですか？」

先生

「いい質問ですね。これらはコードをもっとわかりやすく、表現力豊かにするためのプロトコルなんです。CustomStringConvertibleは『見やすい説明文を持たせる』、Identifiableは『固有のIDを与える』ために使います。」

生徒

「説明文とIDですか？アプリ開発でどう役立つのか知りたいです！」

先生

「では、実際の例を見ながら一緒に理解していきましょう。」

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とは？

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を組み合わせる

実際の開発では、この二つを組み合わせるととても便利です。例えば、ユーザー一覧を表示するときに「誰なのか」と「どの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. 実務での活用シーン

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

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