public final class Matcher extends Object implements MatchResult
Patternใ่งฃ้ใใใใจใซใใฃใฆใ ๆๅญใทใผใฑใณในใฎใใใๆไฝใ่กใใจใณใธใณใงใใ
ใใใใฃใฏใใใฟใผใณใฎmatcherใกใฝใใใๅผใณๅบใใใจใซใใฃใฆไฝๆใใใพใใ ไธๅบฆไฝๆใใใจใๆฌกใฎ3็จฎ้กใฎใใใๆไฝใซไฝฟ็จใงใใพใใ
matchesใกใฝใใใฏใๅ
ฅๅใทใผใฑใณในๅ
จไฝใจใใฟใผใณใใใใใใใ
lookingAtใกใฝใใใฏใๅ
ฅๅใทใผใฑใณในใฎๅ
้ ญใใๅงใใฆใใฟใผใณใใใใใใใ
findใกใฝใใใฏใๅ
ฅๅใทใผใฑใณในใ่ตฐๆปใใฆใใใฟใผใณใจใใใใใๆฌกใฎ้จๅใทใผใฑใณในใๆค็ดขใใใ
ใใใใฎใกใฝใใใฏใใใใใๆๅใใใใฉใใใ็คบใbooleanๅคใ่ฟใใพใใ ใใใใๆๅใใใจใใฏใใใใใฃใฎ็ถๆ ใ็ งไผใใใฐ่ฉณ็ดฐใๅๅพใงใใพใใ
ๆญฃ่ฆๆค็ดขใจใณใธใณใฏ้ ๅใจๅผใฐใใๅ
ฅๅใฎใตใใปใใใงใใใใๆค็ดขใใพใใ ใใใฉใซใใงใฏใ้ ๅใซใฏๆญฃ่ฆๆค็ดขใจใณใธใณใฎๅ
ฅๅใในใฆใๅซใพใใพใใ ้ ๅใๅคๆดใใใซใฏใregionใกใฝใใใไฝฟ็จใใ็
งไผใใใซใฏใregionStartใกใฝใใใใใณregionEndใกใฝใใใไฝฟ็จใใพใใ ้ ๅใฎๅข็ใซใใไธๅฎใฎใใฟใผใณไฝๆใฎๆนๆณใฏๅคๆดใงใใพใใ ่ฉณ็ดฐใฏใuseAnchoringBoundsใใใณuseTransparentBoundsใๅ็
งใใฆใใ ใใใ
ใใฎใฏใฉในใซใฏใใใใใใ้จๅใทใผใฑใณในใๆฐใใๆๅญๅใซ็ฝฎๆใใใกใฝใใใๅฎ็พฉใใพใใๆฐใใๆๅญๅใฎๅ
ๅฎนใฏใๅฟ
่ฆใซๅฟใใฆใใใ็ตๆใใ็ฎๅบใงใใพใใ appendReplacementใใใณappendTailใกใฝใใใๅๆใซไฝฟ็จใใใฐใ็ตๆใๅ้ใใฆๆขๅญใฎๆๅญๅใใใใกใซๆ ผ็ดใงใใพใใใพใใฏใใใไพฟๅฉใชreplaceAllใกใฝใใใไฝฟ็จใใใฐใๅ
ฅๅใทใผใฑใณในๅ
ใงใใใใใ้จๅใทใผใฑใณในใใในใฆ็ฝฎๆใใใๆๅญๅใไฝๆใงใใพใใ
ใใใใฃใฎๆ็คบ็ใช็ถๆ ใจใใฆใๆๅพใซๆๅใใใใใใฎ้ๅงใคใณใใใฏในใจ็ตไบใคใณใใใฏในใใใใพใใ ใพใใใใฟใผใณใฎๅๅๆนๅ็ งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใซใใฃใฆๅๆนๅ็ งใใใๅ ฅๅ้จๅใทใผใฑใณในใฎ้ๅงใคใณใใใฏในใจ็ตไบใคใณใใใฏในใใๅๆนๅ็ งใใใ้จๅใทใผใฑใณในใฎ็ทๆฐใๅฉ็จใใใพใใ ๅๆนๅ็ งใใใ้จๅใทใผใฑใณในใๆๅญๅๅฝขๅผใง่ฟใใกใฝใใใ็จๆใใใฆใใพใใ
ใใใใฃใฎๆ็คบ็ใช็ถๆ
ใฎๅๆๅคใฏๅฎ็พฉใใใฆใใพใใใใใใใๆๅใใๅใซใใฎไธ้จใ็
งไผใใใใจใใใจใIllegalStateExceptionใในใญใผใใใพใใ ใใใใฃใฎๆ็คบ็ใช็ถๆ
ใฏใใใใๆไฝใฎใใณใซ่จ็ฎใ็ดใใใพใใ
ใใใใฃใฎๆ้ป็ใช็ถๆ
ใซใฏใๅ
ฅๅๆๅญใทใผใฑใณในใ่ฟฝๅ ไฝ็ฝฎใใใใพใใ่ฟฝๅ ไฝ็ฝฎใฎๅๆๅคใฏใผใญใงใappendReplacementใกใฝใใใซใใฃใฆๆดๆฐใใใพใใ
ใใใใฃใใชใปใใใใใซใฏใใใใใฃใฎreset()ใกใฝใใใพใใฏreset(CharSequence)ใกใฝใใ(ๆฐใใๅ
ฅๅใทใผใฑใณในใๅฟ
่ฆใชๅ ดๅ)ใๅผใณๅบใใพใใ ใใใใฃใใชใปใใใใใจใใใฎๆ็คบ็ใช็ถๆ
ใซ้ขใใๆ
ๅ ฑใ็ ดๆฃใใใ่ฟฝๅ ไฝ็ฝฎใใผใญใซ่จญๅฎใใใพใใ
ใใฎใฏใฉในใฎใคใณในใฟใณในใฏใ่คๆฐใฎในใฌใใใงไธฆ่กใใฆไฝฟ็จใใใใจใฏใงใใพใใใ
| ไฟฎ้ฃพๅญใจๅ | ใกใฝใใ | ่ชฌๆ |
|---|---|---|
Matcher |
appendReplacement(StringBuffer sb, String replacement) |
็ถ็ถ่ฟฝๅ ็ฝฎๆในใใใใๅฎ่ฃ
ใใพใใ
|
StringBuffer |
appendTail(StringBuffer sb) |
็ตไบ่ฟฝๅ ็ฝฎๆในใใใใๅฎ่ฃ
ใใพใใ
|
int |
end() |
ๆๅพใซใใใใใๆๅญใฎๅพใฎใชใใปใใใ่ฟใใพใใ
|
int |
end(int group) |
ๅๅใฎใใใๆไฝใงๆๅฎใใใใฐใซใผใใซใใฃใฆๅๆนๅ็
งใใใ้จๅใทใผใฑใณในใฎใๆ็ตๆๅญใฎๅพใฎใชใใปใใใ่ฟใใพใใ
|
int |
end(String name) |
ๅๅใฎใใใๆไฝใงใๆๅฎใใใๅๅไปใใฎๅๆนๅ็
งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใซใใฃใฆๅๆนๅ็
งใใใ้จๅใทใผใฑใณในใฎใๆๅพใฎๆๅญใฎๅพใฎใชใใปใใใ่ฟใใพใใ
|
boolean |
find() |
ๅ
ฅๅใทใผใฑใณในใใใใฎใใฟใผใณใจใใใใใๆฌกใฎ้จๅใทใผใฑใณในใๆค็ดขใใพใใ
|
boolean |
find(int start) |
ใใฎใใใใฃใใชใปใใใใๆๅฎใใใใคใณใใใฏในไปฅ้ใฎๅ
ฅๅใทใผใฑใณในใใใใใฎใใฟใผใณใจใใใใใๆฌกใฎ้จๅใทใผใฑใณในใๆค็ดขใใพใใ
|
String |
group() |
ๅๅใฎใใใใงไธ่ดใใๅ
ฅๅ้จๅใทใผใฑใณในใ่ฟใใพใใ
|
String |
group(int group) |
ๅๅใฎใใใๆไฝใงๆๅฎใใใใฐใซใผใใซใใฃใฆๅๆนๅ็
งใใใๅ
ฅๅ้จๅใทใผใฑใณในใ่ฟใใพใใ
|
String |
group(String name) |
ๅๅใฎใใใๆไฝใงๆๅฎใใใๅๅไปใใฎๅๆนๅ็
งใ่กใใฐใซใผใใซใใฃใฆๅๆนๅ็
งใใใๅ
ฅๅ้จๅใทใผใฑใณในใ่ฟใใพใใ
|
int |
groupCount() |
ใใฎใใใใฃใฎใใฟใผใณใซๆๅฎใใใฆใใๅๆนๅ็
งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใฎๆฐใ่ฟใใพใใ
|
boolean |
hasAnchoringBounds() |
ใใฎใใใใฃใฎ้ ๅๅข็ใฎใขใณใซใผ่จญๅฎใๅใๅใใใใฏใจใชใผใๅบใใพใใ
|
boolean |
hasTransparentBounds() |
ใใฎใใใใฃใฎ้ ๅๅข็ใฎ้ๆๅบฆใๅใๅใใใใฏใจใชใผใๅบใใพใใ
|
boolean |
hitEnd() |
ใใฎๆญฃ่ฆๆค็ดขใจใณใธใณใๅฎ่กใใๆๅพใฎใใใๆไฝใงใๅ
ฅๅใฎๆซๅฐพใๆค็ดขใจใณใธใณใซใใใใใใใๅ ดๅใซใtrueใ่ฟใใพใใ
|
boolean |
lookingAt() |
ๅ
ฅๅใทใผใฑใณในใจใใฟใผใณใจใฎใใใใใ้ ๅใฎๅ
้ ญใใๅงใใพใใ
|
boolean |
matches() |
้ ๅๅ
จไฝใใใฎใใฟใผใณใจใใใใใพใใ
|
Pattern |
pattern() |
ใใฎใใใใฃใซใใฃใฆ่งฃ้ใใใใใฟใผใณใ่ฟใใพใใ
|
static String |
quoteReplacement(String s) |
ๆๅฎใใใ
Stringใฎใชใใฉใซ็ฝฎๆStringใ่ฟใใพใใ |
Matcher |
region(int start, int end) |
ๆญฃ่ฆๆค็ดขใจใณใธใณใฎ้ ๅใซๅถ้ใ่จญๅฎใใพใใ
|
int |
regionEnd() |
ใใฎๆญฃ่ฆๆค็ดขใจใณใธใณใฎ้ ๅใฎ็ตไบใคใณใใใฏใน(ใใฎๅคใๅซใพใชใ)ใใฌใใผใใใพใใ
|
int |
regionStart() |
ใใฎๆญฃ่ฆๆค็ดขใจใณใธใณใฎ้ ๅใฎ้ๅงใคใณใใใฏในใใฌใใผใใใพใใ
|
String |
replaceAll(String replacement) |
ใใฟใผใณใจใใใใใๅ
ฅๅใทใผใฑใณในใฎ้จๅใทใผใฑใณในใใๆๅฎใใใ็ฝฎๆๆๅญๅใซ็ฝฎใๆใใพใใ
|
String |
replaceFirst(String replacement) |
ใใฟใผใณใจใใใใใๅ
ฅๅใทใผใฑใณในใฎ้จๅใทใผใฑใณในใฎใใกใๆๅใฎ้จๅใทใผใฑใณในใๆๅฎใใใ็ฝฎๆๆๅญๅใซ็ฝฎใๆใใพใใ
|
boolean |
requireEnd() |
ใใๅคใใฎๅ
ฅๅใงๆญฃใฎใใใใ่ฒ ใฎใใใใซๅคๆดใใใๅฏ่ฝๆงใใใๅ ดๅใซใtrueใ่ฟใใพใใ
|
Matcher |
reset() |
ใใฎใใใใฃใใชใปใใใใพใใ
|
Matcher |
reset(CharSequence input) |
ๆฐใใๅ
ฅๅใทใผใฑใณในใไฝฟ็จใใฆใใฎใใใใฃใใชใปใใใใพใใ
|
int |
start() |
ๅๅใฎใใใใฎ้ๅงใคใณใใใฏในใ่ฟใใพใใ
|
int |
start(int group) |
ๅๅใฎใใใๆไฝใงๆๅฎใใใใฐใซใผใใซใใฃใฆๅๆนๅ็
งใใใ้จๅใทใผใฑใณในใฎใ้ๅงใคใณใใใฏในใ่ฟใใพใใ
|
int |
start(String name) |
ๅๅใฎใใใๆไฝใงๆๅฎใใใๅๅไปใๅๆนๅ็
งใฐใซใผใใซใใฃใฆๅๆนๅ็
งใใใ้จๅใทใผใฑใณในใฎ้ๅงใคใณใใใฏในใ่ฟใใพใใ
|
MatchResult |
toMatchResult() |
ใใฎใใใใฃใฎใใใ็ถๆ
ใ
MatchResultใจใใฆ่ฟใใพใใ |
String |
toString() |
ใใฎใใใใฃใฎๆๅญๅ่กจ็พใ่ฟใใพใใ
|
Matcher |
useAnchoringBounds(boolean b) |
ใใฎใใใใฃใฎ้ ๅๅข็ใฎใขใณใซใผใ่จญๅฎใใพใใ
|
Matcher |
usePattern(Pattern newPattern) |
ใใฎMatcherใใใใๆค็ดขใซไฝฟ็จใใPatternใๅคๆดใใพใใ
|
Matcher |
useTransparentBounds(boolean b) |
ใใฎใใใใฃใฎ้ ๅๅข็ใฎ้ๆๅบฆใ่จญๅฎใใพใใ
|
public Pattern pattern()
public MatchResult toMatchResult()
MatchResultใจใใฆ่ฟใใพใใ ็ตๆใฏใใใฎๆญฃ่ฆๆค็ดขใจใณใธใณใซๅฏพใใๅพ็ถใฎๆไฝใฎๅฝฑ้ฟใๅใใพใใใ MatchResultpublic Matcher usePattern(Pattern newPattern)
ใใฎใกใฝใใใไฝฟ็จใใใจใๆๅพใซ็บ็ใใใใใใฎใฐใซใผใใซ้ขใใๆ ๅ ฑใใใฎใใใใฃใใๅคฑใใใพใใ ๅ ฅๅๅ ใฎใใใใฃใฎไฝ็ฝฎใฏ็ถญๆใใใๆๅพใฎ่ฟฝๅ ไฝ็ฝฎใฏๅฝฑ้ฟใๅใใพใใใ
newPattern - ใใฎใใใใฃใไฝฟ็จใใๆฐ่ฆใใฟใผใณIllegalArgumentException - newPatternใnullใงใใๅ ดๅpublic Matcher reset()
ๆญฃ่ฆๆค็ดขใจใณใธใณใใชใปใใใใใจใๆ็คบ็ใช็ถๆ ๆ ๅ ฑใในใฆใ็ ดๆฃใใใ่ฟฝๅ ไฝ็ฝฎใใผใญใซ่จญๅฎใใใพใใ ๆญฃ่ฆๆค็ดขใจใณใธใณใฎ้ ๅใฏใใใใฉใซใใงใใๆๅญใทใผใฑใณในๅ จไฝใซ่จญๅฎใใใพใใ ใใฎใใใใฃใฎ้ ๅๅข็ใฎใขใณใซใผใใใณ้ๆๅบฆใฏๅฝฑ้ฟใๅใใพใใใ
public Matcher reset(CharSequence input)
ๆญฃ่ฆๆค็ดขใจใณใธใณใใชใปใใใใใจใๆ็คบ็ใช็ถๆ ๆ ๅ ฑใในใฆใ็ ดๆฃใใใ่ฟฝๅ ไฝ็ฝฎใใผใญใซ่จญๅฎใใใพใใ ๆญฃ่ฆๆค็ดขใจใณใธใณใฎ้ ๅใฏใใใใฉใซใใงใใๆๅญใทใผใฑใณในๅ จไฝใซ่จญๅฎใใใพใใ ใใฎใใใใฃใฎ้ ๅๅข็ใฎใขใณใซใผใใใณ้ๆๅบฆใฏๅฝฑ้ฟใๅใใพใใใ
input - ๆฐใใๅ
ฅๅๆๅญใทใผใฑใณในpublic int start()
startใใคใณใฟใใงใผในMatchResultIllegalStateException - ใใใใใพใ ่ฉฆใฟใใใฆใใชใๅ ดๅใใพใใฏๅๅใฎใใใๆไฝใๅคฑๆใใๅ ดๅpublic int start(int group)
ๅๆนๅ็ งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใฏใๅทฆใใๅณใซ1ใใใคใณใใใฏในไปใใใใพใใ ใฐใซใผใ0ใฏใใฟใผใณๅ จไฝใ่กจใใพใใใคใพใใm.start(0)ใจm.start()ใฏๅใ่กจ็พใงใใ
startใใคใณใฟใใงใผในMatchResultgroup - ใใฎใใใใฃใฎใใฟใผใณใฎใญใฃใใใฃใชใณใฐใปใฐใซใผใใฎใคใณใใใฏในIllegalStateException - ใใใใใพใ ่ฉฆใฟใใใฆใใชใๅ ดๅใใพใใฏๅๅใฎใใใๆไฝใๅคฑๆใใๅ ดๅIndexOutOfBoundsException - ๆๅฎใใใใคใณใใใฏในใๆใคๅๆนๅ็
งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใใใฎใใฟใผใณใซๅซใพใใชใๅ ดๅpublic int start(String name)
name - ใใฎใใใใฃใฎใใฟใผใณใฎๅๅไปใใญใฃใใใฃใชใณใฐใปใฐใซใผใใฎๅๅ-1IllegalStateException - ใใใใใพใ ่ฉฆใฟใใใฆใใชใๅ ดๅใใพใใฏๅๅใฎใใใๆไฝใๅคฑๆใใๅ ดๅIllegalArgumentException - ๆๅฎใใใๅๅใๆใคๅๆนๅ็
งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใใใฎใใฟใผใณใซๅซใพใใชใๅ ดๅpublic int end()
endใใคใณใฟใใงใผในMatchResultIllegalStateException - ใใใใใพใ ่ฉฆใฟใใใฆใใชใๅ ดๅใใพใใฏๅๅใฎใใใๆไฝใๅคฑๆใใๅ ดๅpublic int end(int group)
ๅๆนๅ็ งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใฏใๅทฆใใๅณใซ1ใใใคใณใใใฏในไปใใใใพใใ ใฐใซใผใ0ใฏใใฟใผใณๅ จไฝใ่กจใใพใใใคใพใใm.end(0)ใจm.end()ใฏๅใ่กจ็พใงใใ
endใใคใณใฟใใงใผในMatchResultgroup - ใใฎใใใใฃใฎใใฟใผใณใฎใญใฃใใใฃใชใณใฐใปใฐใซใผใใฎใคใณใใใฏในIllegalStateException - ใใใใใพใ ่ฉฆใฟใใใฆใใชใๅ ดๅใใพใใฏๅๅใฎใใใๆไฝใๅคฑๆใใๅ ดๅIndexOutOfBoundsException - ๆๅฎใใใใคใณใใใฏในใๆใคๅๆนๅ็
งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใใใฎใใฟใผใณใซๅซใพใใชใๅ ดๅpublic int end(String name)
name - ใใฎใใใใฃใฎใใฟใผใณใฎๅๅไปใใญใฃใใใฃใชใณใฐใปใฐใซใผใใฎๅๅ-1IllegalStateException - ใใใใใพใ ่ฉฆใฟใใใฆใใชใๅ ดๅใใพใใฏๅๅใฎใใใๆไฝใๅคฑๆใใๅ ดๅIllegalArgumentException - ๆๅฎใใใๅๅใๆใคๅๆนๅ็
งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใใใฎใใฟใผใณใซๅซใพใใชใๅ ดๅpublic String group()
ๅ ฅๅใทใผใฑใณในsใฎใใใใฃmใฎๅ ดๅใm.group()ใจs.substring(m.start(), m.end())ใฏๅใ่กจ็พใงใใ
ใใฟใผใณ(a*ใชใฉ)ใซใใฃใฆใฏใ็ฉบใฎๆๅญๅใจใใใใใใใจใใใใพใใ ใใใใฎใใฟใผใณใๅ ฅๅใทใผใฑใณในๅ ใฎ็ฉบใฎๆๅญๅใจใใใใใๅ ดๅใ็ฉบใฎๆๅญๅใ่ฟใใใพใใ
groupใใคใณใฟใใงใผในMatchResultIllegalStateException - ใใใใใพใ ่ฉฆใฟใใใฆใใชใๅ ดๅใใพใใฏๅๅใฎใใใๆไฝใๅคฑๆใใๅ ดๅpublic String group(int group)
ใใใใฃmใๅ ฅๅใทใผใฑใณในsใใใใณใฐใซใผใใปใคใณใใใฏในgใฎๅ ดๅใm.group(g)ใจs.substring(m.start(g), m.end(g))ใฏๅใ่กจ็พใงใใ
ๅๆนๅ็ งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใฏใๅทฆใใๅณใซ1ใใใคใณใใใฏในไปใใใใพใใ ใฐใซใผใ0ใฏใใฟใผใณๅ จไฝใ่กจใใพใใใคใพใใm.group(0)ใจm.group()ใฏๅใ่กจ็พใงใใ
ใใใใฏๆญฃๅธธ็ตไบใใใใๆๅฎใใใใฐใซใผใใๅ ฅๅใทใผใฑใณในใซๆคๅบใใใชใใฃใๅ ดๅใnullใ่ฟใใใพใใ ใใฟใผใณ((a*)ใชใฉ)ใซใใฃใฆใฏใ็ฉบใฎๆๅญๅใจใใใใใใใจใใใใพใใ ใใใใฎใฐใซใผใใๅ ฅๅใทใผใฑใณในๅ ใฎ็ฉบใฎๆๅญๅใจใใใใใๅ ดๅใ็ฉบใฎๆๅญๅใ่ฟใใใพใใ
groupใใคใณใฟใใงใผในMatchResultgroup - ใใฎใใใใฃใฎใใฟใผใณใฎใญใฃใใใฃใชใณใฐใปใฐใซใผใใฎใคใณใใใฏในIllegalStateException - ใใใใใพใ ่ฉฆใฟใใใฆใใชใๅ ดๅใใพใใฏๅๅใฎใใใๆไฝใๅคฑๆใใๅ ดๅIndexOutOfBoundsException - ๆๅฎใใใใคใณใใใฏในใๆใคๅๆนๅ็
งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใใใฎใใฟใผใณใซๅซใพใใชใๅ ดๅpublic String group(String name)
ใใใใฏๆญฃๅธธ็ตไบใใใใๆๅฎใใใใฐใซใผใใๅ ฅๅใทใผใฑใณในใซๆคๅบใใใชใใฃใๅ ดๅใnullใ่ฟใใใพใใ ใใฟใผใณ((a*)ใชใฉ)ใซใใฃใฆใฏใ็ฉบใฎๆๅญๅใจใใใใใใใจใใใใพใใ ใใใใฎใฐใซใผใใๅ ฅๅใทใผใฑใณในๅ ใฎ็ฉบใฎๆๅญๅใจใใใใใๅ ดๅใ็ฉบใฎๆๅญๅใ่ฟใใใพใใ
name - ใใฎใใใใฃใฎใใฟใผใณใฎๅๅไปใใญใฃใใใฃใชใณใฐใปใฐใซใผใใฎๅๅIllegalStateException - ใใใใใพใ ่ฉฆใฟใใใฆใใชใๅ ดๅใใพใใฏๅๅใฎใใใๆไฝใๅคฑๆใใๅ ดๅIllegalArgumentException - ๆๅฎใใใๅๅใๆใคๅๆนๅ็
งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใใใฎใใฟใผใณใซๅซใพใใชใๅ ดๅpublic int groupCount()
ใฐใซใผใ0ใฏใใฟใผใณๅ จไฝใ่กจใใพใใ ใใใฏใใใฎใซใฆใณใใซๅซใพใใพใใใ
ใฐใซใผใใปใคใณใใใฏในใใใฎใกใฝใใใใ่ฟใใใๅคไปฅไธใฎๆญฃใฎๆดๆฐใงใใๅ ดๅใฏใใใฎใใใใฃใงๆๅนใงใใ
groupCountใใคใณใฟใใงใผในMatchResultpublic boolean matches()
ใใใใๆๅใใๅ ดๅใฏใstartใendใใใใณgroupใกใฝใใใไฝฟ็จใใฆ่ฉณ็ดฐๆ ๅ ฑใๅๅพใงใใพใใ
public boolean find()
ใใฎใกใฝใใใฏใๆญฃ่ฆๆค็ดขใจใณใธใณใฎ้ ๅใฎๅ ้ ญใใ้ๅงใใใพใใใใ ใใๅๅใฎๅผๅบใใๆญฃๅธธใซ็ตไบใใฆใใใใใใฃใใชใปใใใใใฆใใชใๅ ดๅใฏใๅๅใฎใใใใงไธ่ดใใชใใฃใๆๅใฎๆๅญใใ้ๅงใใใพใใ
ใใใใๆๅใใๅ ดๅใฏใstartใendใใใใณgroupใกใฝใใใไฝฟ็จใใฆ่ฉณ็ดฐๆ ๅ ฑใๅๅพใงใใพใใ
public boolean find(int start)
ใใใใๆๅใใๅ ดๅใฏใstartใendใใใใณgroupใกใฝใใใไฝฟ็จใใฆ่ฉณ็ดฐๆ
ๅ ฑใๅๅพใงใใพใใๅพ็ถใฎfind()ใกใฝใใๅผๅบใใงใฏใใใฎใใใใงไธ่ดใใชใใฃใๆๅใฎๆๅญใใ้ๅงใใใพใใ
start - ใใใใฎๆค็ดขใ้ๅงใใใคใณใใใฏในIndexOutOfBoundsException - startใใผใญใใๅฐใใๅ ดๅใใพใใฏstartใๅ
ฅๅใทใผใฑใณในใฎ้ทใใใๅคงใใๅ ดๅใpublic boolean lookingAt()
matchesใกใฝใใใจๅๆงใซใ้ ๅใฎๅ
้ ญใใ้ๅงใใใพใใใใ ใใ้ ๅๅ
จไฝใใใใใใๅฟ
่ฆใฏใใใพใใใ
ใใใใๆๅใใๅ ดๅใฏใstartใendใใใใณgroupใกใฝใใใไฝฟ็จใใฆ่ฉณ็ดฐๆ ๅ ฑใๅๅพใงใใพใใ
public static String quoteReplacement(String s)
Stringใฎใชใใฉใซ็ฝฎๆStringใ่ฟใใพใใ ใใฎใกใฝใใใฏใMatcherใฏใฉในใฎappendReplacementใกใฝใใๅ
ใฎใชใใฉใซ็ฝฎๆsใจใใฆๆฉ่ฝใใStringใ็ๆใใพใใ ็ๆใใใStringใฏใใชใใฉใซใปใทใผใฑใณในใจใใฆๅฆ็ใใใsๅ
ใฎๆๅญใทใผใฑใณในใซใใใใใพใใ ในใฉใใทใฅ('\')ใใใณใใซ่จๅท('$')ใซใฏ็นๅฅใชๆๅณใฏใใใพใใใ s - ใชใใฉใซๅใใๆๅญๅpublic Matcher appendReplacement(StringBuffer sb, String replacement)
ใใฎใกใฝใใใฏใๆฌกใฎๅฆ็ใๅฎ่กใใพใใ
่ฟฝๅ ไฝ็ฝฎไปฅ้ใฎๅ
ฅๅใทใผใฑใณในใใๆๅญๅใ่ชญใฟ่พผใฟใๆๅฎใใใๆๅญๅใใใใกใซ่ฟฝๅ ใใใ ๅๅใใใใใๆๅญใฎ็ดๅใฎๆๅญใใคใพใใคใณใใใฏในstart() - 1ใฎๆๅญใ่ชญใฟ่พผใใ ใจใใซ็ตไบใใใ
ๆๅฎใใใ็ฝฎๆๆๅญๅใๆๅญๅใใใใกใซ่ฟฝๅ ใใใ
ใใฎใใใใฃใฎ่ฟฝๅ ไฝ็ฝฎใใๆๅพใซใใใใใๆๅญใฎใคใณใใใฏในใซ1ใๅ ใใๅคใใคใพใend()ใซ่จญๅฎใใใ
็ฝฎๆๆๅญๅใซใฏใๅๅใฎใใใๆใซๅๆนๅ็
งใใใ้จๅใทใผใฑใณในใธใฎๅ็
งใๅซใพใใๅ ดๅใใใใพใใ${name}ใพใใฏ$gใๆคๅบใใใใจใๅฏพๅฟใใgroup(name)ใพใใฏgroup(g)ใใใใใ่ฉไพกใใ็ตๆใซใในใฆ็ฝฎๆใใใพใใ $gใฎๅ ดๅใ$ใฎๅพใฎๆๅใฎๆฐๅญใฏๅธธใซใฐใซใผใๅ็
งใฎไธ้จใจใใฆๆฑใใใพใใ ๅพ็ถใฎๆฐๅคใๆญฃๅฝใชใฐใซใผใๅ็
งใๆงๆใใๅ ดๅใใใใใฏ g ใซ็ตใฟ่พผใพใใพใใ ๆฐ 0 - 9 ใ ใใใใฐใซใผใๅ็
งใฎๆฝๅจ็ใชใณใณใใผใใณใใจ่ฆใชใใใพใใ ใใจใใฐใ2็ช็ฎใฎใฐใซใผใใๆๅญๅใfooใใซใใใใใใจใ็ฝฎๆๆๅญๅใ$2barใใฎๅผๆธกใใ่กใใใฆใใfoobarใใๆๅญๅใใใใกใซ่ฟฝๅ ใใใพใใ ๅใซใใใฏในใฉใใทใฅ(\$)ใไปใใใใจใงใใใซ่จๅท($)ใใชใใฉใซใจใใฆ็ฝฎๆๆๅญๅใซๅซใใใใจใใงใใพใใ
็ฝฎๆๆๅญๅๅ ใงใใใฏในใฉใใทใฅ(\)ใจใใซ่จๅท($)ใไฝฟ็จใใใจใใใใใชใใฉใซ็ฝฎๆๆๅญๅใจใใฆๅฆ็ใใๅ ดๅใจใฏ็ตๆใ็ฐใชใๅ ดๅใใใใพใใ ใใซ่จๅทใฏใๅ ใซ่ชฌๆใใใจใใใๅๆนๅ็ งใใใ้จๅใทใผใฑใณในใธใฎๅ็ งใจใใฆๅฆ็ใใใๅ ดๅใใใใใใใฏในใฉใใทใฅใฏ็ฝฎๆๆๅญๅๅ ใฎใชใใฉใซๆๅญใใจในใฑใผใใใใฎใซไฝฟ็จใใใพใใ
ใใฎใกใฝใใใฏใใซใผใๅ
ใงappendTailใกใฝใใใใใณfindใกใฝใใใจ็ตใฟๅใใใฆไฝฟ็จใใพใใ ใใจใใฐใๆฌกใฎใณใผใใงใฏใone dog two dogs in the yardใๆจๆบๅบๅในใใชใผใ ใซๆธใๅบใใพใใ
Pattern p = Pattern.compile("cat");
Matcher m = p.matcher("one cat two cats in the yard");
StringBuffer sb = new StringBuffer();
while (m.find()) {
m.appendReplacement(sb, "dog");
}
m.appendTail(sb);
System.out.println(sb.toString());sb - ใฟใผใฒใใๆๅญๅใใใใกreplacement - ็ฝฎๆๆๅญๅIllegalStateException - ใใใใใพใ ่ฉฆใฟใใใฆใใชใๅ ดๅใใพใใฏๅๅใฎใใใๆไฝใๅคฑๆใใๅ ดๅIllegalArgumentException - ็ฝฎๆๆๅญๅใๅ็
งใใฆใใๅๅไปใใฎๅๆนๅ็
งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใใใใฟใผใณๅ
ใซๅญๅจใใชใๅ ดๅIndexOutOfBoundsException - ็ฝฎๆๆๅญๅใๅ็
งใใฆใใๅๆนๅ็
งใ่กใๆญฃ่ฆ่กจ็พใฐใซใผใใใใใฟใผใณๅ
ใซๅญๅจใใชใๅ ดๅpublic StringBuffer appendTail(StringBuffer sb)
ใใฎใกใฝใใใฏใ่ฟฝๅ ไฝ็ฝฎไปฅ้ใฎๅ
ฅๅใทใผใฑใณในใใๆๅญๅใ่ชญใฟ่พผใฟใๆๅฎใใใๆๅญๅใใใใกใซ่ฟฝๅ ใใพใใ ๅ
ฅๅใทใผใฑใณในใฎๆฎใใฎ้จๅใใณใใผใใใใใซใappendReplacementใกใฝใใใ1ๅไปฅไธๅผใณๅบใใฆใใใใฎใกใฝใใใๅผใณๅบใใพใใ
sb - ใฟใผใฒใใๆๅญๅใใใใกpublic String replaceAll(String replacement)
ใใฎใกใฝใใใฏใพใใใใฎใใใใฃใใชใปใใใใพใใ ๆฌกใซใๅ
ฅๅใทใผใฑใณในใ่ตฐๆปใใฆใใใฟใผใณใจใใใใใๆๅญๅใๆค็ดขใใพใใ ใใฟใผใณใจใใใใใชใๆๅญๅใฏใ็ตๆๆๅญๅใซ็ดๆฅ่ฟฝๅ ใใใพใใใใฟใผใณใจใใใใใๆๅญๅใฏใ็ฝฎๆๆๅญๅใซ็ฝฎๆใใใฆ็ตๆใซ่ฟฝๅ ใใใพใใ ็ฝฎๆๆๅญๅใซใฏใappendReplacementใกใฝใใใฎใใใซใๅๆนๅ็
งใใใ้จๅใทใผใฑใณในใธใฎๅ็
งใๅซใใใใจใใงใใพใใ
็ฝฎๆๆๅญๅๅ ใงใใใฏในใฉใใทใฅ(\)ใจใใซ่จๅท($)ใไฝฟ็จใใใจใใใใใชใใฉใซ็ฝฎๆๆๅญๅใจใใฆๅฆ็ใใๅ ดๅใจใฏ็ตๆใ็ฐใชใๅ ดๅใใใใพใใ ใใซ่จๅทใฏใๅ ใซ่ชฌๆใใใจใใใๅๆนๅ็ งใใใ้จๅใทใผใฑใณในใธใฎๅ็ งใจใใฆๅฆ็ใใใๅ ดๅใใใใใใใฏในใฉใใทใฅใฏ็ฝฎๆๆๅญๅๅ ใฎใชใใฉใซๆๅญใใจในใฑใผใใใใฎใซไฝฟ็จใใใพใใ
ๆญฃ่ฆ่กจ็พa*bใๅ ฅๅใaabfooaabfooabfoobใใใใใณ็ฝฎๆๆๅญๅใ-ใใๆๅฎใใๅ ดๅใใใฎ่กจ็พใฎใใใใฃไธใงใใฎใกใฝใใใๅผใณๅบใใจใๆๅญๅใ-foo-foo-foo-ใใ็ๆใใใพใใ
ใใฎใกใฝใใใๅผใณๅบใใจใใใฎใใใใฃใฎ็ถๆ ใๅคใใใพใใ ใใฎใใใใฃใๅพ็ถใฎใใใๆไฝใงไฝฟ็จใใๅ ดๅใฏใๆๅใซใใใใฃใใชใปใใใใๅฟ ่ฆใใใใพใใ
replacement - ็ฝฎๆๆๅญๅpublic String replaceFirst(String replacement)
ใใฎใกใฝใใใฏใพใใใใฎใใใใฃใใชใปใใใใพใใ ๆฌกใซใๅ
ฅๅใทใผใฑใณในใ่ตฐๆปใใฆใใใฟใผใณใจใใใใใๆๅใฎๆๅญๅใๆค็ดขใใพใใ ใใฟใผใณใจใใใใใชใๆๅญๅใฏใ็ตๆๆๅญๅใซ็ดๆฅ่ฟฝๅ ใใใพใใใใฟใผใณใจใใใใใๆๅญๅใฏใ็ฝฎๆๆๅญๅใซ็ฝฎๆใใใฆ็ตๆใซ่ฟฝๅ ใใใพใใ ็ฝฎๆๆๅญๅใซใฏใappendReplacementใกใฝใใใฎใใใซใๅๆนๅ็
งใใใ้จๅใทใผใฑใณในใธใฎๅ็
งใๅซใใใใจใใงใใพใใ
็ฝฎๆๆๅญๅๅ ใงใใใฏในใฉใใทใฅ(\)ใจใใซ่จๅท($)ใไฝฟ็จใใใจใใใใใชใใฉใซ็ฝฎๆๆๅญๅใจใใฆๅฆ็ใใๅ ดๅใจใฏ็ตๆใ็ฐใชใๅ ดๅใใใใพใใ ใใซ่จๅทใฏใๅ ใซ่ชฌๆใใใจใใใๅๆนๅ็ งใใใ้จๅใทใผใฑใณในใธใฎๅ็ งใจใใฆๅฆ็ใใใๅ ดๅใใใใใใใฏในใฉใใทใฅใฏ็ฝฎๆๆๅญๅๅ ใฎใชใใฉใซๆๅญใใจในใฑใผใใใใฎใซไฝฟ็จใใใพใใ
ๆญฃ่ฆ่กจ็พdogใๅ ฅๅใzzzdogzzzdogzzzใใใใใณ็ฝฎๆๆๅญๅใcatใใๆๅฎใใๅ ดๅใใใฎ่กจ็พใฎใใใใฃไธใงใใฎใกใฝใใใๅผใณๅบใใจใๆๅญๅใzzzcatzzzdogzzzใใ็ๆใใใพใใ
ใใฎใกใฝใใใๅผใณๅบใใจใใใฎใใใใฃใฎ็ถๆ ใๅคใใใพใใ ใใฎใใใใฃใๅพ็ถใฎใใใๆไฝใงไฝฟ็จใใๅ ดๅใฏใๆๅใซใใใใฃใใชใปใใใใๅฟ ่ฆใใใใพใใ
replacement - ็ฝฎๆๆๅญๅpublic Matcher region(int start, int end)
startใใฉใกใผใฟใซใใๆๅฎใใใใคใณใใใฏในใซใ้ ๅใฎๆซๅฐพใendใใฉใกใผใฟใซใใๆๅฎใใใใคใณใใใฏในใซใใใใ่จญๅฎใใใพใใ
ไฝฟ็จใใใ้ๆๅบฆใจใขใณใซใผ่จญๅฎใซใใฃใฆใฏ(useTransparentBoundsใใใณuseAnchoringBoundsใๅ็
ง)ใใขใณใซใผใชใฉใฎ็นๅฎใฎไฝๆไธใฎๆฏใ่ใใ้ ๅใฎๅข็ใพใใฏใใฎไป่ฟใง็ฐใชใๅ ดๅใใใใพใใ
start - ๆค็ดขใ้ๅงใใไฝ็ฝฎใฎใคใณใใใฏใน(ใใฎๅคใๅซใ)end - ๆค็ดขใ็ตไบใใไฝ็ฝฎใฎใคใณใใใฏใน(ใใฎๅคใๅซใพใชใ)IndexOutOfBoundsException - startใพใใฏendใใผใญใใๅฐใใๅ ดๅใstartใๅ
ฅๅใทใผใฑใณในใฎ้ทใใใๅคงใใๅ ดๅใendใๅ
ฅๅใทใผใฑใณในใฎ้ทใใใๅคงใใๅ ดๅใใพใใฏstartใendใใๅคงใใๅ ดๅใpublic int regionStart()
regionStart (ใใฎๅคใๅซใ)ใจregionEnd (ใใฎๅคใๅซใพใชใ)ใฎๅ
้จใงใฎใใใๆค็ดขใซๅถ้ใใใพใใ public int regionEnd()
regionStart (ใใฎๅคใๅซใ)ใจregionEnd (ใใฎๅคใๅซใพใชใ)ใฎๅ
้จใงใฎใใใๆค็ดขใซๅถ้ใใใพใใ public boolean hasTransparentBounds()
ใใฎใกใฝใใใฏใtransparentๅข็ใใใฎใใใใฃใงไฝฟ็จใใใๅ ดๅใฏtrueใ่ฟใใopaqueๅข็ใไฝฟ็จใใใๅ ดๅใซใฏfalseใ่ฟใใพใใ
้ๆใพใใฏไธ้ๆใฎๅข็ใฎ่ฉณ็ดฐใซใคใใฆใฏใuseTransparentBoundsใๅ็
งใใฆใใ ใใใ
ใใใฉใซใใงใฏใใใใใฃใฏไธ้ๆใฎ้ ๅๅข็ใไฝฟ็จใใพใใ
useTransparentBounds(boolean)public Matcher useTransparentBounds(boolean b)
ใใฎใกใฝใใใซtrueใฎๅผๆฐใๆๅฎใใฆๅผใณๅบใใจใ้ๆใชๅข็ใใใฎใใใใฃใงไฝฟ็จใใใพใใ booleanๅผๆฐใfalseใฎๅ ดๅใฏใไธ้ๆใชๅข็ใไฝฟ็จใใใพใใ
้ๆใชๅข็ใไฝฟ็จใใๅ ดๅใใใฎใใใใฃใฎ้ ๅใฏใๅๆนใๅพๆนใใใใณๅข็ใฎใใใใณใฐไฝๆใง้ๆใซใชใใพใใ ใใใใฎไฝๆใฏใใใใใ้ฉๅใใฉใใใ้ ๅใฎๅข็ใ่ถ ใใฆ่ฆใใใจใใงใใพใใ
ไธ้ๆใชๅข็ใไฝฟ็จใใใจใใใฎใใใใฃใฎๅข็ใฏใๅๆนใๅพๆนใใใใณๅข็ใ่ถ ใใฆๆค็ดขใ่ฉฆใฟใใใใใณใฐไฝๆใงไธ้ๆใจใชใใพใใ ใใใใฎไฝๆใงใฏๅข็ใไปฅๅใซใใใฎใผใฃใฆๆค็ดขใงใใชใใใใ้ ๅๅคใงใฏใฉใฎใใใชใใใใณใฐใๅคฑๆใใพใใ
ใใใฉใซใใงใฏใใใใใฃใฏไธ้ๆใฎๅข็ใไฝฟ็จใใพใใ
b - ไธ้ๆใพใใฏ้ๆใฎ้ ๅใฎใฉใกใใไฝฟ็จใใใใ็คบใbooleanhasTransparentBounds()public boolean hasAnchoringBounds()
ใใฎใกใฝใใใฏใใขใณใซใผ่จญๅฎๅข็ใใใฎใใใใฃใงไฝฟ็จใใใๅ ดๅใฏtrueใ่ฟใใใใใงใชใๅ ดๅใฏfalseใ่ฟใใพใใ
ใขใณใซใผ่จญๅฎๅข็ใฎ่ฉณ็ดฐใซใคใใฆใฏใuseAnchoringBoundsใๅ็
งใใฆใใ ใใใ
ใใใฉใซใใงใฏใใใใใฃใฏใขใณใซใผ่จญๅฎ้ ๅๅข็ใไฝฟ็จใใพใใ
useAnchoringBounds(boolean)public Matcher useAnchoringBounds(boolean b)
ใใฎใกใฝใใใซtrueใฎๅผๆฐใๆๅฎใใฆๅผใณๅบใใจใใขใณใซใผ่จญๅฎๅข็ใใใฎใใใใฃใงไฝฟ็จใใใพใใ booleanๅผๆฐใfalseใฎๅ ดๅใฏใใขใณใซใผ่จญๅฎใใใชใๅข็ใไฝฟ็จใใใพใใ
ใขใณใซใผ่จญๅฎๅข็ใไฝฟ็จใใใใจใใใฎใใใใฃใฎ้ ๅใฎๅข็ใฏใ^ใใใณ$ใชใฉใฎใขใณใซใผใซใใใใใพใใ
ใขใณใซใผ่จญๅฎๅข็ใไฝฟ็จใใใชใๅ ดๅใฏใใใฎใใใใฃใฎ้ ๅใฎๅข็ใฏใ^ใใใณ$ใชใฉใฎใขใณใซใผใซใใใใใพใใใ
ใใใฉใซใใงใฏใใใใใฃใฏใขใณใซใผ่จญๅฎ้ ๅๅข็ใไฝฟ็จใใพใใ
b - ใขใณใซใผ่จญๅฎๅข็ใไฝฟ็จใใใใฉใใใ็คบใbooleanใhasAnchoringBounds()public String toString()
ใใฎใใใใฃใฎๆๅญๅ่กจ็พใ่ฟใใพใใ Matcherใฎๆๅญๅ่กจ็พใซใฏใใใใใฐใซๆ็จใชๆ
ๅ ฑใๅซใพใใพใใ ๅณๅฏใชๆธๅผใฏๆๅฎใใใพใใใ
public boolean hitEnd()
ใใฎๆญฃ่ฆๆค็ดขใจใณใธใณใๅฎ่กใใๆๅพใฎใใใๆไฝใงใๅ ฅๅใฎๆซๅฐพใๆค็ดขใจใณใธใณใซใใใใใใใๅ ดๅใซใtrueใ่ฟใใพใใ
ใใฎใกใฝใใใtrueใ่ฟใๅ ดๅใๅ ฅๅใใใใซๅคใใใฐใๆๅพใฎๆค็ดขใฎ็ตๆใๅคๆดใใใๅฏ่ฝๆงใใใใพใใ
public boolean requireEnd()
ใใๅคใใฎๅ ฅๅใงๆญฃใฎใใใใ่ฒ ใฎใใใใซๅคๆดใใใๅฏ่ฝๆงใใใๅ ดๅใซใtrueใ่ฟใใพใใ
ใใฎใกใฝใใใtrueใ่ฟใใใใคใใใใๆคๅบใใใๅ ดๅใใใๅคใใฎๅ ฅๅใใใใฐใใใใๅคฑใใใๅฏ่ฝๆงใใใใพใใ ใใฎใกใฝใใใfalseใ่ฟใใใใคใใใใๆคๅบใใใๅ ดๅใใใๅคใใฎๅ ฅๅใใใใฐใใใใฏๅคๆดใใใใใๅคฑใใใใใจใฏใชใใฃใๅฏ่ฝๆงใใใใพใใ ใใใใๆคๅบใใใชใใฃใๅ ดๅใrequireEndใซๆๅณใฏใใใพใใใ
ใใฐใพใใฏๆฉ่ฝใ้ไฟก
่ฉณ็ดฐใชAPIใชใใกใฌใณในใใใณ้็บ่
ใใญใฅใกใณใใซใคใใฆใฏใJava SEใฎใใญใฅใกใณใใๅ็
งใใฆใใ ใใใ ใใฎใใญใฅใกใณใใซใฏใๆฆๅฟต็ใชๆฆ่ฆใ็จ่ชใฎๅฎ็พฉใๅ้ฟๆนๆณใๆๅนใชใณใผใไพใชใฉใฎใ้็บ่
ใๅฏพ่ฑกใซใใใใ่ฉณ็ดฐใช่ชฌๆใๅซใพใใฆใใพใใ
Copyright ยฉ 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyใๅ็
งใใฆใใ ใใใ
