Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

String.replace — substituição literal de texto

String.replace substitui todas as correspondências literais sem utilizar expressões regulares. Devolve o resultado sem alterar a cadeia original.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public String replace(CharSequence target, CharSequence replacement)
public String replace(char oldChar, char newChar)

Com replace(CharSequence target, CharSequence replacement), String.replace substitui todas as ocorrências não sobrepostas de target por replacement, da esquerda para a direita. Ambos os argumentos são tratados literalmente: . e $ não têm qualquer significado especial.

String é imutável: guarde o valor devolvido. A cadeia original mantém-se inalterada. A sobrecarga replace(char oldChar, char newChar) substitui valores char individuais.

Ao contrário de replaceAll, este método não utiliza expressões regulares. O exemplo demonstra a substituição literal, as correspondências não sobrepostas e o facto de a cadeia original não ser alterada.

Exemplos

public class Main {
    public static void main(String[] args) {
        String text = "a.b.a";
        System.out.println(text.replace(".", "$"));
        System.out.println("aaa".replace("aa", "b"));
        System.out.println(text.replace('a', 'x'));
        System.out.println(text);
    }
}

Resultado

a$b$a
ba
x.b.x
a.b.a

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes