Matcher requireEnd() method in Java with Examples

The requireEnd() method of Matcher Class is used to check if any combination of anchors has caused the match to be bounded at the end. These anchors can be any anchor like a word anchor, for instance, or a lookahead. This method returns a boolean value stating the same.

Syntax:

public boolean requireEnd()

Parameters: This method takes no parameters.

Return Value: This method returns a boolean value stating whether if any combination of anchors has caused the match to be bounded at the end.

Below examples illustrate the Matcher.requireEnd() method:

Example 1:

// Java code to illustrate requireEnd() method

import java.util.regex.*;

public class GFG {
    public static void main(String[] args)
    {

        // Get the regex to be checked
        // with an anchor
        String regex = "Geeks$";

        // Create a pattern from regex
        Pattern pattern
            = Pattern.compile(regex);

        // Get the String to be matched
        String stringToBeMatched
            = "GFG GFG GEEKS Geeks";

        // Create a matcher for the input String
        Matcher matcher
            = pattern.matcher(stringToBeMatched);

        matcher.find();

        // Check if a match has been found
        // using requireEnd() method
        System.out.println("Has any anchor "
                           + "bounded the search: "
                           + matcher.requireEnd());
    }
}

Output:

Has any anchor bounded the search: true

Example 2:

// Java code to illustrate requireEnd() method

import java.util.regex.*;

public class GFG {
    public static void main(String[] args)
    {

        // Get the regex to be checked
        // without any anchor
        String regex = "Geeks";

        // Create a pattern from regex
        Pattern pattern
            = Pattern.compile(regex);

        // Get the String to be matched
        String stringToBeMatched
            = "GFG GFG GEEKS Geeks";

        // Create a matcher for the input String
        Matcher matcher
            = pattern.matcher(stringToBeMatched);

        matcher.find();

        // Check if a match has been found
        // using requireEnd() method
        System.out.println("Has any anchor "
                           + "bounded the search: "
                           + matcher.requireEnd());
    }
}

Output:

Has any anchor bounded the search: false

Reference: https://docs.oracle.com/javase/9/docs/api/java/util/regex/Matcher.html#requireEnd–