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

Resetting and Reusing Matchers

Using matcher.reset() to reuse a Matcher on the same or different input, avoiding recompilation overhead.

Resetting and Reusing Matchers

You'll learn how to efficiently reuse a Matcher object on different inputs without the overhead of recompiling regular expression patterns.

Why Reset Instead of Recreate?

When you compile a Pattern, Java performs expensive operations to parse and optimize your regular expression. If you need to apply the same pattern to multiple strings, creating a new Matcher each time is wasteful. Instead, you can reuse the same Matcher by calling reset().

Think of it like a metal detector: instead of buying a new detector for each beach you visit, you simply reset the same device to scan a new area.

How matcher.reset() Works

The reset() method has two forms:

reset() with no arguments — resets the matcher to the beginning of its current input string, allowing you to search again from the start.

reset(CharSequence input) with new input — replaces the input string entirely and resets the matcher state, letting you apply the same compiled pattern to completely different text.

Performance Impact

By reusing a Matcher, you:

  • Avoid recompiling the Pattern (which can be slow for complex regex)
  • Reduce object allocation overhead
  • Keep the pattern's optimized internal state

This matters most in loops or high-throughput scenarios where you're matching the same pattern against many different strings.

Typical Usage Pattern

Pattern pattern = Pattern.compile("\\d+");
Matcher matcher = pattern.matcher("First: 123");

// Use matcher...
matcher.find(); // finds "123"

// Reuse on different input
matcher.reset("Second: 456");
matcher.find(); // now finds "456"

Key Takeaway: Use matcher.reset() to reuse a Matcher on the same or new input, avoiding the performance cost of recompiling patterns—especially important in loops or performance-critical code.