こんにちは。Dartの世界へようこそ。
Dartは進化の止まらない言語です。特にDart 3.0で導入された「レコード（Records）」は、これまで私たちが「クラスを作るほどではないが、複数の値を返したい」というシーンで感じていたモヤモヤを一掃する革命的な機能でした。
今日は、レコードと名前付き引数を組み合わせた、モダンで「負債を生まない」関数設計について、コアの視点から解説します。ここをマスターすれば、あなたのコードは劇的に洗練されますよ。
—
なぜ、今「レコード」なのか？
従来のDartで「複数の値を返したい」と思ったとき、あなたならどうしていましたか？
1. `List` や `Map` を使う（型安全性が失われ、アクセス時にキャストが必要になる）
2. 戻り値専用の小さなクラスを定義する（コード量が増え、管理が面倒になる）
3. `List
レコードは、これらを「一時的かつ型安全なデータ構造」として解決します。コンパイラにとっても、レコードは最適化が効きやすく、非常に効率的な構造体として扱われます。
—
1. レコードの基本：戻り値に「名前」を付ける
まずは、単純なレコードの書き方を見てみましょう。カッコ `()` を使い、戻り値に名前（フィールド名）を付けるのがポイントです。
// ユーザー情報を取得する関数
// 戻り値の型として (String name, int age) という構造を定義しています
({String name, int age}) getUserData() {
return (name: ‘Dart Master’, age: 30);
}
void main() {
final user = getUserData();
// ドット演算子で直感的にアクセス可能
print(‘名前: ${user.name}, 年齢: ${user.age}’);
}
このコードの美しい点は、呼び出し側で `user.name` と書けることです。Mapのように `user[‘name’]` と書いて文字列のタイポに怯える必要はありません。コンパイル時に型が保証されます。
—
2. 実践：名前付き引数との融合
次に、関数の引数にも「名前付き引数」を使い、戻り値に「レコード」を使う設計を見てみましょう。これにより、APIのインターフェースが極めて明快になります。
// 位置引数ではなく名前付き引数で設定を管理
({int statusCode, String message}) processRequest({
required String url,
int timeout = 5000,
}) {
// 本来はここでネットワーク処理などを実行
if (url.isEmpty) {
return (statusCode: 400, message: ‘URLが空です’);
}
return (statusCode: 200, message: ‘成功しました’);
}
void main() {
// 呼び出し側：何をしているかが一目でわかる
final result = processRequest(url: ‘https://dart.dev’);
// パターンマッチングで分解して受け取ることも可能
final (:statusCode, :message) = result;
print(‘Status: $statusCode, Msg: $message’);
}
ここが本質：なぜこの設計が強いのか？
- 名前付き引数: 「どの引数が何の役割か」を呼び出し側で明示でき、デフォルト値の設定も容易です。
- レコード戻り値: 関数の出力が「構造」として定義されているため、関数の責務が明確になります。
- パターン分解: `final (:statusCode, :message) = result;` という記述は、Dart 3から導入された「レコードの分解（Destructuring）」です。これにより、受け取ったデータを即座に変数へ展開できます。
—
3. 陥りやすい罠と解決策
初学者がよくやってしまうミスをいくつか紹介します。これを知っておくだけで、他の開発者と差がつきますよ。
罠1：名前を付け忘れると「位置」に依存する
(String, int) getUser() => (‘Alice’, 25);
// これだと user.$1, user.$2 となってしまい、
// どちらが名前か年齢か直感的に分かりません。
解決策: 常に名前付きレコード `({String name, int age})` を使いましょう。可読性が段違いです。
罠2：null安全を忘れる
レコードのフィールドがnullを許容する場合、型定義に `?` を忘れないでください。
({String? name, int age}) getNullableData() {
return (name: null, age: 20); // nameはnullを許容
}
—
伝説のアーキテクトからのアドバイス
Dartのコンパイラは、レコードを非常に軽量なオブジェクトとして処理します。クラスを定義するまでもない小さなデータセットを、いちいちクラス化してメモリを消費させる必要はありません。
「関数が何を返し、何を受け取るか」。このインターフェースをレコードと名前付き引数で設計することは、あなたのコードを「ドキュメントなしでも読めるコード」へと進化させる第一歩です。
まずは、既存のコードで「これ、小さなクラスにするほどじゃないな」と思っている箇所を、レコードに置き換えてみてください。その瞬間に、あなたのDart力が一段階上のステージに引き上げられるはずです。
何か分からないことがあれば、いつでも聞いてください。Dartの深淵まで、一緒に潜っていきましょう。