Java正規表現で一致した文字列をすべて置き換える方法｜replaceAll()の使い方

Javaで正規表現を扱う際、入力文字列の中からパターンに一致した部分を別の文字列へ置き換えたいケースはよくあります。そのような場合には、MatcherクラスのreplaceAll()メソッドを使用します。

基本的な手順は以下のとおりです。

1. Pattern.compile()メソッドで正規表現をコンパイルし、Patternオブジェクトを作成する
2. Patternオブジェクトのmatcher()メソッドに入力文字列を渡し、Matcherオブジェクトを取得する
3. MatcherオブジェクトのreplaceAll()メソッドを呼び出して、一致したすべての箇所を置換する

replaceAll()メソッドは、引数として置換後の文字列を受け取り、入力文字列内のすべての一致箇所をその文字列で置き換えた結果を返します。元の文字列自体は変更されず、新しい文字列が返される点に注意してください。

例1：タブ文字をスペースに置き換える

import java.util.Scanner;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class ReplaceAll {
    public static void main(String[] args) {
        Scanner sc = new Scanner(System.in);
        System.out.println("Enter input text: ");
        String input = sc.nextLine();
        String regex = "\\t+";
        // Patternオブジェクトを作成
        Pattern pattern = Pattern.compile(regex);
        // 文字列に対してコンパイル済みパターンを適用
        Matcher matcher = pattern.matcher(input);
        int count = 0;
        while (matcher.find()) {
            count++;
        }
        System.out.println("No.of matches: " + count);
        String result = matcher.replaceAll(" ");
        System.out.println("Result: " + result);
    }
}

実行結果

Enter input text:
sample	text	with	tab	spaces
No.of matches: 4
Result: sample text with tab spaces

この例では、正規表現「\t+」によって1つ以上連続するタブ文字に一致させ、それらをすべて半角スペース1つに置き換えています。まずfind()メソッドで一致件数をカウントし、その後replaceAll()で一括置換を行っています。

なお、すべてではなく最初に一致した箇所だけを置き換えたい場合は、MatcherクラスのreplaceFirst()メソッドを使用します。

例2：最初の数字だけを置き換える

import java.util.Scanner;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class ReplaceAll {
    public static void main(String[] args) {
        Scanner sc = new Scanner(System.in);
        System.out.println("Enter input text: ");
        String input = sc.nextLine();
        String regex = "\\d";
        // Patternオブジェクトを作成
        Pattern pattern = Pattern.compile(regex);
        // 文字列に対してコンパイル済みパターンを適用
        Matcher matcher = pattern.matcher(input);
        int count = 0;
        while (matcher.find()) {
            count++;
        }
        System.out.println("No.of matches: " + count);
        String result = matcher.replaceFirst("#");
        System.out.println("Result: " + result);
    }
}

実行結果

Enter input text:
test data 1 2 3
No.of matches: 3
Result: test data # 2 3

この例では、正規表現「\d」（1桁の数字）に一致する箇所が3件見つかっていますが、replaceFirst()を使用しているため、最初の「1」だけが「#」に置き換えられ、残りの「2」と「3」はそのまま出力されます。

まとめ

• 入力文字列内のすべての一致箇所を置換する → replaceAll()
• 最初の一致箇所のみを置換する → replaceFirst()

どちらのメソッドも置換結果を新しい文字列として返すため、必要に応じて変数に代入して活用しましょう。