java.util.regex
클래스 Matcher

java.lang.Object 
  |
  +--java.util.regex.Matcher

public final class Matcher

extends Object

Pattern 를 해석하는 것에 의해 캐릭터 순차 순서 의 매치 조작을 실시하는 엔진입니다.

정규 표현 엔진은 패턴의 matcher 메소드를 호출하는 것에 의해 패턴으로부터 작성됩니다. 한 번 작성하면(자), 다음의 3 종류의 매치 조작에 사용할 수 있습니다.

• matches 메소드에서는 입력 순차 순서 전체와 패턴이 성냥 됩니다.

• lookingAt 메소드에서는 입력 순차 순서의 선두로부터 패턴이 성냥 됩니다.

• find 메소드에서는 입력 순차 순서를 주사 해, 패턴과 성냥 하는 다음의 부분 순차 순서를 검색합니다.

이러한 메소드는 성냥이 성공했는지 어떠했는지를 나타내는 boolean 치를 돌려줍니다. 성냥이 성공했을 때는 정규 표현 엔진 상태를 조회하면 상세를 취득할 수 있습니다.

이 클래스에는 성냥 한 부분 순차 순서를 새로운 캐릭터 라인에 치환하는 메소드도 정의합니다. 새로운 캐릭터 라인의 내용은 필요에 따라서 매치 결과로부터 산출할 수 있습니다. appendReplacement 및 appendTail 메소드를 동시에 사용하면, 매치 결과를 수집해 기존의 캐릭터 라인 버퍼에 저장할 수 있습니다. 또,replaceAll 메소드를 사용하면, 입력 순차 순서내에서 성냥 한 부분 순차 순서가 모두 치환된 캐릭터 라인을 작성할 수 있습니다.

정규 표현 엔진의 명시적인 상태로서 마지막에 성공한 성냥의 개시 인덱스와 종료 인덱스가 있습니다. 또, 패턴의 각전방 참조를 실시하는 정규 표현 그룹에 의해 전방 참조된 입력 부분 순차 순서의 개시 인덱스와 종료 인덱스나, 전방 참조된 부분 순차 순서의 총수도 이용됩니다. 전방 참조된 부분 순차 순서를 캐릭터 라인 형식에서 돌려주는 메소드도 준비되어 있습니다.

정규 표현 엔진의 명시적인 상태의 초기치는 정의되고 있지 않습니다. 성냥이 성공하기 전에 그 일부를 조회하려고 하면(자),IllegalStateException 가 슬로우 됩니다. 정규 표현 엔진의 명시적인 상태는 매치 조작마다 다시 계산합니다.

정규 표현 엔진의 암묵적인 상태에는 입력 캐릭터 순차 순서나 「추가 위치」가 있습니다. 추가 위치의 초기치는 제로로,appendReplacement 메소드에 의해 갱신됩니다.

정규 표현 엔진을 리셋트 하려면 , 정규 표현 엔진의 reset() 메소드 또는 reset(CharSequence) 메소드 (새로운 입력 순차 순서가 필요한 경우)를 호출합니다. 정규 표현 엔진을 리셋트 하면(자), 그 명시적인 상태에 관한 정보가 파기되어 추가 위치가 제로로 설정됩니다.

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

도입된 버젼:

1.4

메소드의 개요

Matcher	appendReplacement (StringBuffer sb, String replacement) 계속 추가 치환 순서를 구현합니다.
StringBuffer	appendTail (StringBuffer sb) 종료 추가 치환 순서를 구현합니다.
int	end () 마지막에 성냥 한 캐릭터의 인덱스에 1 을 더한 것을 돌려줍니다.
int	end (int group) 전회의 매치 조작으로 지정된 그룹에 의해 전방 참조된 부분 순차 순서의, 마지막 캐릭터의 인덱스에 1 을 더한 것을 돌려줍니다.
boolean	find () 입력 순차 순서로부터 이 패턴과 성냥 하는 다음의 부분 순차 순서를 검색합니다.
boolean	find (int start) 이 정규 표현 엔진을 리셋트 해, 지정된 인덱스 이후의 입력 순차 순서로부터, 이 패턴과 성냥 하는 다음의 부분 순차 순서를 검색합니다.
String	group () 전회의 성냥으로 일치한 입력 부분 순차 순서를 돌려줍니다.
String	group (int group) 전회의 매치 조작으로 지정된 그룹에 의해 전방 참조된 입력 부분 순차 순서를 돌려줍니다.
int	groupCount () 이 정규 표현 엔진의 패턴으로 지정되고 있는 전방 참조를 실시하는 정규 표현 그룹의 수를 돌려줍니다.
boolean	lookingAt () 입력 순차 순서의 선두로부터 패턴과 성냥 합니다.
boolean	matches () 입력 순차 순서 전체를 이 패턴과 성냥 합니다.
Pattern	pattern () 이 정규 표현 엔진에 의해 해석되는 패턴을 돌려줍니다.
String	replaceAll (String replacement) 패턴과 성냥 하는 입력 순차 순서의 부분 순차 순서를, 지정된 치환 캐릭터 라인에 옮겨놓습니다.
String	replaceFirst (String replacement) 패턴과 성냥 하는 입력 순차 순서의 부분 순차 순서 가운데, 최초의 부분 순차 순서가 지정된 치환 캐릭터 라인에 옮겨놓습니다.
Matcher	reset () 이 정규 표현 엔진을 리셋트 합니다.
Matcher	reset (CharSequence input) 새로운 입력 순차 순서를 사용해 이 정규 표현 엔진을 리셋트 합니다.
int	start () 전회의 성냥의 개시 인덱스를 돌려줍니다.
int	start (int group) 전회의 매치 조작으로 지정된 그룹에 의해 전방 참조된 부분 순차 순서의, 개시 인덱스를 돌려줍니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

메소드의 상세

pattern

public Pattern  pattern()

이 정규 표현 엔진에 의해 해석되는 패턴을 돌려줍니다.

반환값:

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

reset

public Matcher  reset()

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

정규 표현 엔진을 리셋트 하면(자), 그 명시적인 상태에 관한 정보가 모두 파기되어 그 추가 위치가 제로로 설정됩니다.

반환값:

이 정규 표현 엔진

reset

public Matcher  reset(CharSequence  input)

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

정규 표현 엔진을 리셋트 하면(자), 그 명시적인 상태에 관한 정보가 모두 파기되어 그 추가 위치가 제로로 설정됩니다.

파라미터:

input - 새로운 입력 캐릭터 순차 순서

반환값:

이 정규 표현 엔진

start

public int start()

전회의 성냥의 개시 인덱스를 돌려줍니다.

반환값:

매치한 최초의 캐릭터의 인덱스

예외:

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

start

public int start(int group)

전회의 매치 조작으로 지정된 그룹에 의해 전방 참조된 부분 순차 순서의, 개시 인덱스를 돌려줍니다.

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

파라미터:

group - 이 정규 표현 엔진의 패턴으로 지정되고 있는 전방 참조를 실시하는 정규 표현 그룹의 인덱스

반환값:

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

예외:

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

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

end

public int end()

마지막에 성냥 한 캐릭터의 인덱스에 1 을 더한 것을 돌려줍니다.

반환값:

마지막에 성냥 한 캐릭터의 인덱스에 1 을 더한 것

예외:

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

end

public int end(int group)

전회의 매치 조작으로 지정된 그룹에 의해 전방 참조된 부분 순차 순서의, 마지막 캐릭터의 인덱스에 1 을 더한 것을 돌려줍니다.

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

파라미터:

group - 이 정규 표현 엔진의 패턴으로 지정되고 있는 전방 참조를 실시하는 정규 표현 그룹의 인덱스

반환값:

이 그룹에 의해 전방 참조된 마지막 캐릭터의 인덱스에 1 을 더한 것. 성냥은 성공했지만, 그룹 자체는 성냥 하지 않았던 경우는 -1

예외:

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

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

group

public String  group()

전회의 성냥으로 일치한 입력 부분 순차 순서를 돌려줍니다.

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

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

반환값:

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

예외:

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

파라미터:

group - 이 정규 표현 엔진의 패턴으로 지정되고 있는 전방 참조를 실시하는 정규 표현 그룹의 인덱스

반환값:

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

예외:

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

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

groupCount

public int 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

appendReplacement

public Matcher  appendReplacement(StringBuffer  sb,
                                 String  replacement)

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

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

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

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

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

치환 캐릭터 라인에는 전회의 매치시에 전방 참조된 부분 순차 순서에의 참조가 포함되는 경우가 있습니다. $g 가 검출되면(자),group (g) 를 평가한 결과에 모두 치환됩니다. 예를 들어, 2 번째의 그룹이 캐릭터 라인 "foo" 와 성냥 했을 경우는 치환 캐릭터 라인 "$2bar" 를 건네주면(자),"foobar" 가 캐릭터 라인 버퍼에 추가됩니다. 달러 기호 ($)를 리터럴로서 치환 캐릭터 라인에 포함하는 경우는 그 전에 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();
 boolean result = m.find();
 while (m.appendReplacement(sb, "dog")) {
     result = m.find();
 }
 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 메소드와 같게, 전방 참조된 부분 순차 순서에의 참조가 치환 캐릭터 라인에 포함되는 경우가 있습니다.

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

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

파라미터:

replacement - 치환 캐릭터 라인

반환값:

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

replaceFirst

public String  replaceFirst(String  replacement)

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

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

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

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

파라미터:

replacement - 치환 캐릭터 라인

반환값:

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