Matcher.ReplaceAll Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
ReplaceAll(IFunction) |
Remplace chaque 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. |
ReplaceAll(String) |
Remplace chaque sous-séquence de la séquence d’entrée qui correspond au modèle par la chaîne de remplacement donnée. |
ReplaceAll(IFunction)
Remplace chaque 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("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
Paramètres
- replacer
- IFunction
Fonction à appliquer au résultat de correspondance de ce matcheur qui retourne une chaîne de remplacement.
Retours
Chaîne construite en remplaçant chaque sous-séquence correspondante par le résultat de l’application de la fonction replacer à cette sous-séquence correspondante, en remplaçant les sous-séquences capturées selon les besoins.
- Attributs
Remarques
Remplace chaque 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 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 de correspondances du modèle. Les caractères qui ne font pas partie d’une correspondance sont ajoutés directement à la chaîne de résultat ; chaque correspondance est remplacée dans le résultat par l’application de la fonction replacer qui retourne une chaîne de remplacement. Chaque chaîne de remplacement peut contenir des références à des sous-séquences capturées comme dans la #appendReplacement appendReplacement
méthode.
Notez que les barres obliques inverses (\
) et les signes dollar ($
) dans une chaîne de remplacement peuvent entraîner la différence entre les résultats et le cas échéant comme une 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 dog
ré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 de chaque 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.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.
S’applique à
ReplaceAll(String)
Remplace chaque 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("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
Paramètres
- replacement
- String
Chaîne de remplacement
Retours
Chaîne construite en remplaçant chaque sous-file d’attente correspondante par la chaîne de remplacement, en remplaçant les sous-séquences capturées selon les besoins
- Attributs
Remarques
Remplace chaque 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 de correspondances du modèle. Les caractères qui ne font pas partie d’une correspondance sont ajoutés directement à la chaîne de résultat ; chaque 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 faire en sorte que les résultats soient différents de ceux qui étaient traités comme une 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 a*b
régulière , l’entrée "aabfooaabfooabfoob"
et la chaîne "-"
de remplacement , un appel de cette méthode sur un matcheur pour cette expression générerait la chaîne "-foo-foo-foo-"
.
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é.
Documentation Java pour java.util.regex.Matcher.replaceAll(java.lang.String)
.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.