Compartilhar via


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 corda a ser substituída para a primeira partida

Retornos

O resultado String

Atributos

Exceções

if 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 cifrões ($) na cadeia de caracteres de substituição podem fazer com que os resultados sejam diferentes do que se ela estivesse sendo tratada 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 usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Aplica-se a

Confira também