Класс 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());

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

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

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

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

Строка замены может содержать ссылки на подпоследовательности, захваченные во время предыдущего совпадения: каждое вхождение $g будет заменено результатом вычисления group(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");
 StringBuilder sb = new StringBuilder();
 while (m.find()) {
     m.appendReplacement(sb, "dog");
 }
 m.appendTail(sb);
 System.out.println(sb.toString());

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

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

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

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

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

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

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

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

С учетом регулярного выражения dog, ввода "zzzdogzzzdogzzz" и функции mr -> mr.group().toUpperCase(), вызов этого метода на матчере для этого выражения вернет строку "zzzDOGzzzDOGzzz".

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

Функция замены не должна изменять состояние этого матчера во время замены. Этот метод будет, по возможности, выбрасывать исключение ConcurrentModificationException, если такое изменение будет обнаружено.

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

Каждый результат сопоставления генерируется как при вызове toMatchResult().

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

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

Состояние этого матчера не должно изменяться во время выполнения потока, возвращаемого методом. Источник возвращаемого потока Spliterator является fail-fast и будет, при возможности, выбрасывать ConcurrentModificationException в случае обнаружения такого изменения.

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

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

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

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

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

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

При заданном регулярном выражении dog, вводе "zzzdogzzzdogzzz" и функции mr -> mr.group().toUpperCase(), вызов этого метода на сопоставителе для этого выражения вернёт строку "zzzDOGzzzdogzzz".

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

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

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

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

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

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

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

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

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

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

По умолчанию сопоставитель использует непрозрачные границы.

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

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

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

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

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

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

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

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

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

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

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

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