Matcher.ReplaceAll Método

Definição

Sobrecargas

Nome Description
ReplaceAll(IFunction)

Substitui cada subsequência da sequência de entrada que corresponde ao padrão com o resultado da aplicação da função de substituição determinada ao resultado da correspondência desse correspondente a essa subsequência.

ReplaceAll(String)

Substitui cada subsequência da sequência de entrada que corresponde ao padrão com a cadeia de caracteres de substituição fornecida.

ReplaceAll(IFunction)

Substitui cada subsequência da sequência de entrada que corresponde ao padrão com o resultado da aplicação da função de substituição determinada ao resultado da correspondência desse correspondente a essa subsequência.

[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

Parâmetros

replacer
IFunction

A função a ser aplicada ao resultado da correspondência desse correspondente que retorna uma cadeia de caracteres de substituição.

Retornos

A cadeia de caracteres construída substituindo cada subsequência correspondente pelo resultado da aplicação da função de substituição à subsequenteuência correspondente, substituindo subsequências capturadas conforme necessário.

Atributos

Comentários

Substitui cada subsequência da sequência de entrada que corresponde ao padrão com o resultado da aplicação da função de substituição determinada ao resultado da correspondência desse correspondente a essa subsequência. As exceções geradas pela função são retransmitidas para o chamador.

Esse método redefine primeiro esse correspondente. Em seguida, verifica a sequência de entrada procurando correspondências do padrão. Os caracteres que não fazem parte de nenhuma correspondência são acrescentados diretamente à cadeia de caracteres de resultado; cada correspondência é substituída no resultado pela aplicação da função de substituição que retorna uma cadeia de caracteres de substituição. Cada cadeia de caracteres de substituição pode conter referências a subsequências capturadas como no #appendReplacement appendReplacement método.

Observe que barras invertidas (\) e sinais de dólar ($) em uma cadeia de caracteres de substituição podem fazer com que os resultados sejam diferentes do que se estivessem sendo tratados como uma cadeia de caracteres de substituição literal. Os sinais de dólar podem ser tratados como referências a subsequências capturadas, conforme descrito acima, e as barras invertidas são usadas para escapar de caracteres literais na cadeia de caracteres de substituição.

Dada a expressão dogregular, a entrada "zzzdogzzzdogzzz"e a função mr -> mr.group().toUpperCase(), uma invocação desse método em um correspondente para essa expressão produziria a cadeia de caracteres "zzzDOGzzzDOGzzz".

Invocar esse método altera o estado desse correspondente. Se o correspondenter deve ser usado em outras operações correspondentes, ele deve primeiro ser redefinido.

A função de substituição não deve modificar o estado desse correspondente durante a substituição. Esse método, em uma base de melhor esforço, gerará um java.util.ConcurrentModificationException se essa modificação for detectada.

O estado de cada resultado de correspondência passado para a função de substituição é garantido como constante somente durante a chamada de função do substituto e somente se a função de substituição não modificar o estado desse correspondente.

Adicionado em 9.

Java documentação para java.util.regex.Matcher.replaceAll(java.util.function.Function<java.util.regex.MatchResult, java.lang.String>).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a

ReplaceAll(String)

Substitui cada subsequência da sequência de entrada que corresponde ao padrão com a cadeia de caracteres de substituição fornecida.

[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

Parâmetros

replacement
String

A cadeia de caracteres de substituição

Retornos

A cadeia de caracteres construída substituindo cada subsequência correspondente pela cadeia de caracteres de substituição, substituindo subsequências capturadas conforme necessário

Atributos

Comentários

Substitui cada subsequência da sequência de entrada que corresponde ao padrão com a cadeia de caracteres de substituição fornecida.

Esse método redefine primeiro esse correspondente. Em seguida, verifica a sequência de entrada procurando correspondências do padrão. Os caracteres que não fazem parte de nenhuma correspondência são acrescentados diretamente à cadeia de caracteres de resultado; cada correspondência é substituída no resultado pela cadeia de caracteres de substituição. A cadeia de caracteres de substituição pode conter referências a subsequências capturadas como no #appendReplacement appendReplacement método.

Observe que barras invertidas (\) e sinais de dólar ($) na cadeia de caracteres de substituição podem fazer com que os resultados sejam diferentes do que se estivessem sendo tratados como uma cadeia de caracteres de substituição literal. Os sinais de dólar podem ser tratados como referências a subsequências capturadas, conforme descrito acima, e as barras invertidas são usadas para escapar de caracteres literais na cadeia de caracteres de substituição.

Dada a expressão a*bregular, a entrada "aabfooaabfooabfoob"e a cadeia de caracteres "-"de substituição, uma invocação desse método em um correspondente para essa expressão produziria a cadeia de caracteres "-foo-foo-foo-".

Invocar esse método altera o estado desse correspondente. Se o correspondenter deve ser usado em outras operações correspondentes, ele deve primeiro ser redefinido.

Java documentação para java.util.regex.Matcher.replaceAll(java.lang.String).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Aplica-se a