Matcher.ReplaceFirst Метод

Определение

Перегрузки

Имя Описание
ReplaceFirst(IFunction)

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

ReplaceFirst(String)

Заменяет первую подсезону входной последовательности, которая соответствует шаблону заданной строкой замены.

ReplaceFirst(IFunction)

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

[Android.Runtime.Register("replaceFirst", "(Ljava/util/function/Function;)Ljava/lang/String;", "", ApiSince=34)]
public string ReplaceFirst(Java.Util.Functions.IFunction replacer);
[<Android.Runtime.Register("replaceFirst", "(Ljava/util/function/Function;)Ljava/lang/String;", "", ApiSince=34)>]
member this.ReplaceFirst : Java.Util.Functions.IFunction -> string

Параметры

replacer
IFunction

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

Возвращаемое значение

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

Атрибуты

Комментарии

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

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

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

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

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

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

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

Добавлено в 9.

Java документации по java.util.regex.Matcher.replaceFirst(java.util.function.Function<java.util.regex.MatchResult, java.lang.String>).

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Применяется к

ReplaceFirst(String)

Заменяет первую подсезону входной последовательности, которая соответствует шаблону заданной строкой замены.

[Android.Runtime.Register("replaceFirst", "(Ljava/lang/String;)Ljava/lang/String;", "")]
public string ReplaceFirst(string replacement);
[<Android.Runtime.Register("replaceFirst", "(Ljava/lang/String;)Ljava/lang/String;", "")>]
member this.ReplaceFirst : string -> string

Параметры

replacement
String

замещающая строка

Возвращаемое значение

Строка, созданная путем замены первого соответствующего подсечета строкой замены, заменив захваченные вложенные значения по мере необходимости.

Атрибуты

Комментарии

Заменяет первую подсезону входной последовательности, которая соответствует шаблону заданной строкой замены.

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

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

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

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

Java документации по java.util.regex.Matcher.replaceFirst(java.lang.String).

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Применяется к