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.
Части этой страницы — это изменения на основе работы, созданной и общей 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 и используемых в соответствии с условиями, описанными в разделе "".