MatchResult — 매칭 연산의 결과

MatchResult — 매칭 연산의 결과

MatchResult매칭 연산의 결과를 나타내는 인터페이스예요. 정규 표현식에 대한 매치 결과를 결정하는 조회 메서드를 포함해요. 매치 경계, 그룹, 그룹 경계는 MatchResult를 통해 볼 수 있지만 수정할 수는 없어요.

출처: Java API Reference

본문

public interface MatchResult

Matcher가 이 인터페이스를 구현해요. Matcher.toMatchResult()가 반환하는 객체도 이 인터페이스를 구현하고, 이후 matcher에 가해지는 연산의 영향을 받지 않아요.

메서드

  • start() / start(int group) / start(String name) — 매치 또는 그룹 캡처 부분 시퀀스의 시작 인덱스를 반환해요. 그룹은 왼쪽에서 오른쪽으로 1부터 인덱스되고, 그룹 0은 전체 패턴이에요.
  • end() / end(int group) / end(String name) — 일치한 마지막 문자의 다음 오프셋을 반환해요.
  • group() / group(int group) / group(String name) — 이전 매치에 의해 일치/캡처된 입력 부분 시퀀스를 반환해요. m.group()s.substring(m.start(), m.end())와 동등해요. 그룹이 입력의 어떤 부분과도 일치하지 않으면 null을 반환해요.
  • groupCount() — 캡처링 그룹 수를 반환해요. 그룹 0(전체 패턴)은 포함되지 않아요.
  • namedGroups() — 캡처링 그룹 이름을 그룹 번호로 매핑한 수정 불가능한 맵을 반환해요. 명명 그룹이 없으면 빈 맵을 반환해요.
  • hasMatch() — 이전 매치/find 연산에서 유효한 매치가 있는지 반환해요.

더 알아보기 (Learn more)