java.util.regex
클래스 Matcher

java.lang.Object 
  java.util.regex.Matcher

모든 구현된 인터페이스:

MatchResult

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) 메서드 (새로운 입력 순서가 필요한 경우)를 호출합니다. 정규 표현 엔진을 리셋 하면, 그 명시적인 상태에 관한 정보가 파기되어 추가 위값이 제로로 설정됩니다.

이 클래스의 인스턴스는 복수의 thread로 동시에 사용할 수 없습니다.

도입된 버전 :

1.4

메서드 개요

Matcher	appendReplacement (StringBuffer sb, String replacement) 계속 추가 치환 순서를 구현합니다.
StringBuffer	appendTail (StringBuffer sb) 종료 추가 치환 순서를 구현합니다.
int	end () 마지막에 성냥 한 문자의 뒤의 오프셋(offset)를 리턴합니다.
int	end (int group) 전회의 매치 조작으로 지정된 그룹에 의해 상대방 참조된 부분 순서의, 최종 문자의 뒤의 오프셋(offset)를 리턴합니다.
boolean	find () 입력 순서로부터 이 패턴과 성냥 하는 다음의 부분 순서를 검색합니다.
boolean	find (int start) 이 정규 표현 엔진을 리셋 해, 지정된 인덱스 이후의 입력 순서로부터, 이 패턴과 성냥 하는 다음의 부분 순서를 검색합니다.
String	group () 전회의 성냥으로 일치한 입력 부분 순서를 리턴합니다.
String	group (int group) 전회의 매치 조작으로 지정된 그룹에 의해 상대방 참조된 입력 부분 순서를 리턴합니다.
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) 전회의 매치 조작으로 지정된 그룹에 의해 상대방 참조된 부분 순서의, 개시 인덱스를 리턴합니다.
MatchResult	toMatchResult () 이 정규 표현 엔진의 매치 상태를 MatchResult 로서 리턴합니다.
String	toString () 이 정규 표현 엔진의 캐릭터 라인 표현을 리턴합니다.
Matcher	useAnchoringBounds (boolean b) 이 정규 표현 엔진의 영역 경계의 엥커를 설정합니다.
Matcher	usePattern (Pattern newPattern) 이 Matcher가 매치 검색에 사용하는 Pattern를 변경합니다.
Matcher	useTransparentBounds (boolean b) 이 정규 표현 엔진의 영역 경계의 투명도를 설정합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

메서드의 상세

pattern

public Pattern  pattern()

이 정규 표현 엔진에 의해 해석되는 패턴을 리턴합니다.

반환값:

이 정규 표현 엔진의 작성 대상이 된 패턴

toMatchResult

public MatchResult  toMatchResult()

이 정규 표현 엔진의 매치 상태를 MatchResult 로서 리턴합니다. 결과는 이 정규 검색 엔진에 대한 후속의 조작의 영향을 받지 않습니다.

반환값:

이 정규 검색 엔진 상태를 보관 유지하는 MatchResult

usePattern

public Matcher  usePattern(Pattern  newPattern)

이 Matcher가 매치 검색에 사용하는 Pattern를 변경합니다.

이 메서드를 사용하면, 마지막에 발생한 성냥의 그룹에 관한 정보가 이 정규 표현 엔진으로부터 없어집니다. 입력내의 정규 표현 엔진의 위치는 유지되어 마지막 추가 위치는 영향을 받지 않습니다.

파라미터:

newPattern - 이 정규 표현 엔진이 사용하는 새로운 패턴

반환값:

이 정규 표현 엔진

예외:

IllegalArgumentException - newPattern가 null인 경우

도입된 버전 :

1.5

reset

public Matcher  reset()

이 정규 표현 엔진을 리셋 합니다.

정규 검색 엔진을 리셋 하면, 명시적인 상태 정보 모든 것이 파기되어 추가 위값이 제로로 설정됩니다. 정규 검색 엔진의 영역은 디폴트인 문자 순서 전체로 설정됩니다. 이 정규 표현 엔진의 영역 경계의 엥커 및 투명성은 영향을 받지 않습니다.

반환값:

이 정규 표현 엔진

reset

public Matcher  reset(CharSequence  input)

새로운 입력 순서를 사용해 이 정규 표현 엔진을 리셋 합니다.

정규 검색 엔진을 리셋 하면, 명시적인 상태 정보 모든 것이 파기되어 추가 위값이 제로로 설정됩니다. 정규 검색 엔진의 영역은 디폴트인 문자 순서 전체로 설정됩니다. 이 정규 표현 엔진의 영역 경계의 엥커 및 투명성은 영향을 받지 않습니다.

파라미터:

input - 새로운 입력 문자 순서

반환값:

이 정규 표현 엔진

start

public int start()

전회의 성냥의 개시 인덱스를 리턴합니다.

정의:

인터페이스 MatchResult 내의 start

반환값:

매치한 최초의 문자의 인덱스

예외:

IllegalStateException - 매치를 하지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

start

public int start(int group)

전회의 매치 조작으로 지정된 그룹에 의해 상대방 참조된 부분 순서의, 개시 인덱스를 리턴합니다.

상대방 참조를 실시하는 정규 표현 그룹에는 왼쪽에서 우측향에 1 으로부터 인덱스가 붙습니다. 그룹 0 은 패턴 전체를 나타냅니다. 즉, m. start(0)와 m. start()는 같은 표현입니다.

정의:

인터페이스 MatchResult 내의 start

파라미터:

group - 이 정규 표현 엔진의 패턴으로 가리키는 상대방 참조를 실시하는 정규 표현 그룹의 인덱스

반환값:

이 그룹에 의해 상대방 참조된 최초의 문자의 인덱스. 성냥은 성공했지만, 그룹 자체는 성냥 하지 않았던 경우는 -1

예외:

IllegalStateException - 매치를 하지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

IndexOutOfBoundsException - 지정된 인덱스를 가지는 상대방 참조를 실시하는 정규 표현 그룹이 그 패턴에 포함되지 않는 경우

end

public int end()

마지막에 성냥 한 문자의 뒤의 오프셋(offset)를 리턴합니다.

정의:

인터페이스 MatchResult 내의 end

반환값:

마지막에 성냥 한 문자의 뒤의 오프셋(offset)

예외:

IllegalStateException - 매치를 하지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

end

public int end(int group)

전회의 매치 조작으로 지정된 그룹에 의해 상대방 참조된 부분 순서의, 최종 문자의 뒤의 오프셋(offset)를 리턴합니다.

상대방 참조를 실시하는 정규 표현 그룹에는 왼쪽에서 우측향에 1 으로부터 인덱스가 붙습니다. 그룹 0 은 패턴 전체를 나타냅니다. 즉, m. end(0)와 m. end()는 같은 표현입니다.

정의:

인터페이스 MatchResult 내의 end

파라미터:

group - 이 정규 표현 엔진의 패턴으로 가리키는 상대방 참조를 실시하는 정규 표현 그룹의 인덱스

반환값:

이 그룹에 의해 상대방 참조된 마지막 문자의 뒤의 오프셋(offset). 성냥은 성공했지만, 그룹 자체는 성냥 하지 않았던 경우는 -1

예외:

IllegalStateException - 매치를 하지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

IndexOutOfBoundsException - 지정된 인덱스를 가지는 상대방 참조를 실시하는 정규 표현 그룹이 그 패턴에 포함되지 않는 경우

group

public String  group()

전회의 성냥으로 일치한 입력 부분 순서를 리턴합니다.

정규 표현 엔진 m에 입력 순서 s가 가리키는 경우, m. group()와 s. substring(m. start(), m. end())는 같은 표현이 됩니다.

패턴 (a* 등)에 따라서는 비어있는 캐릭터 라인과 성냥 하는 일이 있습니다. 이러한 패턴이 입력 순서내의 비어있는 캐릭터 라인과 성냥 했을 경우, 비어있는 캐릭터 라인이 리턴됩니다 .

정의:

인터페이스 MatchResult 내의 group

반환값:

전회의 성냥으로 일치한 부분 순서 (비어있는 경우도 있다). 캐릭터 라인 형식

예외:

IllegalStateException - 매치를 하지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

group

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*) 등)에 따라서는 비어있는 캐릭터 라인과 성냥 하는 일이 있습니다. 이러한 그룹이 입력 순서내의 비어있는 캐릭터 라인과 성냥 했을 경우, 비어있는 캐릭터 라인이 리턴됩니다 .

정의:

인터페이스 MatchResult 내의 group

파라미터:

group - 이 정규 표현 엔진의 패턴으로 가리키는 상대방 참조를 실시하는 정규 표현 그룹의 인덱스

반환값:

전회의 성냥으로 그룹에 의해 상대방 참조된 부분 순서 (비어있는 경우도 있다). 이 그룹이 입력 순서에 검출되지 않았던 경우는 null

예외:

IllegalStateException - 매치를 하지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

IndexOutOfBoundsException - 지정된 인덱스를 가지는 상대방 참조를 실시하는 정규 표현 그룹이 그 패턴에 포함되지 않는 경우

groupCount

public int groupCount()

이 정규 표현 엔진의 패턴으로 가리키는 상대방 참조를 실시하는 정규 표현 그룹의 수를 리턴합니다.

그룹 0 은 패턴 전체를 나타냅니다. 그룹 0 은 이 카운트에 포함되지 않습니다.

그룹 인덱스가 이 메서드로부터 리턴된 값아래의 정의 정수인 경우는 이 정규 표현 엔진으로 유효합니다.

정의:

인터페이스 MatchResult 내의 groupCount

반환값:

이 정규 표현 엔진의 패턴으로 가리키는 상대방 참조를 실시하는 정규 표현 그룹의 수

matches

public boolean matches()

영역 전체를 이 패턴과 성냥 합니다.

성냥이 성공했을 경우는 start, end 및 group 메서드를 사용해 상세 정보를 취득할 수 있습니다.

반환값:

영역 순서 전체가 이 정규 표현 엔진의 패턴과 성냥 했을 경우에 한정해, true

find

public boolean find()

입력 순서로부터 이 패턴과 성냥 하는 다음의 부분 순서를 검색합니다.

이 메서드는 정규 검색 엔진의 영역의 선두로부터 개시됩니다. 다만, 전회의 호출이 정상적으로 종료하고 나서 정규 표현 엔진이 리셋되어 있지 않은 경우는 전회의 성냥으로 일치하지 않았던 최초의 문자로부터 개시됩니다.

성냥이 성공했을 경우는 start, end 및 group 메서드를 사용해 상세 정보를 취득할 수 있습니다.

반환값:

입력 순서의 부분 순서가 이 정규 표현 엔진의 패턴과 성냥 했을 경우에 한정해, true

find

public boolean find(int start)

이 정규 표현 엔진을 리셋 해, 지정된 인덱스 이후의 입력 순서로부터, 이 패턴과 성냥 하는 다음의 부분 순서를 검색합니다.

성냥이 성공했을 경우는 start, end 및 group 메서드를 사용해 상세 정보를 취득할 수 있습니다. 후속의 find() 메서드 호출에서는 이 성냥으로 일치하지 않았던 최초의 문자로부터 개시됩니다.

반환값:

지정된 인덱스 이후의 입력 순서로부터, 이 정규 표현 엔진의 패턴과 성냥 하는 부분 순서가 검출되었을 경우에 한정해, true

예외:

IndexOutOfBoundsException - 개시 인덱스가 0 보다 작은 경우인가 입력 순서의 길이보다 큰 경우

lookingAt

public boolean lookingAt()

입력 순서와 패턴과의 성냥을 영역의 선두로부터 시작합니다.

matches 메서드와 같게, 영역의 선두로부터 개시됩니다. 다만, 영역 전체가 성냥 할 필요는 없습니다.

성냥이 성공했을 경우는 start, end 및 group 메서드를 사용해 상세 정보를 취득할 수 있습니다.

반환값:

입력 순서의 접두사가 이 정규 표현 엔진의 패턴과 성냥 했을 경우에 한정해, true

quoteReplacement

public static String  quoteReplacement(String  s)

지정된 String 리터럴 치환 String를 리턴합니다.이 메서드는 Matcher 클래스의 appendReplacement 메서드내의 리터럴 치환 s로 서 기능하는 String를 생성합니다. 생성되는 String는 리터럴 순서로서 처리되는 s 내의 문자 순서에 성냥 합니다. slash ('\') 및 달러 기호 ('$')에는 특별한 미는 없습니다.

파라미터:

s - 리터럴화하는 캐릭터 라인

반환값:

리터럴 캐릭터 라인 치환

도입된 버전 :

1.5

appendReplacement

public Matcher  appendReplacement(StringBuffer  sb,
                                 String  replacement)

계속 추가 치환 순서를 구현합니다.

이 메서드는 다음의 처리를 실행합니다.

1. 추가 위치 이후의 입력 순서로부터 캐릭터 라인을 읽기, 지정된 캐릭터 라인 버퍼에 추가한다. 전회 매치한 문자의 직전의 문자, 즉 인덱스 start() - 1 문자를 읽어들였을 때에 종료한다

2. 지정된 치환 캐릭터 라인을 캐릭터 라인 버퍼에 추가한다

3. 이 정규 표현 엔진의 추가 위치를, 마지막에 성냥 한 문자의 인덱스에 1을 더한 값, 즉 end() 로 설정한다

치환 캐릭터 라인에는 전회의 매치시에 상대방 참조된 부분 순서에의 참조가 포함되는 경우가 있습니다. $g가 검출되면, group (g)를 평가한 결과에 모두 치환됩니다. $ 후의 최초의 수치는 항상 그룹 참조의 일부로서 처리됩니다. 후속의 수값이 정당한 그룹 참조를 구성하는 경우, 이것들은 g에 짜넣어집니다. 수 0 ~ 9 만이, 그룹 참조의 잠재적인 컴퍼넌트라고 보여집니다. 예를 들어 2번째의 그룹이 캐릭터 라인 "foo"에 성냥 하면, 치환 캐릭터 라인 "$2bar" 인도를 해, "foobar"가 캐릭터 라인 버퍼에 추가됩니다. 전에 backslash (\$)를 붙이는 것으로 달러 기호 ($)를 리터럴로서 치환 캐릭터 라인에 포함할 수 있습니다 .

치환 캐릭터 라인내에서 backslash (\)와 달러 기호 ($)를 사용하면, 그것을 리터럴 치환 캐릭터 라인으로서 처리했을 경우와는 결과가 다른 경우가 있습니다. 달러 기호는 먼저 설명했던 대로 상대방 참조된 부분 순서에의 참조로서 처리되는 경우가 있어, backslash는 치환 캐릭터 라인내의 리터럴 문자를 이스케이프 하는데 사용됩니다.

이 메서드는 루프내에서 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 - 매치를 하지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

IndexOutOfBoundsException - 패턴에 존재하지 않는 상대방 참조를 실시하는 정규 표현 그룹을 치환 캐릭터 라인이 참조하고 있는 경우

appendTail

public StringBuffer  appendTail(StringBuffer  sb)

종료 추가 치환 순서를 구현합니다.

이 메서드는 추가 위치 이후의 입력 순서로부터 캐릭터 라인을 읽기, 지정된 캐릭터 라인 버퍼에 추가합니다. 입력 순서의 나머지의 부분을 카피하기 위해서 appendReplacement 메서드를 1회 이상 호출하고 나서 이 메서드를 호출합니다.

파라미터:

sb - 타겟 캐릭터 라인 버퍼

반환값:

타겟 캐릭터 라인 버퍼

replaceAll

public String  replaceAll(String  replacement)

패턴과 성냥 하는 입력 순서의 부분 순서를, 지정된 치환 캐릭터 라인에 옮겨놓습니다.

이 메서드는 우선, 이 정규 표현 엔진을 리셋 합니다. 다음에 입력 순서를 주사 해, 패턴과 성냥 하는 캐릭터 라인을 검색합니다. 패턴과 성냥 하지 않는 캐릭터 라인은 결과 캐릭터 라인에 직접 추가됩니다. 패턴과 성냥 한 캐릭터 라인은 치환 캐릭터 라인에 치환되어 결과에 추가됩니다. appendReplacement 메서드와 같게, 상대방 참조된 부분 순서에의 참조가 치환 캐릭터 라인에 포함되는 경우가 있습니다.

치환 캐릭터 라인내에서 backslash (\)와 달러 기호 ($)를 사용하면, 그것을 리터럴 치환 캐릭터 라인으로서 처리했을 경우와는 결과가 다른 경우가 있습니다. 달러 기호는 먼저 설명했던 대로 상대방 참조된 부분 순서에의 참조로서 처리되는 경우가 있어, backslash는 치환 캐릭터 라인내의 리터럴 문자를 이스케이프 하는데 사용됩니다.

정규 표현 a*b, 입력 "aabfooaabfooabfoob" 및 치환 캐릭터 라인 "-"을 지정했을 경우, 그 표현의 정규 표현 엔진상에서 이 메서드를 호출하면, 캐릭터 라인 "-foo-foo-foo-"가 생성됩니다.

이 메서드를 호출하면, 이 정규 표현 엔진 상태가 바뀝니다. 이 정규 표현 엔진을 후속의 매치 조작으로 사용하는 경우는 최초로 정규 표현 엔진을 리셋 할 필요가 있습니다.

파라미터:

replacement - 치환 캐릭터 라인

반환값:

매치한 부분 순서가 모두 치환 캐릭터 라인에 치환되어 작성된 캐릭터 라인. 필요에 따라서, 상대방 참조된 부분 순서도 치환된다

replaceFirst

public String  replaceFirst(String  replacement)

패턴과 성냥 하는 입력 순서의 부분 순서 가운데, 최초의 부분 순서가 지정된 치환 캐릭터 라인에 옮겨놓습니다.

이 메서드는 우선, 이 정규 표현 엔진을 리셋 합니다. 다음에 입력 순서를 주사 해, 패턴과 성냥 하는 최초의 캐릭터 라인을 검색합니다. 패턴과 성냥 하지 않는 캐릭터 라인은 결과 캐릭터 라인에 직접 추가됩니다. 패턴과 성냥 한 캐릭터 라인은 치환 캐릭터 라인에 치환되어 결과에 추가됩니다. appendReplacement 메서드와 같게, 상대방 참조된 부분 순서에의 참조가 치환 캐릭터 라인에 포함되는 경우가 있습니다.

정규 표현 dog, 입력 "zzzdogzzzdogzzz" 및 치환 캐릭터 라인 "cat"를 지정했을 경우, 그 표현의 정규 표현 엔진상에서 이 메서드를 호출하면, 캐릭터 라인 "zzzcatzzzdogzzz"가 생성됩니다.

이 메서드를 호출하면, 이 정규 표현 엔진 상태가 바뀝니다. 이 정규 표현 엔진을 후속의 매치 조작으로 사용하는 경우는 최초로 정규 표현 엔진을 리셋 할 필요가 있습니다.

파라미터:

replacement - 치환 캐릭터 라인

반환값:

매치한 최초의 부분 순서가 치환 캐릭터 라인에 치환되어 작성된 캐릭터 라인. 필요에 따라서, 상대방 참조된 부분 순서도 치환된다

예외:

NullPointerException - replacement이 null인 경우

region

public Matcher  region(int start,
                      int end)

정규 검색 엔진의 영역에 제한을 설정합니다. 영역은 성냥의 검색 대상이 되는 입력 순서의 일부입니다. 이 메서드를 호출하면, 정규 검색 엔진이 리셋 되어 영역의 선두가 start 파라미터에 의해 지정된 인덱스에 영역의 말미가 end 파라미터에 의해 지정된 인덱스에 각각 설정됩니다.

사용되는 투명도와 엥커 설정에 따라서는 (useTransparentBounds 및 useAnchoringBounds를 참조), 엥커등의 특정의 작성상의 행동이 영역의 경계 또는 그 부근에서 다른 경우가 있습니다.

파라미터:

start - 검색을 개시하는 위치의 인덱스 (그 값도 포함한다)

end - 검색을 종료하는 위치의 인덱스 (그 값을 포함하지 않는다)

반환값:

이 정규 표현 엔진

예외:

IndexOutOfBoundsException - 선두 또는 말미가 제로 미만의 경우, 선두가 입력 순서의 길이보다 큰 경우, 말미가 입력 순서의 길이보다 큰 경우, 또는 선두가 말미보다 큰 경우

도입된 버전 :

1.5

regionStart

public int regionStart()

이 정규 검색 엔진의 영역의 개시 인덱스를 리포트합니다. 이 정규 검색 엔진이 실시하는 검색은, regionStart (그 값도 포함한다)와 regionEnd (그 값을 포함하지 않는다)의 내부에서의 매치 검색에 제한됩니다.

반환값:

이 정규 검색 엔진의 영역의 시점

도입된 버전 :

1.5

regionEnd

public int regionEnd()

이 정규 검색 엔진의 영역의 종료 인덱스 (그 값을 포함하지 않는다)를 리포트합니다. 이 정규 검색 엔진이 실시하는 검색은, regionStart (그 값도 포함한다)와 regionEnd (그 값을 포함하지 않는다)의 내부에서의 매치 검색에 제한됩니다.

반환값:

이 정규 표현 엔진의 영역의 종점

도입된 버전 :

1.5

hasTransparentBounds

public boolean hasTransparentBounds()

이 정규 표현 엔진의 영역 경계의 투명도를 문의하는 쿼리를 냅니다.

이 메서드는 transparent 경계가 이 정규 표현 엔진으로 사용되는 경우는 true를 돌려주고, opaque 경계가 사용되는 경우에는 false를 리턴합니다.

투명 또는 불투명의 경계의 상세한 것에 대하여는 useTransparentBounds를 참조하십시오.

디폴트에서는 정규 표현 엔진은 불투명의 영역 경계를 사용합니다.

반환값:

이 정규 표현 엔진이 투명한 경계를 사용하는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.5

관련 항목:

useTransparentBounds(boolean)

useTransparentBounds

public Matcher  useTransparentBounds(boolean b)

이 정규 표현 엔진의 영역 경계의 투명도를 설정합니다.

이 메서드에 true 인수를 지정해 호출하면, transparent 경계가 이 정규 표현 엔진으로 사용됩니다. boolean 인수가 false인 경우는 opaque 경계가 사용됩니다.

투명한 경계를 사용하는 경우, 이 정규 표현 엔진의 영역은 전방, 후방 및 경계의 매칭 작성으로 투명하게 됩니다. 이러한 작성은 성냥이 적절한가 어떤가를 영역의 경계를 넘어 볼 수가 있습니다.

불투명한 경계를 사용하면, 이 정규 표현 엔진의 경계는 전방, 후방 및 경계를 넘어 검색을 시도하는 매칭 작성으로 불투명이 됩니다. 이러한 작성에서는 경계를 이전으로 거슬러 올라가 검색할 수 없기 때문에 영역외에서는 어떠한 매칭도 실패합니다.

디폴트에서는 정규 표현 엔진은 불투명의 경계를 사용합니다.

파라미터:

b - 불투명 또는 투명의 영역의 어느 쪽을 사용하는지를 나타내는 boolean

반환값:

이 정규 표현 엔진

도입된 버전 :

1.5

관련 항목:

hasTransparentBounds()

hasAnchoringBounds

public boolean hasAnchoringBounds()

이 정규 표현 엔진의 영역 경계의 엥커 설정을 문의하는 쿼리를 냅니다.

이 메서드는 anchoring 경계가 이 정규 표현 엔진으로 사용되는 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.

엥커 설정 경계의 상세한 것에 대하여는 useTransparentBounds를 참조하십시오.

디폴트에서는 정규 표현 엔진은 엥커 설정 영역 경계를 사용합니다.

반환값:

이 정규 표현 엔진이 엥커 설정 경계를 사용하는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.5

관련 항목:

useAnchoringBounds(boolean)

useAnchoringBounds

public Matcher  useAnchoringBounds(boolean b)

이 정규 표현 엔진의 영역 경계의 엥커를 설정합니다.

이 메서드에 true 인수를 지정해 호출하면, anchoring 경계가 이 정규 표현 엔진으로 사용됩니다. boolean 인수가 false인 경우는 non-anchoring 경계가 사용됩니다.

엥커 설정 경계가 사용되면, 이 정규 표현 엔진의 영역의 경계는 ^ 및 $ 등의 엥커에 성냥 합니다.

엥커 설정 경계가 사용되지 않는 경우는 이 정규 표현 엔진의 영역의 경계는 ^ 및 $ 등의 엥커에 성냥 하지 않습니다.

디폴트에서는 정규 표현 엔진은 엥커 설정 영역 경계를 사용합니다.

파라미터:

b - 엥커 설정 경계를 사용할지 어떨지를 나타내는 boolean

반환값:

이 정규 표현 엔진

도입된 버전 :

1.5

관련 항목:

hasAnchoringBounds()

toString

public String  toString()

이 정규 표현 엔진의 캐릭터 라인 표현을 리턴합니다. Matcher 캐릭터 라인 표현에는 디버그에 유용한 정보가 포함됩니다. 엄밀한 서식은 지정되지 않습니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 정규 검색 엔진의 캐릭터 라인 표현

도입된 버전 :

1.5

hitEnd

public boolean hitEnd()

이 정규 검색 엔진이 실행한 마지막 매치 조작으로 입력의 말미가 검색 엔진에 의해 히트 했을 경우에 true를 리턴합니다.

이 메서드가 true를 돌려주는 경우, 입력이 또한 많으면, 마지막 검색의 결과가 변경된 가능성이 있습니다.

반환값:

입력의 말미가 마지막 성냥으로 히트 했을 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.5

requireEnd

public boolean requireEnd()

보다 많은 입력으로 정의 성냥이 부의 성냥으로 변경될 가능성이 있는 경우에 true를 리턴합니다.

이 메서드가 true를 돌려주고, 한편 성냥이 검출되었을 경우, 보다 많은 입력이 있으면 성냥이 없어진 가능성이 있습니다. 이 메서드가 false를 돌려주고, 한편 성냥이 검출되었을 경우, 보다 많은 입력이 있으면 성냥은 변경되지만, 없어질 것은 없었던 가능성이 있습니다. 성냥이 검출되지 않았던 경우, requireEnd 에 미는 없습니다.

반환값:

보다 많은 입력으로 정의 성냥이 부의 성냥으로 변경될 가능성이 있는 경우는 true

도입된 버전 :

1.5