Rubyでプログラミングを行う際、文字列の操作は避けて通れない非常に重要な要素です。

特に既存の文字列の一部を別の文字に置き換える「置換」の処理は、データ整形やログ解析などの幅広い場面で利用されます。

Rubyには文字列を置換するための便利なメソッドとして、subgsubという2つの代表的なメソッドが用意されています。

これらのメソッドを適切に使い分けることで、コードの可読性を高め、効率的な開発が可能になります。

本記事では、文字列置換の基本から正規表現を用いた高度なテクニックまでを順を追って詳しく解説します。

Rubyにおける文字列置換の基本概念

Rubyの文字列置換において、最も基本的なメソッドはsubメソッドとgsubメソッドの2つです。

これら2つの主な違いは、置換対象となる箇所の数にあります。

subは「substitution(代入)」の略であり、最初に見つかった1箇所だけを置換します。

一方でgsubは「global substitution(全置換)」の略であり、一致するすべての箇所を置換します。

この違いを正しく理解することが、意図しないバグを防ぐための第一歩となります。

1つだけ置換するsubメソッド

subメソッドは、対象の文字列の中で最初に出現したパターンのみを新しい文字列に置き換えます。

例えば、文章の中にある特定の単語を1つだけ修正したい場合に適しています。

Ruby
# subメソッドの基本使用例
text = "apple, orange, apple"
result = text.sub("apple", "banana")
puts result
実行結果
banana, orange, apple

上記の実行結果を見ると、最初の「apple」だけが「banana」に置換されていることがわかります。

2番目の「apple」は置換されずにそのまま残っている点に注目してください。

すべてを置換するgsubメソッド

gsubメソッドは、文字列内にある一致するパターンをすべて探し出し、それらすべてを置換します。

一括でデータをクレンジングしたい場合や、共通の記号を削除したい場合に非常に強力です。

Ruby
# gsubメソッドの基本使用例
text = "apple, orange, apple"
result = text.gsub("apple", "banana")
puts result
実行結果
banana, orange, banana

gsubを使用すると、すべての「apple」が「banana」に置き換わっていることが確認できます。

破壊的メソッドと非破壊的メソッドの違い

Rubyのメソッドには、元のオブジェクトを書き換える「破壊的メソッド」と、新しいオブジェクトを返す「非破壊的メソッド」が存在します。

これまで紹介したsubgsubは非破壊的メソッドであり、元の文字列自体は変更されません。

もし元の文字列そのものを変更したい場合は、メソッド名の末尾に「!」を付けた破壊的メソッドを使用します。

Ruby
# 破壊的メソッドの例
text = "hello"
text.gsub!("l", "r")
puts text
実行結果
herro

変数 text の中身自体が書き換わっていることに注意してください。

破壊的メソッドを使用する際は、プログラムの他の場所でその変数が参照されていないか慎重に検討する必要があります。

正規表現を用いた高度な置換

Rubyの置換メソッドは、引数に単純な文字列だけでなく、正規表現を渡すことができます。

正規表現を利用することで、特定の文字列だけでなく「数字すべて」や「特定のパターンの単語」などを柔軟に指定できます。

パターンマッチングによる置換

例えば、文字列の中に含まれる数字をすべて「*」に置き換えたい場合は、正規表現 /\d/ を使用します。

Ruby
# 正規表現を使った置換
phone = "090-1234-5678"
result = phone.gsub(/\d/, "*")
puts result
実行結果
***-****-****

このように、具体的な文字列が不明であっても「パターン」を指定することで柔軟な処理が可能になります。

後方参照の活用

正規表現でキャプチャした部分を置換後の文字列で再利用する「後方参照」という手法もあります。

置換後の文字列内で \1\2 と記述することで、正規表現内の () で囲った部分を引用できます。

Ruby
# 後方参照の例(日付の形式を変更する)
date = "2026/01/23"
result = date.sub(/(\d{4})\/(\d{2})\/(\d{2})/, '\1年\2月\3日')
puts result
実行結果
2026年01月23日

複雑な文字列のフォーマット変換において、後方参照は非常に効率的な手段となります。

ブロックやハッシュを使用した柔軟な置換

Rubyのgsubメソッドは、引数にハッシュを渡したり、ブロックを伴って呼び出すことも可能です。

これにより、条件に応じた複雑な置換処理を1行で記述できるようになります。

ハッシュによる複数パターンの同時置換

複数の異なる単語をそれぞれの対応する言葉に一括で置き換えたい場合、ハッシュを引数に渡すのが便利です。

Ruby
# ハッシュを用いた一括置換
mapping = {"A" => "エース", "K" => "キング", "Q" => "クイーン"}
text = "A, K, Q"
result = text.gsub(/[AKQ]/, mapping)
puts result
実行結果
エース, キング, クイーン

この方法を使えば、複数の gsub を繋げて書く必要がなくなり、パフォーマンスの向上とコードの簡略化が期待できます。

ブロックによる動的な置換処理

置換後の文字列を計算や条件分岐によって決定したい場合は、ブロックを使用します。

ブロック内では、マッチした文字列が引数として渡されます。

Ruby
# ブロックを用いた動的な置換
text = "価格は100円、送料は50円です。"
result = text.gsub(/\d+/) do |match|
  (match.to_i * 1.1).to_i # 10%税込価格に変換
end
puts result
実行結果
価格は110円、送料は55円です。

マッチした部分ごとに異なる処理を行えるため、非常に自由度の高い置換が実現できます。

置換メソッド使用時の注意点とパフォーマンス

Rubyで文字列置換を行う際、パフォーマンスについても意識しておくことが重要です。

大量のテキストに対して置換を繰り返す場合、非破壊的な gsub を何度も呼び出すと、その都度新しい文字列オブジェクトが生成されます。

メモリ消費を抑えたい場合は、破壊的な gsub! を使用することを検討してください。

ただし、gsub! は一致するパターンが見つからなかった場合に nil を返すという性質があります。

そのため、メソッドチェーンの中で gsub! を使用すると、予期せぬエラーの原因となることがあります。

安全に処理を行うためには、戻り値が nil になる可能性を考慮するか、基本的には非破壊的なメソッドを使用するのが推奨されます。

よく使われる置換パターン一覧

メソッド目的破壊性の有無
sub最初の1箇所のみ置換非破壊的
gsub一致するすべての箇所を置換非破壊的
sub!最初の1箇所のみ置換(自身を変更)破壊的
gsub!すべてを置換(自身を変更)破壊的
tr文字単位での一括置換非破壊的

上記の表のように、目的に応じて最適なメソッドを選択することが大切です。

特に、単一の文字を別の文字に置き換えるだけであれば、gsub よりも高速な tr メソッドが利用できる場合もあります。

まとめ

Rubyでの文字列置換は、subgsubを使い分けることから始まります。

1箇所のみを置換したいのか、あるいは全体を置換したいのかによって、適切なメソッドを選択しましょう。

さらに正規表現を組み合わせることで、複雑な条件での置換もスムーズに行えるようになります。

ハッシュやブロックを活用した高度なテクニックをマスターすれば、Rubyらしい簡潔で強力なコードを書くことができます。

本記事で紹介した内容を参考に、日々の開発業務で効率的な文字列操作を実践してみてください。

破壊的メソッドの挙動や、正規表現による後方参照など、細かい仕様を把握しておくことが確実なプログラミングに繋がります。