Matcher.ReplaceAll 方法

定義

命名空間:

Java.Util.Regex

組件:

Mono.Android.dll

多載

ReplaceAll(IFunction)	將符合模式的輸入序列的每個子序列取代為將指定取代項函式套用至對應至該子序列之比對器比對結果的結果。
ReplaceAll(String)	以指定的取代字串取代符合模式的輸入序列的每個子序列。

ReplaceAll(IFunction)

將符合模式的輸入序列的每個子序列取代為將指定取代項函式套用至對應至該子序列之比對器比對結果的結果。

[Android.Runtime.Register("replaceAll", "(Ljava/util/function/Function;)Ljava/lang/String;", "", ApiSince=34)]
public string ReplaceAll (Java.Util.Functions.IFunction replacer);

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

參數

replacer

IFunction

要套用至傳回取代字串之比對器比對結果的函式。

傳回

String

藉由將每個相符的子序列取代為將 replacer 函式套用至該相符子序列的結果所建構的字串，並視需要取代擷取的子序列。

屬性

RegisterAttribute

備註

將符合模式的輸入序列的每個子序列取代為將指定取代項函式套用至對應至該子序列之比對器比對結果的結果。 函式擲回的例外狀況會轉送給呼叫端。

此方法會先重設此比對器。 然後，它會掃描輸入序列，尋找模式的相符專案。 不屬於任何相符專案的字元會直接附加至結果字串;會套用傳回取代字串的取代函式，來取代結果中的每個相符專案。 每個取代字串可能包含方法中所擷取子序列的 #appendReplacement appendReplacement 參考。

請注意，取代字串中的反斜杠 （\） 和貨幣符號 （$） 可能會導致結果與被視為常值取代字串時的結果不同。 貨幣符號可能會被視為所擷取子序列的參考，如上述所述，反斜杠可用來逸出取代字串中的常值字元。

假設正規表示式 dog、輸入 "zzzdogzzzdogzzz"和 mr -> mr.group().toUpperCase()函式，該表示式的比對器上這個方法的呼叫會產生字串 "zzzDOGzzzDOGzzz"。

叫用此方法會變更此比對器的狀態。 如果要在進一步比對作業中使用比對器，則應該先重設。

取代器函式不應在取代期間修改此比對器的狀態。 如果偵測到這類修改，此方法會盡最大努力擲回 java.util.ConcurrentModificationException 。

傳遞至取代器函式之每個比對結果的狀態保證只有在取代器函式呼叫期間才會是常數，而且只有在 replacer 函式未修改此比對器的狀態時， 才會是常數。

已在 9 中新增。

的 java.util.regex.Matcher.replaceAll(java.util.function.Function<java.util.regex.MatchResult, java.lang.String>)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

ReplaceAll(String)

以指定的取代字串取代符合模式的輸入序列的每個子序列。

[Android.Runtime.Register("replaceAll", "(Ljava/lang/String;)Ljava/lang/String;", "")]
public string ReplaceAll (string replacement);

[<Android.Runtime.Register("replaceAll", "(Ljava/lang/String;)Ljava/lang/String;", "")>]
member this.ReplaceAll : string -> string

參數

replacement

String

取代字串

傳回

String

由取代字串取代每個相符子序列所建構的字串，並視需要取代擷取的子序列

屬性

RegisterAttribute

備註

以指定的取代字串取代符合模式的輸入序列的每個子序列。

此方法會先重設此比對器。 然後，它會掃描輸入序列，尋找模式的相符專案。 不屬於任何相符專案的字元會直接附加至結果字串;每個相符項目都會由取代字串取代結果中。 取代字串可能包含 方法中所擷取子序列的 #appendReplacement appendReplacement 參考。

請注意，取代字串中的反斜杠 （\） 和貨幣符號 （$） 可能會導致結果與將結果視為常值取代字串時不同。 貨幣符號可能會被視為所擷取子序列的參考，如上述所述，反斜杠可用來逸出取代字串中的常值字元。

假設正規表示式 a*b、輸入 "aabfooaabfooabfoob"和取代字串 "-"，該表示式的比對器上這個方法的呼叫會產生字串 "-foo-foo-foo-"。

叫用此方法會變更此比對器的狀態。 如果要在進一步比對作業中使用比對器，則應該先重設。

的 java.util.regex.Matcher.replaceAll(java.lang.String)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。