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