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)를 리턴합니다.

반환값:

@return 마지막에 성냥 한 문자의 뒤의 오프셋(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* 등)에 따라서는 비어있는 캐릭터 라인과 성냥 하는 일이 있습니다. 이러한 패턴이 입력 순서내의 비어있는 캐릭터 라인과 성냥 했을 경우, 비어있는 캐릭터 라인이 리턴됩니다 .

반환값:

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

예외:

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

파라미터:

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

반환값:

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

예외:

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

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

groupCount

int groupCount()

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

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

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

반환값:

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