中級

gsub! は置換が発生しないと nil を返す（gsub との違い）

破壊的メソッドのgsub!やsub!は、置換対象が見つかって実際に変更が起きた場合は変更後の文字列を、何も置換されなかった場合はnilを返します。戻り値をそのまま次のメソッドにつなげると、置換が起きなかった入力でNoMethodErrorになります。

エラーメッセージの読み方

main.rb:3:in `<main>': undefined method `upcase' for nil (NoMethodError)

main.rb

ファイル名

3

行番号 — 実際にクラッシュした行

<main>

発生場所 — <main> ならトップレベル、メソッド名ならそのメソッドの中

NoMethodError

例外クラス — 何が起きたか。ここを検索するのが最短です

undefined method `upcase' for nil

詳細メッセージ — どの値が問題だったか

このエラーが出る典型パターン

 1  text = "hello"
 2  result = text.gsub!("x", "y")
                    ^
 3  puts result.upcase

 1  word = "ruby"
 2  result = word.gsub!("z", "q")
                    ^
 3  puts result.length

 1  line = "sample"
 2  result = line.gsub!("!", "?")
                    ^
 3  puts result.reverse

 1  note = "memo"
 2  result = note.gsub!("x", "y")
                    ^
 3  puts result.capitalize

 1  title = "draft"
 2  result = title.gsub!("q", "w")
                     ^
 3  puts result.upcase

よくある誤解

「gsub!もgsubと同じく、変更後の文字列を常に返すはず」という思い込みは誤りです。gsub!は「変更があったかどうか」を戻り値で表現する設計になっており、変更が無ければnilが返ります。

まとめ

gsub! は置換が発生しないと nil を返す（gsub との違い）は中級でつまずきやすい項目です。上の5パターンを実際に手で直すと、エラーメッセージのどこを読めばよいかが掴めます。

演習をはじめる

関連するエラー

• each は配列を変換しない（map との違い）eachブロックの中で要素を加工しても、eachの戻り値はレシーバ自身（変更前の配列）のままです。
• FrozenError: can't modify frozen String の原因と直し方freezeしたオブジェクトを破壊的メソッド（<<やupcase!など）で変更しようとすると、FrozenErrorになります。