Matcher Class

Introduction

The java.util.regex.Matcher class acts as an engine that performs match operations on a character sequence by interpreting a Pattern.

Class declaration

Following is the declaration for java.util.regex.Matcher class −

public final class Matcher
   extends Object
      implements MatchResult

Learn Java in-depth with real-world projects through our Java certification course. Enroll and become a certified expert to boost your career.

Class methods

Sr.NoMethod & Description
1Matcher appendReplacement(StringBuffer sb, String replacement)Implements a non-terminal append-and-replace step.
2StringBuffer appendTail(StringBuffer sb)Implements a terminal append-and-replace step.
3int end()Returns the offset after the last character matched.
4int end(int group)Returns the offset after the last character of the subsequence captured by the given group during the previous match operation.
5boolean find()Attempts to find the next subsequence of the input sequence that matches the pattern.
6boolean find(int start)Resets this matcher and then attempts to find the next subsequence of the input sequence that matches the pattern, starting at the specified index.
7String group()Returns the input subsequence captured by the given group during the previous match operation.
8String group(String name)Returns the input subsequence captured by the given named-capturing group during the previous match operation.
9int groupCount()Returns the number of capturing groups in this matcher’s pattern.
10boolean hasAnchoringBounds()Queries the anchoring of region bounds for this matcher.
11boolean hasTransparentBounds()Queries the transparency of region bounds for this matcher.
12boolean hitEnd()Returns true if the end of input was hit by the search engine in the last match operation performed by this matcher.
13boolean lookingAt()Attempts to match the input sequence, starting at the beginning of the region, against the pattern.
14boolean matches()Attempts to match the entire region against the pattern.
15Pattern pattern()Returns the pattern that is interpreted by this matcher.
16static String quoteReplacement(String s)Returns a literal replacement String for the specified String.
17Matcher region(int start, int end)Sets the limits of this matcher’s region.
18int regionEnd()Reports the end index (exclusive) of this matcher’s region.
19int regionStart()Reports the start index of this matcher’s region.
20String replaceAll(String replacement)Replaces every subsequence of the input sequence that matches the pattern with the given replacement string.
21String replaceFirst(String replacement)Replaces the first subsequence of the input sequence that matches the pattern with the given replacement string.
22boolean requireEnd()Returns true if more input could change a positive match into a negative one.
23Matcher reset()Resets this matcher.
24Matcher reset(CharSequence input)Resets this matcher with a new input sequence.
25int start()Returns the start index of the previous match.
26int start(int group)Returns the start index of the subsequence captured by the given group during the previous match operation.
27MatchResult toMatchResult()Returns the match state of this matcher as a MatchResult.
28String toString()Returns the string representation of this matcher.
29Matcher useAnchoringBounds(boolean b)Sets the anchoring of region bounds for this matcher.
30Matcher usePattern(Pattern newPattern)Changes the Pattern that this Matcher uses to find matches with.
31Matcher useTransparentBounds(boolean b)Sets the transparency of region bounds for this matcher.

Methods inherited

This class inherits methods from the following classes −

  • Java.lang.Object

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *