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

Строка замены может содержать ссылки на подпоследовательности, захваченные во время предыдущего поиска совпадения: каждое вхождение ${name} или $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 является быстро реагирующим на изменения и при обнаружении такого изменения в меру своих возможностей выбрасывает исключение 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 не имеет смысла.