Matcher.ReplaceFirst Método

Definição

Namespace:: Java.Util.Regex

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

Nome	Description
ReplaceFirst(IFunction)	Substitui a primeira 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.
ReplaceFirst(String)	Substitui a primeira subsequência da sequência de entrada que corresponde ao padrão com a cadeia de caracteres de substituição fornecida.

ReplaceFirst(IFunction)

Substitui a primeira 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("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

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

String

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

Atributos: RegisterAttribute

Comentários

Esse método redefine primeiro esse correspondente. Em seguida, verifica a sequência de entrada procurando uma correspondência do padrão. Os caracteres que não fazem parte da correspondência são acrescentados diretamente à cadeia de caracteres de resultado; a correspondência é substituída no resultado pela aplicação da função de substituição que retorna uma 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 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 do resultado da correspondência passado para a função de substituição tem a garantia de ser constante apenas 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.replaceFirst(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

ReplaceFirst(String)

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

[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

Parâmetros

replacement: String

A cadeia de caracteres de substituição

Retornos

String

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

Atributos: RegisterAttribute

Comentários

Substitui a primeira 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 uma correspondência do padrão. Os caracteres que não fazem parte da correspondência são acrescentados diretamente à cadeia de caracteres de resultado; a 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.

Dada a expressão dogregular, a entrada "zzzdogzzzdogzzz"e a cadeia de caracteres "cat"de substituição, uma invocação desse método em um correspondente para essa expressão produziria a cadeia de caracteres "zzzcatzzzdogzzz".

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.

Documentação Java para java.util.regex.Matcher.replaceFirst(java.lang.String).

Aplica-se a