Matcher.ReplaceFirst Méthode

Définition

Espace de noms:

Java.Util.Regex

Assembly:

Mono.Android.dll

Surcharges

Nom	Description
ReplaceFirst(IFunction)	Remplace la première sous-séquence de la séquence d’entrée qui correspond au modèle par le résultat de l’application de la fonction replacer donnée au résultat de correspondance de ce matcheur correspondant à cette sous-séquence.
ReplaceFirst(String)	Remplace la première sous-séquence de la séquence d’entrée qui correspond au modèle par la chaîne de remplacement donnée.

ReplaceFirst(IFunction)

Remplace la première sous-séquence de la séquence d’entrée qui correspond au modèle par le résultat de l’application de la fonction replacer donnée au résultat de correspondance de ce matcheur correspondant à cette sous-séquence.

[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

Paramètres

replacer

IFunction

Fonction à appliquer au résultat de correspondance de ce matcheur qui retourne une chaîne de remplacement.

Retours

String

Chaîne construite en remplaçant la première sous-séquence correspondante par le résultat de l’application de la fonction replacer à la sous-séquence correspondante, en remplaçant les sous-séquences capturées selon les besoins.

Attributs

RegisterAttribute

Remarques

Remplace la première sous-séquence de la séquence d’entrée qui correspond au modèle par le résultat de l’application de la fonction replacer donnée au résultat de correspondance de ce matcheur correspondant à cette sous-séquence. Les exceptions levées par la fonction replace sont relayées à l’appelant.

Cette méthode réinitialise d’abord ce matcheur. Il analyse ensuite la séquence d’entrée à la recherche d’une correspondance du modèle. Les caractères qui ne font pas partie de la correspondance sont ajoutés directement à la chaîne de résultat ; la correspondance est remplacée dans le résultat par l’application de la fonction replacer qui retourne une chaîne de remplacement. La chaîne de remplacement peut contenir des références aux sous-séquences capturées comme dans la #appendReplacement appendReplacement méthode.

Notez que les barres obliques inverses (\) et les signes dollar ($) dans la chaîne de remplacement peuvent entraîner la différence entre les résultats et la chaîne de remplacement littérale. Les signes dollar peuvent être traités comme des références aux sous-séquences capturées comme décrit ci-dessus, et les barres obliques inverses sont utilisées pour échapper des caractères littéraux dans la chaîne de remplacement.

Étant donné l’expression dogrégulière , l’entrée "zzzdogzzzdogzzz"et la fonction mr -> mr.group().toUpperCase(), un appel de cette méthode sur un matcher pour cette expression générerait la chaîne "zzzDOGzzzdogzzz".

L’appel de cette méthode modifie l’état de ce matcheur. Si le matcheur doit être utilisé dans d’autres opérations de correspondance, il doit d’abord être réinitialisé.

La fonction replacer ne doit pas modifier l’état de ce matcheur pendant le remplacement. Cette méthode génère, sur une base optimale, une java.util.ConcurrentModificationException levée si une telle modification est détectée.

L’état du résultat de correspondance passé à la fonction replacer est garanti être constant uniquement pendant la durée de l’appel de fonction replacer et uniquement si la fonction replacer ne modifie pas l’état de ce matcheur.

Ajouté dans 9.

Java documentation pour java.util.regex.Matcher.replaceFirst(java.util.function.Function<java.util.regex.MatchResult, java.lang.String>).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

ReplaceFirst(String)

Remplace la première sous-séquence de la séquence d’entrée qui correspond au modèle par la chaîne de remplacement donnée.

[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

Paramètres

replacement

String

Chaîne de remplacement

Retours

String

Chaîne construite en remplaçant la première sous-séquence correspondante par la chaîne de remplacement, en remplaçant les sous-séquences capturées selon les besoins

Attributs

RegisterAttribute

Remarques

Remplace la première sous-séquence de la séquence d’entrée qui correspond au modèle par la chaîne de remplacement donnée.

Cette méthode réinitialise d’abord ce matcheur. Il analyse ensuite la séquence d’entrée à la recherche d’une correspondance du modèle. Les caractères qui ne font pas partie de la correspondance sont ajoutés directement à la chaîne de résultat ; la correspondance est remplacée dans le résultat par la chaîne de remplacement. La chaîne de remplacement peut contenir des références aux sous-séquences capturées comme dans la #appendReplacement appendReplacement méthode.

Notez que les barres obliques inverses (\) et les signes dollar ($) dans la chaîne de remplacement peuvent entraîner la différence entre les résultats et la chaîne de remplacement littérale. Les signes dollar peuvent être traités comme des références aux sous-séquences capturées comme décrit ci-dessus, et les barres obliques inverses sont utilisées pour échapper des caractères littéraux dans la chaîne de remplacement.

Étant donné l’expression dogrégulière , l’entrée "zzzdogzzzdogzzz"et la chaîne "cat"de remplacement , un appel de cette méthode sur un matcheur pour cette expression générerait la chaîne "zzzcatzzzdogzzz".

L’appel de cette méthode modifie l’état de ce matcheur. Si le matcheur doit être utilisé dans d’autres opérations de correspondance, il doit d’abord être réinitialisé.

Java documentation pour java.util.regex.Matcher.replaceFirst(java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.