語言

Matcher.ReplaceFirst 方法

定義

命名空間:
Java.Util.Regex
組件:
Mono.Android.dll

多載

名稱 Description
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

該函數將套用於該匹配器的匹配結果，回傳替換字串。

傳回

String

字串是透過替換第一個匹配子序列，替換函數對匹配子序列，並根據需要替換捕獲的子序列而構成。

屬性
RegisterAttribute

備註

將輸入序列中與模式匹配的第一個子序列替換為將該替換函數應用於該子序列匹配結果的結果。 替換函式拋出的異常會轉發給呼叫者。

此方法首先重置此匹配器。 接著掃描輸入序列，尋找圖案的匹配。 不屬於匹配的字元會直接附加到結果字串中;結果中會用替換函數替換，回傳替換字串。 替換字串可能包含對捕獲子序列的參考，如同方法 #appendReplacement appendReplacement 中所述。

請注意，替換字串中的反斜線（\）和美元符號$（）可能導致結果與直接視為替換字串時不同。 美元符號可視為上述捕捉子序列的參考，反斜線則用於替換字串中的字元逃逸。

給定正則表達式 dog、輸入 "zzzdogzzzdogzzz"、 及函數 mr -> mr.group().toUpperCase()，對該表達式的匹配器調用此方法將得到字串 "zzzDOGzzzdogzzz"。

啟動此方法會改變該匹配器的狀態。 若匹配器需用於後續匹配操作，則應先重置。

替換函數在替換過程中不應改變此匹配器的狀態。 此方法在嘗試嘗試時，若偵測到此類修改，會拋出 a java.util.ConcurrentModificationException 。

傳遞給替換函式的匹配結果狀態僅保證在替換函式呼叫期間保持常數，且替換函式不會修改該匹配器的狀態。

新增9。

Java 文件 java.util.regex.Matcher.replaceFirst(java.util.function.Function<java.util.regex.MatchResult, java.lang.String>)。

本頁部分內容為基於 Open Source 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

取代字串

傳回

String

字串是透過替換第一個匹配的子序列替換替換字串，並根據需要替換捕獲的子序列來構造的

屬性
RegisterAttribute

備註

用給定的替換字串替換輸入序列中與模式相符的第一個子序列。

此方法首先重置此匹配器。 接著掃描輸入序列，尋找圖案的匹配。 不屬於匹配的字元會直接附加到結果字串中;結果中會用替換串取代匹配。 替換字串可能包含對捕獲子序列的參考，如同方法 #appendReplacement appendReplacement 中所述。

請注意，替換字串中的反斜線（\）和美元符號$（）可能導致結果與直接視為替換字串時不同。 美元符號可視為上述捕捉子序列的參考，反斜線則用於替換字串中的字元逃逸。

給定正則表達 dog式 、輸入 "zzzdogzzzdogzzz"、 及替換字串 "cat"，對該表達式的匹配器調用此方法將得到字串 "zzzcatzzzdogzzz"。

啟動此方法會改變該匹配器的狀態。 若匹配器需用於後續匹配操作，則應先重置。

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

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於