Класс 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, то будут использоваться непрозрачные границы.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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