Matcher.ReplaceFirst 方法

[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

参数

返回

通过将第一个匹配子序列替换为将替换器函数应用于匹配的子序列的结果，并根据需要替换捕获的子序列，构造的字符串。

属性

RegisterAttribute

注解

将输入序列的第一个子序列替换为将给定替换器函数应用于对应于该子序列的匹配结果的输入序列的第一个子序列。 replace 函数引发的异常将中继到调用方。

此方法首先重置此匹配程序。 然后，它会扫描输入序列，查找模式的匹配项。 不属于匹配项的字符将直接追加到结果字符串中;通过应用返回替换字符串的替换函数替换结果中替换匹配项。 替换字符串可能包含对捕获的子序列的引用，就像在方法中一 #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>)。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。

[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

参数

返回

通过替换字符串替换第一个匹配的子项来构造的字符串，根据需要替换捕获的子项

属性

RegisterAttribute

注解

将与模式匹配的输入序列的第一个子序列替换为给定的替换字符串。

此方法首先重置此匹配程序。 然后，它会扫描输入序列，查找模式的匹配项。 不属于匹配项的字符将直接追加到结果字符串中;匹配项在结果中替换为替换字符串。 替换字符串可能包含对捕获的子序列的引用，就像在方法中一 #appendReplacement appendReplacement 样。

请注意，替换字符串中的反斜杠 （\） 和美元符号 （$） 可能会导致结果与将其视为文本替换字符串时的结果不同。 美元符号可以被视为对捕获的子序列的引用，如前所述，反斜杠用于转义替换字符串中的文本字符。

给定正则表达式 dog、输入 "zzzdogzzzdogzzz"和替换字符串 "cat"，对该表达式的匹配程序调用此方法将生成字符串 "zzzcatzzzdogzzz"。

调用此方法会更改此匹配程序的状态。 如果要在进一步匹配操作中使用匹配程序，则应首先重置它。

Java文档java.util.regex.Matcher.replaceFirst(java.lang.String)。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。