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