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

CKTIS / Java

Comparar texto com String.contentEquals

Compara um String com um CharSequence ou um StringBuffer sem converter o argumento em String.

Versão: Java SE 21

Sintaxe

// Method declaration headers in java.lang.String
public boolean contentEquals(CharSequence cs)
public boolean contentEquals(StringBuffer sb)

String.contentEquals(CharSequence) verifica se as mesmas unidades de código UTF-16 (valores char) aparecem na mesma ordem. Distingue maiúsculas de minúsculas, não normaliza Unicode e funciona com um StringBuilder sem o converter em String. Em contrapartida, String.equals(Object) só considera igual outro String com conteúdo idêntico. contentEquals(StringBuffer) sincroniza no próprio buffer; a sobrecarga CharSequence também o faz se o argumento for realmente um StringBuffer. Ambas as sobrecargas de contentEquals lançam NullPointerException quando recebem null.

Exemplos

public class StringContentDemo {
    public static void main(String[] args) {
        String text = "abcd\u00E9";
        CharSequence sequence = new StringBuilder(text);
        System.out.println("contentEquals: " + text.contentEquals(sequence));
        System.out.println("equals: " + text.equals(sequence));

        StringBuffer buffer = new StringBuffer(text);
        System.out.println("contentEquals(StringBuffer): " + text.contentEquals(buffer));
        buffer.append('!');
        System.out.println("contentEquals(StringBuffer) after append: " + text.contentEquals(buffer));
    }
}

Resultado

contentEquals: true
equals: false
contentEquals(StringBuffer): true
contentEquals(StringBuffer) after append: false

O `StringBuilder` tem o mesmo conteúdo, mas não é um `String`: `contentEquals` devolve `true` e `equals` devolve `false`. A sobrecarga para `StringBuffer` devolve `true` antes de acrescentar `!` e `false` depois.

Lições relacionadas

  • Java · Lição 51 · Avançado · Versão: 2

Fontes