String.ReplaceFirst(String, String) Método

Definição

Substitui a primeira subcadeia de caracteres dessa cadeia de caracteres que corresponde à expressão regular fornecida com a substituição fornecida.

[Android.Runtime.Register("replaceFirst", "(Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String;", "")]
public string ReplaceFirst(string regex, string replacement);
[<Android.Runtime.Register("replaceFirst", "(Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String;", "")>]
member this.ReplaceFirst : string * string -> string

Parâmetros

regex
String

a expressão regular à qual essa cadeia de caracteres deve ser correspondida

replacement
String

a cadeia de caracteres a ser substituída pela primeira correspondência

Retornos

O resultado String

Atributos

Exceções

se regularExpression == null

Comentários

Substitui a primeira subcadeia de caracteres dessa cadeia de caracteres que corresponde à expressão regular fornecida com a substituição fornecida.

Uma invocação desse método do formulário str.replaceFirst(regex,repl) produz exatamente o mesmo resultado que a expressão

<blockquote> {@link java.util.regex.Pattern}.{@link java.util.regex.Pattern#compile compile}(<i>regex</i>).{@link java.util.regex.Pattern#matcher(java.lang.CharSequence) matcher}(<i>str</i>).{@link java.util.regex.Matcher#replaceFirst replaceFirst}(<i>repl</i>) </blockquote>

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; consulte java.util.regex.Matcher#replaceFirst. Use java.util.regex.Matcher#quoteReplacement para suprimir o significado especial desses caracteres, se desejado.

Adicionado em 1.4.

Documentação Java para java.lang.String.replaceFirst(java.lang.String, 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

Confira também