Класс Matcher

Изменяет Pattern используемый этим Matcher для поиска совпадений.

Этот метод заставляет это совпадение потерять информацию о группах последнего выполненного сопоставления. Позиция совпадения в входных данных сохраняется, и последняя позиция добавления не изменяется.

Сбрасывает это совпадение.

Сброс совпадения отбрасывает всю информацию о его явном состоянии и устанавливает его позицию добавления в ноль. Область совпадения устанавливается в стандартную область, которая является всем последовательностью символов. Якорные и прозрачные границы области совпадения не затрагиваются.

Сбрасывает это совпадение с новой последовательностью входных данных.

Сброс совпадения отбрасывает всю информацию о его явном состоянии и устанавливает его позицию добавления в ноль. Область совпадения устанавливается в стандартную область, которая является всем последовательностью символов. Якорные и прозрачные границы области совпадения не затрагиваются.

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

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

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

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

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

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

Обратите внимание, что некоторые шаблоны, например a*, сопоставляют пустую строку. Этот метод вернёт пустую строку, когда шаблон успешно сопоставится с пустой строкой во входных данных.

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

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

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

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

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

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

Возвращает количество захватывающих групп в шаблоне этого совпадения.

Группа ноль по умолчанию обозначает весь шаблон. Она не включена в этот счёт.

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

Пытается сопоставить всю область с шаблоном.

Если сопоставление успешно, то больше информации можно получить через методы start, end, и group.

Попытка найти следующую подпоследовательность входной последовательности, которая соответствует шаблону.

Этот метод начинается с начала области этого соответствия или, если предыдущее обращение к методу было успешным и сопоставитель с тех пор не был сброшен, с первого символа, не соответствующего предыдущему соответствию.

Если соответствие успешно, дополнительную информацию можно получить с помощью методов start, end, и group.

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

Если соответствие успешно, дополнительную информацию можно получить с помощью методов start, end, и group, и последующие обращения к методу find() будут начинаться с первого символа, не соответствующего этому соответствию.

Попытка сопоставить входную последовательность, начиная с начала области, с шаблоном.

Подобно методу matches, этот метод всегда начинается с начала области; в отличие от этого метода, он не требует, чтобы вся область соответствовала шаблону.

Если соответствие успешно, дополнительную информацию можно получить с помощью методов start, end, и group.

Реализует нетерминальную операцию добавления и замены.

Этот метод выполняет следующие действия:

1. Он считывает символы из входной последовательности, начиная с позиции добавления, и добавляет их к заданному буферу строк. Он останавливается после считывания последнего символа, предшествующего предыдущему соответствию, то есть символа с индексом start() - 1.

2. Он добавляет заданную строку замены в буфер строк.

3. Он устанавливает позицию добавления этого соответствия в индекс последнего сопоставленного символа плюс один, то есть в end().

Строка замены может содержать ссылки на подпоследовательности, захваченные во время предыдущего соответствия: каждое вхождение ${имя} или $g будет заменено результатом вычисления соответствующего group(name) или group(g) соответственно. Для $g, первая цифра после $ всегда рассматривается как часть ссылки на группу. Последующие цифры включаются в g, если они образуют законную ссылку на группу. Только цифры от '0' до '9' рассматриваются как потенциальные компоненты ссылки на группу. Если вторая группа соответствует строке "foo", например, то передача строки замены "$2bar" приведет к добавлению "foobar" в буфер строк. Знак доллара ($) может быть включен как буквальный символ в строку замены, предваряя его обратной косой чертой (\$).

Обратите внимание, что обратные косые черты (\) и знаки доллара ($) в строке замены могут привести к результатам, отличным от тех, если бы она рассматривалась как строка буквальной замены. Знаки доллара могут рассматриваться как ссылки на захваченные подпоследовательности, как описано выше, а обратные косые черты используются для экранирования буквенных символов в строке замены.

Этот метод предназначен для использования в цикле вместе с методами 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();
while (m.find()) {
    m.appendReplacement(sb, "dog");
}
m.appendTail(sb);
System.out.println(sb.toString());

Реализует терминальную операцию добавления и замены.

Этот метод считывает символы из входной последовательности, начиная с позиции добавления, и добавляет их в заданный буфер строк. Он предназначен для вызова после одной или нескольких вызовов метода appendReplacement для копирования остатка входной последовательности.

Заменяет каждую подпоследовательность входной последовательности, которая соответствует шаблону, заданной строкой замены.

Этот метод сначала сбрасывает это соответствие. Затем он сканирует входную последовательность в поисках совпадений с шаблоном. Символы, которые не являются частью совпадения, добавляются непосредственно в результирующую строку; каждое совпадение заменяется в результате строкой замены. Строка замены может содержать ссылки на захваченные подпоследовательности, как и в методе appendReplacement.

Обратите внимание, что обратные косые черты (\) и знаки доллара ($) в строке замены могут привести к результатам, отличным от тех, если бы она рассматривалась как строка буквальной замены. Знаки доллара могут рассматриваться как ссылки на захваченные подпоследовательности, как описано выше, а обратные косые черты используются для экранирования буквальных символов в строке замены.

При регулярном выражении a*b, вводе "aabfooaabfooabfoob" и строке замены "-", вызов этого метода для соответствия этому выражению вернет строку "-foo-foo-foo-".

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

Заменяет первую подпоследовательность входной последовательности, которая соответствует шаблону, заданной строкой замены.

Этот метод сначала сбрасывает это соответствие. Затем он сканирует входную последовательность в поисках совпадения с шаблоном. Символы, которые не являются частью совпадения, добавляются непосредственно в результирующую строку; совпадение заменяется в результате строкой замены. Строка замены может содержать ссылки на захваченные подпоследовательности, как и в методе appendReplacement.

Обратите внимание, что обратные косые черты (\) и знаки доллара ($) в строке замены могут привести к результатам, отличным от тех, если бы она рассматривалась как строка буквальной замены. Знаки доллара могут рассматриваться как ссылки на захваченные подпоследовательности, как описано выше, а обратные косые черты используются для экранирования буквальных символов в строке замены.

При регулярном выражении dog, вводе "zzzdogzzzdogzzz" и строке замены "cat", вызов этого метода для соответствия этому выражению вернет строку "zzzcatzzzdogzzz".

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

Устанавливает границы области поиска этого соответствия. Область — это часть входной последовательности, которая будет просматриваться для поиска совпадения. Вызов этого метода сбрасывает соответствие и затем устанавливает область, начиная с индекса, заданного параметром start, и заканчивая индексом, заданным параметром end.

В зависимости от используемой прозрачности и привязки (см. useTransparentBounds и useAnchoringBounds), некоторые конструкции, такие как якоря, могут вести себя иначе в границах области.

Запрашивает прозрачность границ области для этого согласующего объекта.

Этот метод возвращает true если этот согласующий объект использует прозрачные границы, false если он использует непрозрачные границы.

См. useTransparentBounds для описания прозрачных и непрозрачных границ.

По умолчанию согласующий объект использует непрозрачные границы области.

Устанавливает прозрачность границ области для этого согласующего объекта.

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

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

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

По умолчанию согласующий объект использует непрозрачные границы.

Запрашивает привязку границ области для этого согласующего объекта.

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

См. useAnchoringBounds для описания привязанных границ.

По умолчанию согласующий объект использует привязанные границы области.

Устанавливает привязку границ области для этого согласующего объекта.

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

При использовании привязанных границ границы области этого согласующего объекта соответствуют якорям, таким как ^ и $.

Без привязанных границ границы области этого согласующего объекта не будут соответствовать якорям, таким как ^ и $.

По умолчанию согласующий объект использует привязанные границы области.

Возвращает строковое представление этого согласующего объекта. Строковое представление Matcher содержит информацию, которая может быть полезна для отладки. Точный формат не определён.

Возвращает true, если в последней операции сопоставления, выполненной этим согласующим объектом, был достигнут конец входных данных.

Когда этот метод возвращает true, возможно, что больше входных данных изменили бы результат последнего поиска.

Возвращает true, если больше входных данных может изменить положительное соответствие на отрицательное.

Если этот метод возвращает true, и совпадение было найдено, значит больше входных данных может привести к потере совпадения. Если этот метод возвращает false, а совпадение было найдено, значит больше входных данных может изменить совпадение, но совпадение не будет потеряно. Если совпадение не было найдено, requireEnd не имеет смысла.