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

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

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

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

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

Описание привязывающих границ см. в useAnchoringBounds.

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

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

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

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

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

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

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

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

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

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