関数から複数の値を返す：outパラメータとタプル

1. はじめに

例えば、ユーザー（たとえば名前で）を渡して、その人の年齢・登録日・アクティブフラグを一気に返したい関数があるとしよう。Cや初期のC#では、返り値は1つだけってのが普通だったんだ。じゃあ、返したい値が複数ある場合はどうする？この疑問からいろんなアプローチが生まれて、それぞれ良いところも悪いところもあるんだよね。
前のレクチャーでタプルにはもう触れたよね。今回はoutパラメータを学んで、この2つのやり方を比べてみよう。

よく使われるアプローチ：

• outパラメータを使う。
• 必要なフィールドを持つオブジェクトを返す（匿名型や自作クラス）。
• タプル（ValueTuple）を返す。

このレクチャーでは、この中からoutパラメータとタプルの2つを詳しく見て、「ガチンコ対決」してみるよ。どっちが複数値返すのに向いてるか、しっかり理解しよう！

2. outパラメータ：昔ながらのやり方

こんな関数を見ると：

void GetUserInfo(string userName, out int age, out DateTime registrationDate, out bool isActive)
{
    // ここで計算とか
    age = 42;
    registrationDate = new DateTime(2010, 1, 1);
    isActive = true;
}

「これ、関数？それとも洗車場の支店？」ってツッコミたくなるよね。返すものが多すぎて、しかも全部メインの返り値じゃないし！

どうやって動くの？

呼び出し側は、関数が値をセットするための変数をあらかじめ宣言しとく必要があるんだ：

int age;
DateTime reg;
bool isActive;

GetUserInfo("Bob", out age, out reg, out isActive);

// これで全部の変数に値が入った
Console.WriteLine($"{age}, {reg}, {isActive}");

out方式のデメリット

• 読みにくい：メソッドのシグネチャが横に長くなって、返すデータの意味がパラメータ名だけじゃ分かりにくい。
• チェーン呼び出しに不便：このやり方だと、結果をそのまま他のメソッドに渡すとかが簡単にできない。
• 渡した変数が書き換えられる：メソッドは既存の変数を必ず変更しないといけないし、outを忘れるとコンパイルエラーになる。
• 初期化の手間：たとえ1回しか使わない結果でも、外で変数を宣言しないといけない。
• 大きなメソッドだと読みにくい：outパラメータが多いと、どれが何のためかすぐ分からなくなっちゃう。

ここでタプルの「スター感」が光るんだよね。

3. タプル — 進化したやり方

例で比べてみよう

タプルを使うと：

public (int Age, DateTime RegistrationDate, bool IsActive) GetUserInfo(string userName)
{
    // DB検索のエミュレーション
    return (42, new DateTime(2010, 1, 1), true);
}

使い方：

// 全部の値を一気に受け取って、変数名も付けられる
var (age, regDate, isActive) = GetUserInfo("Bob");
Console.WriteLine($"{age}, {regDate}, {isActive}");

余計な宣言もoutもいらないし、めっちゃ読みやすい！

比較表：out vs tuple

タプル VS. out — 裏側で何が起きてる？

outパラメータだと、関数は自分の「領域」外のメモリをいじることになる。ざっくり言うと、他で作られた変数を変更するんだ。これ、うっかり変数の状態を「ゴミ」にしちゃうこともあるから注意が必要（必ず代入しろってコンパイラが言ってくれるのはありがたいけどね）。

タプルは、関数がデータ構造を作って、全部初期化してから返す。つまり、全部まとめて「荷物」として返すから、途中で失くしたり忘れたりしないんだ。

コードの読みやすさ・保守性

分かるでしょ？1週間後に他人のコード読むとき、こうなっててほしいよね：

(var age, var city, var isActive) = GetUserInfo("Anna");

じゃなくて

int age;
string city;
bool isActive;
GetUserInfo("Anna", out age, out city, out isActive);

タプルならメソッドのシグネチャもスッキリするし、使う側も直感的に分かるよ。

4. タプルが特に便利な場面

1. 結果とエラーメッセージを一緒に返したいとき

public (bool Success, string ErrorMessage) TryProcess(string data)
{
    if (string.IsNullOrEmpty(data))
        return (false, "データがありません");

    // データ処理...
    return (true, "");
}

var (ok, error) = TryProcess(input);
if (!ok)
    Console.WriteLine($"エラー: {error}");

2. 検索結果を複数返す関数

public (User? FoundUser, int Index) FindUserByName(User[] users, string name)
{
    for (int i = 0; i < users.Length; i++)
    {
        if (users[i].Name == name)
            return (users[i], i);
    }
    return (null, -1);
}

3. 「ペア」値：最小値と最大値の計算

public (int min, int max) FindMinMax(int[] numbers)
{
    int min = numbers[0], max = numbers[0];
    foreach (var n in numbers)
    {
        if (n < min) min = n;
        if (n > max) max = n;
    }
    return (min, max);
}

var (minValue, maxValue) = FindMinMax(arr);

2

タスク

C# SELF, レベル 11, レッスン 3

ロック未解除

タプルを使った関数の作成

タプルを使った関数の作成

オープン

2

タスク

C# SELF, レベル 11, レッスン 3

ロック未解除

配列の最小値と最大値をタプルで計算しよう

配列の最小値と最大値をタプルで計算しよう

オープン