java.util.regex

Интерфейсный MatchResult

Все Известные Классы с реализацией:

Matcher

public interface MatchResult

Результат работы соответствия.

Этот интерфейс содержит методы запроса, используемые, чтобы определить результаты соответствия против регулярного выражения. Границы соответствия, группы и групповые границы могут быть замечены, но не изменены через a MatchResult.

С тех пор:

1.5

См. Также:

Matcher

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
int	end() Возвращает смещение после соответствующего последнего знака.
int	end(int group) Возвращает смещение после последнего знака подпоследовательности, полученной данной группой во время этого соответствия.
Строка	group() Возвращает входную подпоследовательность, соответствующую предыдущим соответствием.
Строка	group(int group) Возвращает входную подпоследовательность, полученную данной группой во время предыдущей работы соответствия.
int	groupCount() Возвращает число групп фиксации в этом образце результата соответствия.
int	start() Возвращает индекс запуска соответствия.
int	start(int group) Возвращает индекс запуска подпоследовательности, полученной данной группой во время этого соответствия.

Деталь метода

запустить

int start()

Возвращает индекс запуска соответствия.

Возвраты:

Индекс первого символа соответствовал

Броски:

IllegalStateException - Если никакое соответствие еще не было предпринято, или если предыдущая отказавшая работа соответствия

запустить

int start(int group)

Возвращает индекс запуска подпоследовательности, полученной данной группой во время этого соответствия.

Группы фиксации индексируются слева направо, запускаясь в одном. Групповой нуль обозначает весь образец, таким образом, выражение м. start(0) эквивалентно м. start().

Параметры:

group - Индекс группы фиксации в образце этого matcher

Возвраты:

Индекс первого символа, полученного группой, или -1, если соответствие было успешно, но сама группа, ничего не соответствовал

Броски:

IllegalStateException - Если никакое соответствие еще не было предпринято, или если предыдущая отказавшая работа соответствия

IndexOutOfBoundsException - Если нет никакой группы фиксации в образце с данным индексом

конец

int end()

Возвращает смещение после соответствующего последнего знака.

Возвраты:

@return смещение после последнего знака соответствовал

Броски:

IllegalStateException - Если никакое соответствие еще не было предпринято, или если предыдущая отказавшая работа соответствия

конец

int end(int group)

Возвращает смещение после последнего знака подпоследовательности, полученной данной группой во время этого соответствия.

Группы фиксации индексируются слева направо, запускаясь в одном. Групповой нуль обозначает весь образец, таким образом, выражение м. end(0) эквивалентно м. end().

Параметры:

group - Индекс группы фиксации в образце этого matcher

Возвраты:

Смещение после последнего знака, полученного группой, или -1, если соответствие было успешно, но сама группа, ничего не соответствовало

Броски:

IllegalStateException - Если никакое соответствие еще не было предпринято, или если предыдущая отказавшая работа соответствия

IndexOutOfBoundsException - Если нет никакой группы фиксации в образце с данным индексом

группа

String group()

Возвращает входную подпоследовательность, соответствующую предыдущим соответствием.

Для matcher м. с входной последовательностью s, выражения м. group() и s. substring( м. start(), м. end()) эквивалентен.

Отметьте, что некоторые образцы, например a*, соответствуют пустую строку. Этот метод возвратит пустую строку, когда образец успешно будет соответствовать пустую строку во вводе.

Возвраты:

(Возможно пустой) подпоследовательность, соответствующая предыдущим соответствием, в строковой форме

Броски:

IllegalStateException - Если никакое соответствие еще не было предпринято, или если предыдущая отказавшая работа соответствия

группа

String group(int group)

Возвращает входную подпоследовательность, полученную данной группой во время предыдущей работы соответствия.

Для matcher м. входная последовательность s, и группа индексируют г, выражения м. group( g) и s. substring( м. start( g), м. end( g)) эквивалентен.

Группы фиксации индексируются слева направо, запускаясь в одном. Групповой нуль обозначает весь образец, таким образом, выражение m.group(0) эквивалентно m.group().

Если соответствие было успешно, но определенная группа была не в состоянии соответствовать любую часть входной последовательности, то null возвращается. Отметьте, что некоторые группы, например (a*), соответствуют пустую строку. Этот метод возвратит пустую строку, когда такая группа успешно будет соответствовать пустую строку во вводе.

Параметры:

group - Индекс группы фиксации в образце этого matcher

Возвраты:

(Возможно пустой) подпоследовательность, полученная группой во время предыдущего соответствия, или null, если группа была не в состоянии соответствовать часть ввода

Броски:

IllegalStateException - Если никакое соответствие еще не было предпринято, или если предыдущая отказавшая работа соответствия

IndexOutOfBoundsException - Если нет никакой группы фиксации в образце с данным индексом

groupCount

int groupCount()

Возвращает число групп фиксации в этом образце результата соответствия.

Групповой нуль обозначает весь образец условно. Это не включается в это количество.

Любое неотрицательное целое число, меньшее чем или равный значению, возвращенному этим методом, как гарантируют, будет допустимым групповым индексом для этого matcher.

Возвраты:

Число групп фиксации в образце этого matcher