Matcher.ReplaceFirst Methode

[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

Parameter

Gibt zurück

Die Zeichenfolge, die erstellt wird, indem sie die erste übereinstimmende Untersequence durch das Ergebnis des Anwendens der Ersetzungsfunktion auf die übereinstimmende Subsequence ersetzt, wobei erfasste Subsequences nach Bedarf ersetzt werden.

Attribute

RegisterAttribute

Hinweise

Ersetzt die erste Untermenge der Eingabesequenz, die dem Muster entspricht, mit dem Ergebnis, dass die angegebene Ersetzungsfunktion auf das Übereinstimmungsergebnis dieses Matchers angewendet wird, das dieser Untermenge entspricht. Ausnahmen, die von der Ersetzungsfunktion ausgelöst werden, werden an den Aufrufer weitergeleitet.

Diese Methode setzt zuerst diesen Matcher zurück. Anschließend wird die Eingabesequenz überprüft, die nach einer Übereinstimmung des Musters sucht. Zeichen, die nicht Teil der Übereinstimmung sind, werden direkt an die Ergebniszeichenfolge angefügt. die Übereinstimmung wird im Ergebnis durch die Anwendung der Ersetzungsfunktion ersetzt, die eine Ersetzungszeichenfolge zurückgibt. Die Ersetzungszeichenfolge kann Verweise auf erfasste Untersequences wie in der #appendReplacement appendReplacement Methode enthalten.

Beachten Sie, dass umgekehrte Schrägstriche (\) und Dollarzeichen ($) in der Ersetzungszeichenfolge dazu führen können, dass sich die Ergebnisse unterscheiden, als wenn sie als Literalersetzungszeichenfolge behandelt wurden. Dollarzeichen können wie oben beschrieben als Verweise auf erfasste Untersequences behandelt werden, und umgekehrte Schrägstriche werden verwendet, um Literalzeichen in der Ersetzungszeichenfolge zu escapen.

Aufgrund des regulären Ausdrucks dog, der Eingabe "zzzdogzzzdogzzz"und der Funktion mr -> mr.group().toUpperCase()würde ein Aufruf dieser Methode für einen Abgleich für diesen Ausdruck die Zeichenfolge "zzzDOGzzzdogzzz"liefern.

Durch Aufrufen dieser Methode wird der Zustand dieses Übereinstimmungers geändert. Wenn der Matcher in weiteren Abgleichsvorgängen verwendet werden soll, sollte er zuerst zurückgesetzt werden.

Die Ersetzungsfunktion sollte den Zustand dieses Übereinstimmungers während des Austauschs nicht ändern. Diese Methode löst auf best-effort-Basis eine java.util.ConcurrentModificationException solche Änderung aus, wenn diese Änderung erkannt wird.

Der Zustand des an die Ersetzungsfunktion übergebenen Übereinstimmungsergebnisses ist garantiert nur für die Dauer des Ersetzungsfunktionsaufrufs konstant und nur, wenn die Ersetzungsfunktion den Zustand dieses Abgleichs nicht ändert.

Hinzugefügt in 9.

Java Dokumentation für java.util.regex.Matcher.replaceFirst(java.util.function.Function<java.util.regex.MatchResult, java.lang.String>).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

[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

Parameter

Gibt zurück

Die Zeichenfolge, die erstellt wird, indem Sie die erste übereinstimmende Untermenge durch die Ersetzungszeichenfolge ersetzen und erfasste Untersequencen nach Bedarf ersetzen

Attribute

RegisterAttribute

Hinweise

Ersetzt die erste Untermenge der Eingabesequenz, die dem Muster mit der angegebenen Ersetzungszeichenfolge entspricht.

Diese Methode setzt zuerst diesen Matcher zurück. Anschließend wird die Eingabesequenz überprüft, die nach einer Übereinstimmung des Musters sucht. Zeichen, die nicht Teil der Übereinstimmung sind, werden direkt an die Ergebniszeichenfolge angefügt. die Übereinstimmung wird im Ergebnis durch die Ersetzungszeichenfolge ersetzt. Die Ersetzungszeichenfolge kann Verweise auf erfasste Untersequences wie in der #appendReplacement appendReplacement Methode enthalten.

Beachten Sie, dass umgekehrte Schrägstriche (\) und Dollarzeichen ($) in der Ersetzungszeichenfolge dazu führen können, dass sich die Ergebnisse unterscheiden, als wenn sie als Literalersetzungszeichenfolge behandelt wurden. Dollarzeichen können wie oben beschrieben als Verweise auf erfasste Untersequences behandelt werden, und umgekehrte Schrägstriche werden verwendet, um Literalzeichen in der Ersetzungszeichenfolge zu escapen.

Aufgrund des regulären Ausdrucks dog, der Eingabe "zzzdogzzzdogzzz"und der Ersetzungszeichenfolge "cat"würde ein Aufruf dieser Methode für einen Abgleich für diesen Ausdruck die Zeichenfolge "zzzcatzzzdogzzz"liefern.

Durch Aufrufen dieser Methode wird der Zustand dieses Übereinstimmungers geändert. Wenn der Matcher in weiteren Abgleichsvorgängen verwendet werden soll, sollte er zuerst zurückgesetzt werden.

Java Dokumentation für java.util.regex.Matcher.replaceFirst(java.lang.String).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.