java.util.regex
인터페이스 MatchResult

기존의 구현 클래스의 일람:

Matcher

public interface MatchResult

매치 조작의 결과

이 인터페이스에는, 정규 검색에 대한 매치 결과의 판정에 사용하는 쿼리메소드가 포함됩니다. 매치 경계, 그룹, 및 그룹 경계는 볼 수가 있습니다만,MatchResult 에 의한 변경은 행해지지 않습니다.

도입된 버젼:

1.5

관련 항목:

Matcher

메소드의 개요

int	end () 마지막에 매치 한 문자의 뒤의 오프셋(offset)를 돌려줍니다.
int	end (int group) 이 매치 조작중으로 지정된 그룹에 의해 전방 참조된 부분 순서의, 최종 문자의 뒤의 오프셋(offset)를 돌려줍니다.
String	group () 전회의 매치으로 일치한 입력 부분 순서를 돌려줍니다.
String	group (int group) 전회의 매치 조작으로 지정된 그룹에 의해 전방 참조된 입력 부분 순서를 돌려줍니다.
int	groupCount () 이 매치 결과의 패턴으로 지정되고 있는, 전방 참조를 실시하는 정규 표현 그룹의 수를 돌려줍니다.
int	start () 매치의 개시 인덱스를 돌려줍니다.
int	start (int group) 이 매치 조작중으로 지정된 그룹에 의해 전방 참조된 부분 순서의, 개시 인덱스를 돌려줍니다.

메소드의 상세

start

int start()

매치의 개시 인덱스를 돌려줍니다.

반환값:

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

예외:

IllegalStateException - 매치가 아직 시도되지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

start

int start(int group)

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

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

파라미터:

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

반환값:

그룹에 의해 전방 참조된 최초의 문자의 인덱스. 매치은 성공했지만 그룹 자체는 어느 부분에도 매치 하지 않았던 경우는 -1

예외:

IllegalStateException - 매치가 아직 시도되지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

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

end

int end()

마지막에 매치 한 문자의 뒤의 오프셋(offset)를 돌려줍니다.

반환값:

마지막에 매치 한 문자의 뒤의 오프셋(offset)

예외:

IllegalStateException - 매치가 아직 시도되지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

end

int end(int group)

이 매치 조작중으로 지정된 그룹에 의해 전방 참조된 부분 순서의, 최종 문자의 뒤의 오프셋(offset)를 돌려줍니다.

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

파라미터:

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

반환값:

그룹에 의해 전방 참조된 마지막 문자의 뒤의 오프셋(offset). 매치은 성공했지만 그룹 자체는 어느 부분에도 매치 하지 않았던 경우는 -1

예외:

IllegalStateException - 매치가 아직 시도되지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

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

group

String  group()

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

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

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

반환값:

전회의 매치으로 일치한 부분 순서 (빈 상태(empty)의 경우도 있다). 캐릭터 라인 형식

예외:

IllegalStateException - 매치가 아직 시도되지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

group

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

파라미터:

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

반환값:

전회의 매치시에 그룹에 의해 전방 참조된 부분 순서 (빈 상태(empty)의 경우도 있다). 그룹이 입력의 일부에의 매치에 실패했을 경우는 null

예외:

IllegalStateException - 매치가 아직 시도되지 않은 경우, 또는 전회의 매치 조작이 실패했을 경우

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

groupCount

int groupCount()

이 매치 결과의 패턴으로 지정되고 있는, 전방 참조를 실시하는 정규 표현 그룹의 수를 돌려줍니다.

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

그룹 인덱스가 이 메소드로부터 반환된 값이하의 정의 정수인 경우는, 이 정규 표현 엔진으로 유효합니다.

반환값:

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