JavaのMatchResultインターフェースgroupCount()メソッドの使い方と実行例

java.util.regex.MatchResultインターフェースは、正規表現によるマッチ処理の結果を取得するための各種メソッドを提供しています。

このインターフェースのオブジェクトは、MatcherクラスのtoMatchResult()メソッドを使用して取得できます。このメソッドは、現在のマッチャーが保持しているマッチ状態を表すMatchResultオブジェクトを返します。

そして、このインターフェースが持つgroupCount()メソッドは、対象となる正規表現に含まれるキャプチャリンググループの数をカウントし、その値をint型として返します。

groupCount()メソッドのポイント

• 戻り値は「グループの総数」であり、グループ0（パターン全体に一致する部分）は含まれません。
• 括弧（）で囲まれた部分が1つのグループとしてカウントされます。

サンプルプログラム

以下の例では、ユーザーから入力を受け取り、正規表現 (.*)(\d+)(.*) とのマッチを行った後、toMatchResult()でMatchResultオブジェクトを取得し、groupCount()によってグループ数を出力しています。

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

public class GroupCount {
    public static void main( String args[] ) {
        String regex = "(.*)(\\d+)(.*)";
        // ユーザーからの入力を読み込む
        Scanner sc = new Scanner(System.in);
        System.out.println("入力テキストを入力してください: ");
        String input = sc.nextLine();
        // Patternクラスのインスタンス化
        Pattern pattern = Pattern.compile(regex);
        // Matcherクラスのインスタンス化
        Matcher matcher = pattern.matcher(input);
        // マッチが発生したかどうかを確認
        if(matcher.find()) {
            System.out.println("マッチが見つかりました");
        }
        // MatchResultオブジェクトを取得
        MatchResult res = matcher.toMatchResult();
        // グループ数を取得して表示
        int count = res.groupCount();
        System.out.println("グループの数: "+count);
    }
}

実行結果

入力テキストを入力してください:
This is a sample Text, 123
マッチが見つかりました
グループの数: 3

この出力から分かるように、正規表現 (.*)(\d+)(.*) には3つの括弧で囲まれたグループが含まれているため、groupCount()メソッドは3を返します。