Course contentsShow
← Java
Lesson 2271 of 2,87044. Regular ExpressionsFree lesson

Using groupCount() to Determine Group Count

Call Matcher.groupCount() to find how many capturing groups are defined in your pattern.

Using groupCount() to Determine Group Count

What you'll learn: How to discover the number of capturing groups defined in your regular expression pattern using the groupCount() method.

Understanding Group Count

When working with complex regular expressions, you might define multiple capturing groups to extract different pieces of information. The Matcher.groupCount() method tells you exactly how many capturing groups your pattern contains—excluding group 0 (which always represents the entire match).

Think of groupCount() as asking "How many parenthesized sections did I create in my regex?" It's particularly useful when you're working with dynamic patterns or need to iterate through all captured groups without hard-coding their numbers.

How groupCount() Works

The method returns an int representing the total number of capturing groups. Remember:

  • Group 0 (the full match) is not counted
  • Only (...) parentheses count—non-capturing groups (?:...) don't increment the count
  • Nested groups each get their own count

Basic Example

Pattern pattern = Pattern.compile("(\\d{3})-(\\d{2})-(\\d{4})");
Matcher matcher = pattern.matcher("123-45-6789");

int count = matcher.groupCount();
// count is 3 (three sets of parentheses)

if (matcher.matches()) {
    for (int i = 1; i <= matcher.groupCount(); i++) {
        System.out.println("Group " + i + ": " + matcher.group(i));
    }
}

Dynamic Group Extraction

Pattern pattern = Pattern.compile("(\\w+)@(\\w+)\\.(\\w+)");
Matcher matcher = pattern.matcher("user@example.com");

if (matcher.matches()) {
    System.out.println("Found " + matcher.groupCount() + " groups");
    // Output: Found 3 groups
}

Key Takeaway: Use groupCount() to discover how many capturing groups exist in your pattern, enabling dynamic group processing without hard-coding group numbers. Remember it excludes group 0.