Rubyの戻り値設計を完全攻略！nil・例外・結果オブジェクトの正しい選び方

1. 戻り値とは何か？

1. 戻り値とは何か？

Rubyのプログラムにおいて、メソッドという「命令のまとまり」が処理を終えた後に、呼び出し元に返してくれる結果のことを戻り値（もどりち）と呼びます。自動販売機を例にすると、お金を入れてボタンを押すという「命令」に対して、出てくる飲み物が「戻り値」にあたります。Rubyでは、メソッドの中で最後に評価された値が自動的に戻り値になります。この戻り値が何であるかを明確に設計することは、プログラムが正しく動くだけでなく、後から見返したときに分かりやすいコードにするために非常に重要です。プログラミング未経験の方は、まず「メソッドを実行したら、必ず何かしらの結果が手元に戻ってくる」というイメージを持ってください。

2. nilを返すケースとそのリスク

2. nilを返すケースとそのリスク

nil（ニル）とは、Rubyにおいて「何もない」ことを表す特別な値です。例えば、名簿から名前を探したけれど見つからなかった、という場合に「見つかりませんでした」という意味でnilを返すことがよくあります。これは非常に手軽な方法ですが、注意が必要です。戻ってきた値がnilであることを忘れて次の処理に進もうとすると、「NoMethodError」という、初心者が最もよく遭遇するエラーが発生してプログラムが止まってしまいます。nilを返すときは、「見つからないことが普通にあり得る」場面に限定し、受け取る側でもしっかりと「もし空っぽだったら」という確認を行う必要があります。

def find_user(id)
  users = { 1 => "田中", 2 => "佐藤" }
  # 指定した番号がない場合は nil が返る
  users[id]
end

result = find_user(3)

if result.nil?
  puts "ユーザーが見つかりませんでした"
else
  puts "こんにちは、#{result}さん"
end

ユーザーが見つかりませんでした

3. 例外（エラー）を発生させるケース

3. 例外（エラー）を発生させるケース

例外（れいがい）とは、プログラムの実行中に発生する「予期せぬ異常事態」のことです。Rubyでは raise という命令を使って、意図的にエラーを発生させることができます。戻り値としてエラーを返すのではなく、処理そのものを中断させるイメージです。これは、例えば「絶対に存在しなければいけない設定ファイルがない」とか、「計算が不可能な値が渡された」といった、処理をこれ以上続けられない深刻な状況で使います。何でもかんでも例外にするとプログラムがすぐに止まって使いにくくなりますが、重要なルールを破ったときに「ダメだよ！」と大きな声で知らせるためには欠かせない仕組みです。

def divide(a, b)
  if b == 0
    # 0で割ることはできないので、例外を発生させる
    raise "0で割ることはできません！"
  end
  a / b
end

begin
  puts divide(10, 0)
rescue => e
  puts "エラーが発生しました：#{e.message}"
end

エラーが発生しました：0で割ることはできません！

4. 真偽値（true/false）を返す設計

4. 真偽値（true/false）を返す設計

メソッドの名前が「～ですか？」という質問形式になっている場合、戻り値には true（真） または false（偽） を使います。Rubyでは慣習として、このようなメソッドの名前の末尾にクエスチョンマーク「?」を付けます。例えば、ログインしているかを確認する logged_in? や、空っぽかを確認する empty? などです。戻り値として真偽値を返すと、呼び出し側で if 文を使って直接条件分岐ができるため、非常にスッキリとした読みやすいコードになります。初心者の方は、まず「はい」か「いいえ」で答えられるような処理を作る練習から始めると、戻り値の扱いに慣れやすいでしょう。

5. 結果オブジェクト（Result Object）の活用

5. 結果オブジェクト（Result Object）の活用

少し高度な手法として、成功か失敗かだけでなく、その理由や詳細なデータもまとめて返したいときに結果オブジェクトを使います。これは、Rubyの Struct（構造体）や専用のクラスを作って、複数の情報を一つのセットにして戻す方法です。例えば、会員登録の処理で「成功したかどうか」に加えて「失敗したならそのエラーメッセージ」と「登録されたユーザーのID」を一緒に返したい場合があります。これをバラバラに返すと混乱しますが、一つの箱（オブジェクト）にまとめて返せば、呼び出し側は後から中身を取り出すだけで済みます。大規模な開発では、この「成功と失敗の情報を丁寧に包んで返す」設計が非常に重宝されます。

# 成功か失敗かを管理する箱を作る
RegistrationResult = Struct.new(:success, :message)

def register_user(name)
  if name.empty?
    return RegistrationResult.new(false, "名前が入力されていません")
  end
  # 登録処理が成功したと仮定
  RegistrationResult.new(true, "#{name}さんの登録が完了しました")
end

result = register_user("")
puts "成功しましたか？: #{result.success}"
puts "メッセージ: #{result.message}"

成功しましたか？: false
メッセージ: 名前が入力されていません

6. シンボルを使った状態の返却

6. シンボルを使った状態の返却

戻り値として、コロンから始まる シンボル を使うのもRubyらしいスマートな方法です。例えば、処理の結果が「成功( :success )」「保留( :pending )」「拒否( :rejected )」の三種類以上ある場合、数値や文字列で返すよりもシンボルのほうが高速で、書き間違いも防げます。文字列は一文字ずつ中身をチェックしますが、シンボルは同じ名前なら同じ物として扱われるため、比較がとても簡単です。複数のパターンがある状態をスマートに伝えたいときは、このシンボルを戻り値に選ぶことを検討してみてください。コードがまるで英語の文章のように読みやすくなります。

7. 戻り値を設計するときの優先順位

7. 戻り値を設計するときの優先順位

結局どれを選べばいいの？と迷ったときは、以下の優先順位で考えてみましょう。まず、単純な確認なら「真偽値（true/false）」を返します。次に、データを探す処理で見つからない可能性があるなら「nil」を返します。ただし、見つからないことが「あり得ない異常」なら「例外」を投げます。そして、処理の結果について詳しく伝えたいなら「結果オブジェクト」を作成します。このように、メソッドを呼び出す人が「その後どうしたいか」を想像して戻り値を決めるのが、良いプログラマーへの近道です。パソコンに詳しくない方でも、相手に何かを頼んだときに「どんな返事が来たら嬉しいか」を考えるのと同じことだと捉えてください。

8. 初心者が陥りやすい戻り値の罠

8. 初心者が陥りやすい戻り値の罠

最後によくある失敗を紹介します。それは「戻り値の種類がバラバラになってしまうこと」です。あるときは数字を返し、別のときは文字列を返し、さらに別のときはnilを返す……といったメソッドを作ってしまうと、使う人がパニックになります。可能な限り、一つのメソッドが返すデータの種類（型）は統一しましょう。また、戻り値を無視してプログラムを書いてしまうのもよくあるミスです。メソッドが返してくれた「結果」というプレゼントをしっかり受け取って、次の処理に活かす癖をつけましょう。Rubyは柔軟な言語ですが、だからこそ戻り値を丁寧に設計する優しさが、バグのない素晴らしいアプリを作る鍵となります。

# 悪い例：戻り値がバラバラ
def messy_method(num)
  if num > 0
    "プラスです"
  elsif num < 0
    -1
  else
    nil
  end
end

# 呼び出す側は何が返ってくるか予測しにくいため、扱いが大変になります