java.util.regex

Class Matcher

public final class Matcher extends Object implements MatchResult

Instance of a regular expression applied to a char sequence.

Since: 1.4

Method Summary
Matcher	appendReplacement(StringBuffer sb, String replacement)
StringBuffer	appendTail(StringBuffer sb)
int	end()
int	end(int group)
boolean	find()
boolean	find(int start)
String	group()
String	group(int group)
int	groupCount()
boolean	hitEnd()
boolean	lookingAt()
boolean	matches() Attempts to match the entire input sequence against the pattern.
Pattern	pattern() Returns the Pattern that is interpreted by this Matcher
String	replaceAll(String replacement)
String	replaceFirst(String replacement)
Matcher	reset()
Matcher	reset(CharSequence input)
int	start()
int	start(int group)
String	toString()

Method Detail

appendReplacement

public Matcher appendReplacement(StringBuffer sb, String replacement)

Parameters: sb The target string buffer replacement The replacement string

Throws: IllegalStateException If no match has yet been attempted, or if the previous match operation failed IndexOutOfBoundsException If the replacement string refers to a capturing group that does not exist in the pattern

appendTail

public StringBuffer appendTail(StringBuffer sb)

Parameters: sb The target string buffer

end

public int end()

Throws: IllegalStateException If no match has yet been attempted, or if the previous match operation failed

end

public int end(int group)

Parameters: group The index of a capturing group in this matcher's pattern

find

public boolean find()

find

public boolean find(int start)

Parameters: start The index to start the new pattern matching

Throws: IndexOutOfBoundsException If the replacement string refers to a capturing group that does not exist in the pattern

group

public String group()

Throws: IllegalStateException If no match has yet been attempted, or if the previous match operation failed

group

public String group(int group)

Parameters: group The index of a capturing group in this matcher's pattern

groupCount

public int groupCount()

hitEnd

public boolean hitEnd()

Returns: True if and only if the matcher hit the end of input.

lookingAt

public boolean lookingAt()

matches

public boolean matches()

Attempts to match the entire input sequence against the pattern. If the match succeeds then more information can be obtained via the start, end, and group methods.