Matcher region(int, int) method in Java with Examples
The region(int, int) method of Matcher Class restricts the region to be matched by the pattern. This region must be lesser than or same as the previous region, but not greater. Else it would lead to IndexOutOfBoundsException. This method returns a Matcher with the new matching region. Syntax:
public Matcher region(int startIndex, int endIndex)
Parameters: This method takes two parameters:
- startIndex which is the starting index of the new constrained region.
- endIndex which is the ending index of the new constrained region.
Return Value: This method returns a Matcher with the region, to be matched, constrained. Exception: This method throws IndexOutOfBoundsException if:
- startIndex or endIndex is less than zero,
- startIndex or endIndex is greater than the length of the input sequence,
- startIndex is greater than endIndex.
Below examples illustrate the Matcher.region() method: Example 1:Â
Java
// Java code to illustrate region() methodÂ
import java.util.regex.*;Â
public class GFG {Â Â Â Â public static void main(String[] args)Â Â Â Â {Â
        // Get the regex to be checked        String regex = "(Geeks)";Â
        // Create a pattern from regex        Pattern pattern = Pattern.compile(regex);Â
        // Get the String to be matched        String stringToBeMatched            = "GeeksForGeeks Geeks for Geeks Geek";Â
        // Create a matcher for the input String        Matcher matcher            = pattern.matcher(stringToBeMatched);Â
        System.out.println("Before changing region, "                           + " Groups found are: ");Â
        while (matcher.find()) {Â
            // Get the group matched using group() method            System.out.println(matcher.group());        }Â
        System.out.println("\nAfter changing region, "                           + " Groups found are: ");Â
        // Restrict the region to 0, 10        // using region() method        Matcher matcher1            = matcher.region(0, 10);Â
        while (matcher1.find()) {Â
            // Get the group matched using group() method            System.out.println(matcher1.group());        }    }} |
Output:
Before changing region, Groups found are: Geeks Geeks Geeks Geeks After changing region, Groups found are: Geeks
Example 2:Â
Java
// Java code to illustrate region() methodÂ
import java.util.regex.*;Â
public class GFG {Â Â Â Â public static void main(String[] args)Â Â Â Â {Â
        // Get the regex to be checked        String regex = "(FGF)";Â
        // Create a pattern from regex        Pattern pattern            = Pattern.compile(regex);Â
        // Get the String to be matched        String stringToBeMatched            = "FGF GFG GFG FGF";Â
        // Create a matcher for the input String        Matcher matcher            = pattern.matcher(stringToBeMatched);Â
        System.out.println("Before changing region, "                           + " Groups found are: ");Â
        while (matcher.find()) {Â
            // Get the group matched using group() method            System.out.println(matcher.group());        }Â
        System.out.println("\nAfter changing region, "                           + " Groups found are: ");Â
        // Restrict the region to 0, 5        // using region() method        Matcher matcher1 = matcher.region(0, 5);Â
        while (matcher1.find()) {Â
            // Get the group matched using group() method            System.out.println(matcher1.group());        }    }} |
Output:
Before changing region, Groups found are: FGF FGF After changing region, Groups found are: FGF
Reference: https://docs.oracle.com/javase/9/docs/api/java/util/regex/Matcher.html#region-int-int-
