Go言語のエラーとreturn値の設計パターン！初心者でもわかる基本と使い方

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

生徒

「先生、Go言語で関数がエラーを返す時って、どうやって返り値とエラーを一緒に扱えばいいんですか？」

先生

「とても良い質問です。Goではエラーをerror型で返しながら、結果の値も一緒に返す設計パターンがよく使われます。基本の考え方から説明しますね。」

生徒

「エラーと返り値をどう分けるのか、イメージがわかないです。具体的な例はありますか？」

先生

「はい。関数が成功したときは結果の値とnil（エラーなし）を返し、失敗したときは結果の値は無意味でエラーを返す、これが基本です。」

1. Go言語の関数のreturn値におけるエラー設計の基本

Goでは関数の戻り値に複数の値を返せます。例えば「処理の結果」と「エラーの情報」を一緒に返せるのが特徴です。

ここで出てくるのがerror型です。error型は「エラーかどうか」「どんなエラーか」を示すための特別な型で、失敗した時に詳しい情報を伝える役割を持っています。

例えば、ファイルを読み込む関数があったとします。成功すれば読み込んだ内容とnil（エラーなし）を返し、失敗すればnilの内容とエラー情報を返します。

2. 典型的なエラーとreturn値の設計パターン

最もよく使われるパターンは、返り値が２つある関数です。一つ目は処理結果、二つ目はエラーを示す値です。


func readFile(filename string) (string, error) {
    content, err := os.ReadFile(filename)
    if err != nil {
        return "", err // エラーがあれば空文字とエラーを返す
    }
    return string(content), nil // 成功なら内容とnil（エラーなし）を返す
}

ここでポイントは、関数を呼ぶ側がエラーを必ず確認することです。確認しなければ、問題に気づかないまま処理が進んでしまいます。

3. エラーを返す意味と使い方

エラーは「失敗した理由」をプログラムに伝えます。だからエラーが返ってきたら、原因を調べたり、適切に処理を変えたりすることが重要です。

例えば、ファイルが見つからなかった場合はユーザーに通知し、ネットワークの問題なら再試行するといった処理が考えられます。

4. 複数のreturn値でエラーを扱うメリット

複数の値を返すことにより、エラー情報と結果を別々に扱えるため、コードの見通しが良くなります。エラー処理と正常処理を明確に分けられるので、安全で分かりやすい設計になります。

5. return値の設計パターンの応用例

時には処理結果が複数あることもあります。例えば値と状態を同時に返す場合です。


func getUser(id int) (User, bool, error) {
    user, found := findUserByID(id)
    if !found {
        return User{}, false, fmt.Errorf("ユーザーが見つかりません")
    }
    return user, true, nil
}

この例では、ユーザー情報（User型）、見つかったかどうか（bool）、エラー（error）の3つを返しています。

戻り値が複数でも、エラーがあるかどうかを一番最後に返すのが一般的なパターンです。

6. 返り値の名前付き設計

Goの関数では返り値に名前をつけられます。名前をつけると返す値が何か分かりやすくなります。


func divide(a, b int) (result int, err error) {
    if b == 0 {
        err = fmt.Errorf("0で割ることはできません")
        return
    }
    result = a / b
    return
}

名前付きのreturn値は、コードの読みやすさアップにつながります。ただし、使いすぎると逆に分かりにくくなることもあるので注意しましょう。

7. 覚えておきたいポイント

Go言語の関数設計では、戻り値で結果とエラーを分けて返すパターンが基本です。エラーはerror型で返し、成功したらnilを返すことで判別します。

呼び出し側は必ずエラーをチェックし、適切に処理を分けることが大切です。複数の戻り値を活用し、わかりやすいコードを書く習慣を身につけましょう。

まとめ

エラーとreturn値を正しく設計するための考え方

Go言語の関数設計で特徴的なのは、結果とエラーを同時に返すという仕組みが標準的に使われている点です。初心者のうちは「返り値が二つあると混乱しそう」と感じやすいのですが、慣れてくるとこの仕組みがとても合理的で、コードの読みやすさや安全性に大きく貢献していることが実感できるようになります。関数が「成功したのか失敗したのか」を呼び出し側が明確に判断でき、さらに失敗した場合には「なぜ失敗したのか」という理由まで伝えられるため、後から問題を追いかけるときにも役立ちます。

また、複数のreturn値を返すパターンにも柔軟に対応できるため、単純な成功/失敗だけではなく、追加情報やフラグを同時に返すこともできます。これにより、「どのような状況であっても正しく判断できる関数」を作ることが可能になり、プログラム全体の品質が自然と向上していきます。特に初心者は、まず「エラーは必ず最後に返し、呼び出し側が確認する」という基本をしっかり理解し、それを習慣にすることが大切です。

初心者向けのシンプルなreturnとエラー処理の例

次のサンプルは、Go言語の関数で「正常な値」と「エラー情報」を一緒に返す基本形を理解するための、もっともシンプルな例です。はじめてエラー処理を学ぶ人でも分かりやすい構造になっています。


package main

import (
    "fmt"
)

// 足し算をするが、マイナスの数が来た場合はエラーを返す簡単な関数
func addPositive(a, b int) (int, error) {
    if a < 0 || b < 0 {
        return 0, fmt.Errorf("マイナスの値は受け付けません")
    }
    return a + b, nil
}

func main() {
    result, err := addPositive(3, -1)
    if err != nil {
        fmt.Println("エラー:", err)
        return
    }
    fmt.Println("計算結果:", result)
}

このコードでは、マイナスの値が渡された場合にエラーを返し、呼び出し側でそのエラーを確認して処理を終了しています。成功した場合だけ結果が使われるため、処理の流れがとても明確です。「成功したら値とnil、失敗したら無意味な値とエラー」というパターンを自然に覚えられます。

複数のreturn値を活かした設計と理解の深め方

Go言語では複数の値を返せるため、状況に応じた柔軟な設計ができます。例えば、「見つかったかどうかを示すフラグ」や「部分的な成功を表す値」などを返すことで、関数の状態を細かく伝えることができます。これにより、呼び出し側はエラーだけで判断するのではなく、成功/失敗以外の追加情報まで踏まえて処理を分岐できます。慣れてくると、「この場合は値と成功フラグ、この場合はエラーだけ返せばいい」など、状況に応じた関数設計が自然とできるようになります。

また、エラーをわかりやすいメッセージで返しておくと、後から読み返したときに状況をすぐに把握でき、デバッグ時間の短縮にもつながります。さらに、エラーをラップすることで原因の追跡がしやすくなるため、複数の処理が重なる場面でも役に立ちます。こうした小さな工夫の積み重ねが、プログラム全体の信頼性を高めるポイントです。

先生と生徒の振り返り会話

生徒

「エラーと返り値を一緒に返す意味がようやくわかりました！ただ値を返すだけじゃなくて、失敗した理由も伝えられるんですね。」

先生

「その通りです。エラー情報があることで、関数を呼び出した側も柔軟に判断できるようになります。とても大切な設計の考え方ですよ。」

生徒

「複数のreturn値を使うことで、関数の意味がはっきりするのも面白かったです。初心者でも工夫しながら作れそうです！」

先生

「まさにそこがGo言語の魅力です。難しく考えすぎず、まずは基本パターンを繰り返し試してみてください。自然と理解が深まりますよ。」