Pattern matcher(CharSequence) method in Java with Examples

Last Updated : 14 Apr, 2023

The matcher(CharSequence) method of the Pattern class used to generate a matcher that will helpful to match the given input as parameter to method against this pattern. The Pattern.matcher() method is very helpful when we need to check a pattern against a text a single time, and the default settings of the Pattern class are appropriate.

Syntax:

public Matcher matcher(CharSequence input)

Parameters: This method accepts a single parameter input which represents the character sequence to be matched.

Return Value: This method returns a new matcher for this pattern.

Below programs illustrate the matcher(CharSequence) method:

Program 1:

Java

// Java program to demonstrate
// Pattern.matcher(CharSequence) method

import java.util.regex.*;

public class GFG {
    public static void main(String[] args)
    {
        // create a REGEX String
        String REGEX = &quot;(.*)(ee)(.*)?&quot;;

        // create the string
        // in which you want to search
        String actualString
            = &quot;geeksforgeeks&quot;;

        // create a Pattern
        Pattern pattern = Pattern.compile(REGEX);

        // get a matcher object
        Matcher matcher = pattern.matcher(actualString);

        // print values if match found
        boolean matchfound = false;
        while (matcher.find()) {
            System.out.println(&quot;found the Regex in text:&quot;
                               + matcher.group()
                               + &quot; starting index:&quot; + matcher.start()
                               + &quot; and ending index:&quot;
                               + matcher.end());

            matchfound = true;
        }
        if (!matchfound) {
            System.out.println(&quot;No match found for Regex.&quot;);
        }
    }
}

Output:

found the Regex in text:geeksforgeeks starting index:0 and ending index:13

Program 2:

Java

// Java program to demonstrate
// Pattern.matcher(CharSequence) method

import java.util.regex.*;

public class GFG {
    public static void main(String[] args)
    {
        // create a REGEX String
        String REGEX = &quot;(.*)(welcome)(.*)?&quot;;

        // create the string
        // in which you want to search
        String actualString
            = &quot;geeksforgeeks&quot;;

        // create a Pattern
        Pattern pattern = Pattern.compile(REGEX);

        // get a matcher object
        Matcher matcher = pattern.matcher(actualString);

        // print values if match found
        boolean matchfound = false;
        while (matcher.find()) {
            System.out.println(&quot;match found&quot;);
            matchfound = true;
        }
        if (!matchfound) {
            System.out.println(&quot;No match found&quot;);
        }
    }
}