Go 多値戻り値メカニズム

Go 言語の関数は、1 つの結果を返すだけにとどまりません。複数の値を同時に返すことができます。この特性は Go 言語の象徴的なデザインの一つであり、エラーハンドリング（Error Handling）のあり方を根本から変え、コードの可読性を劇的に向上させました。また、関数が一度により包括的でコンテキスト（Context）に富んだ結果を提供することを可能にします。

本章では、多値戻り値の動作メカニズム、それがもたらす絶大なメリット、そして Go プログラム内でいかに効率的に運用するかを深く掘り下げていきます。

1. 多値戻り値の理解

多くの伝統的なプログラミング言語では、関数が複数のデータを返す必要がある場合、一時的なオブジェクト（構造体やクラス）を作成してデータをラップするか、あるいはポインタ（Pointer）や参照（Reference）をパラメータ（Parameter）として渡して外部変数を書き換える必要がありました。

Go 言語は多値戻り値をネイティブにサポートすることで、これらすべてを極めてシンプルかつ自然なものにしています。これは、関数が「ビジネスロジックの結果」と「エラーの状態（Error Status）」を同時に返す必要がある場合に特に重要となります。

1.1 文法ルール

複数の戻り値を持つ関数を宣言するには、関数のシグネチャ（Signature）のパラメータリストの後に、丸括弧 () を使用してすべての戻り値の型を記述するだけです。

func 関数名(パラメータ1 型1, パラメータ2 型2) (戻り値型1, 戻り値型2) {
    // 関数本体のロジック
    return 値1, 値2 // 返される具体的な値は、宣言された型と一対一で対応している必要があります
}

1.2 クラシックなサンプル：計算結果とエラー（Result & Error）の返却

これは Go 言語で最も一般的かつ重要な多値戻り値の応用パターンです。

package main

import (
	"fmt"
	"errors" // エラーオブジェクトを作成するために errors パッケージをインポート
)

// divide 関数は除算を試みます。
// これは 2 つの値を返します：商 (float64) と エラー情報 (error)。
func divide(numerator, denominator float64) (float64, error) {
	if denominator == 0 {
        // 除数がゼロの場合、デフォルト値 0 と明確なエラーオブジェクトを返します
		return 0, errors.New("除数はゼロにできません") 
	}
    // 演算が成功した場合、商を返し、error を nil（エラーなし）に設定します
	return numerator / denominator, nil 
}

func main() {
    // シナリオ 1：通常の除算
	result, err := divide(10.0, 2.0) 
	if err != nil { // 定石：err が nil かどうかをチェック
		fmt.Println("エラーが発生しました:", err) 
		return
	}
	fmt.Println("計算結果:", result) // 出力: 計算結果: 5

    // シナリオ 2：ゼロ除算エラーをトリガー
	result, err = divide(5.0, 0.0) 
	if err != nil {
		fmt.Println("エラーが発生しました:", err) // 出力: エラーが発生しました: 除数はゼロにできません
		return
	}
    // 上記で return しているため、エラー発生時にこの行は実行されません
	fmt.Println("计算结果:", result) 
}

この例におけるポイント：

• divide 関数のシグネチャは、float64 と error を返すことを明確に示しています。
• 呼び出し側は result, err := ... を使用して、これら 2 つの値を同時に受け取ります。
• 呼び出し側は直後に err != nil をチェックします。この明示的なエラーチェックは Go 言語が推奨するプログラミング哲学であり、開発者に潜在的な失敗と向き合うことを強制し、結果として堅牢なコードを構築させます。

1.3 不要な戻り値の無視

関数が詳細な情報を複数返してくるものの、現在のロジックではその一部しか必要ない場合があります。この際、使用しない変数を強制的に宣言するとコンパイルエラー（Compile Error）になります。解決策として、ブランク識別子（Blank Identifier） _（アンダースコア）を使用します。

2. 多値戻り値の核心的なメリット

なぜ多値戻り値を使用するのでしょうか？

• エレガントなエラーハンドリング: 上記の divide の例のように、関数は例外（Exception）をスロー（Throw）するのではなく、通常のデータと同様にエラーを返します。これにより、プログラムのコントロールフロー（Control Flow）が明確になります。
• 可読性の向上: 操作が自然と 2 つの関連する結果を生む場合（文字列パース時の「パース結果」と「成功したかどうかのブールフラグ」など）、それらを一度に返す方が、2 つの関数に分けたり構造体に詰め込んだりするよりも直感的です。
• ボイラープレート（Boilerplate）の削減: 複数の戻り値を渡すためだけに一時的に作成される各種 DTO（Data Transfer Object）構造体の記述から解放されます。
• クリーンな API 設計: 関数のシグネチャ自体が出力のすべてを自己記述するため、見落とされがちな副作用（Side Effect）やグローバル変数（Global Variables）に依存しなくなります。

3. 実戦ケーススタディ

実際の開発シーンにおける多値戻り値の幅広い応用を見てみましょう。

3.1 ケース 1：データベースクエリ（オブジェクト + エラー）

ID に基づいてデータベースからユーザー情報を取得する場合、データが見つかることもあれば、見つからない（あるいは接続が切断される）こともあります。

package main

import (
	"fmt"
	"errors"
)

type User struct {
	Name  string
	Email string
}

// getUser はデータベースクエリをシミュレートし、User 構造体と発生し得る error を返します
func getUser(id int) (User, error) {
	if id == 123 {
		return User{Name: "John Doe", Email: "[email protected]"}, nil
	}
    // 該当ユーザーがいない場合、空の User とエラーを返します
	return User{}, errors.New("ユーザーが見つかりません")
}

func main() {
    // 存在するユーザーをクエリ
	user, err := getUser(123)
	if err != nil {
		fmt.Println("エラー:", err)
	} else {
	    // %+v は構造体のフィールド名を含めて出力します
	    fmt.Printf("ユーザーを発見: %+v\n", user) 
    }

    // 存在しないユーザーをクエリ
	user, err = getUser(456)
	if err != nil {
		fmt.Println("エラー:", err) // 出力: エラー: ユーザーが見つかりません
	}
}

3.2 ケース 2：状態付きパーサー（データ + ブールフラグ）

操作が必ずしも深刻な「エラー（error）」を生むわけではなく、単に「ヒットしなかった」あるいは「不適合」である場合があります。この際、ステータスフラグとしてブール値 ok を返すのが一般的です（このパターンは Go において "comma ok" イディオムと呼ばれます）。

package main

import (
	"fmt"
	"strconv"
)

// parseInt は文字列のパースを試み、パース後の整数と成功したかを示す bool フラグを返します
func parseInt(s string) (int, bool) {
	i, err := strconv.Atoi(s)
	if err != nil {
		return 0, false // パース失敗時、0 と false を返します
	}
	return i, true // パース成功時、数値と true を返します
}

func main() {
	num, ok := parseInt("123")
	if ok {
		fmt.Println("パース成功、数値は:", num)
	} 

	num, ok = parseInt("abc")
	if !ok {
		fmt.Println("パース失敗、有効な整数ではありません")
	}
}

3.3 ケース 3：名前付き戻り値の高度な応用

前章で触れた名前付き戻り値（Named Return Values）を振り返りましょう。関数が複数の戻り値を持ち、計算ロジックが長くなる場合、戻り値に名前を付けることで、関数シグネチャ自体がドキュメントのような役割を果たします。

package main

import "fmt"

// シグネチャ内で width と height という 2 つの変数を直接定義しています
func getRectangleDimensions() (width int, height int) {
	width = 10
	height = 5
	return // 裸の return：現在の width と height の値を自動的に返します
}

func main() {
	w, h := getRectangleDimensions()
	fmt.Printf("幅: %d, 高さ: %d\n", w, h)
}