Matcher.ReplaceFirst メソッド

定義

名前空間:
Java.Util.Regex
アセンブリ:
Mono.Android.dll

オーバーロード

名前 説明
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

最初の一致するサブシーケンスを、一致したサブシーケンスに replacer 関数を適用した結果に置き換えることによって構築された文字列。キャプチャされたサブシーケンスは必要に応じて置き換えられます。

属性
RegisterAttribute

注釈

パターンに一致する入力シーケンスの最初のサブシーケンスを、そのサブシーケンスに対応するこのマッチャーの一致結果に指定された置換関数を適用した結果に置き換えます。 replace 関数によってスローされた例外は、呼び出し元に中継されます。

このメソッドは、最初にこのマッチャーをリセットします。 次に、入力シーケンスをスキャンして、パターンの一致を探します。 一致の一部ではない文字は、結果文字列に直接追加されます。置換文字列を返す replacer 関数を適用することで、一致が結果に置き換えられます。 置換文字列には、 #appendReplacement appendReplacement メソッドのようにキャプチャされたサブシーケンスへの参照が含まれている場合があります。

置換文字列の円記号 (\) とドル記号 ($) によって、結果がリテラル置換文字列として扱われている場合とは異なる場合があることに注意してください。 ドル記号は、前述のようにキャプチャされたサブシーケンスへの参照として扱われ、円記号は置換文字列内のリテラル文字をエスケープするために使用されます。

正規表現 dog、入力 "zzzdogzzzdogzzz"、関数が mr -> mr.group().toUpperCase()場合、その式のマッチャーでこのメソッドを呼び出すと、文字列 "zzzDOGzzzdogzzz"が生成されます。

このメソッドを呼び出すと、このマッチャーの状態が変更されます。 さらに一致する操作でマッチャーを使用する場合は、最初にリセットする必要があります。

replacer 関数は、置換中にこのマッチャーの状態を変更しないでください。 このメソッドは、ベスト エフォートベースで、そのような変更が検出された場合に java.util.ConcurrentModificationException をスローします。

replacer 関数に渡される一致結果の状態は、replacer 関数呼び出しの期間中、および置換関数がこのマッチャーの状態を変更しない場合にのみ、定数であることが保証されます。

9 に追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

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ドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象