CKTIS / Java
Comparar texto con String.contentEquals
Compara un String con un CharSequence o un StringBuffer sin convertir el argumento en String.
Versión: Java SE 21
Sintaxis
// Method declaration headers in java.lang.String
public boolean contentEquals(CharSequence cs)
public boolean contentEquals(StringBuffer sb)String.contentEquals(CharSequence) comprueba si las mismas unidades de código UTF-16 (valores char) aparecen en el mismo orden. Distingue mayúsculas de minúsculas, no normaliza Unicode y admite un StringBuilder sin convertirlo en String. En cambio, String.equals(Object) solo coincide con otro String de contenido idéntico. contentEquals(StringBuffer) bloquea el búfer, y la sobrecarga CharSequence también lo hace si el argumento es realmente un StringBuffer. Ambas sobrecargas de contentEquals lanzan NullPointerException si reciben null.
Ejemplos
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
El `StringBuilder` tiene el mismo contenido, pero no es un `String`: `contentEquals` devuelve `true` y `equals` devuelve `false`. La sobrecarga para `StringBuffer` devuelve `true` antes de añadir `!` y `false` después.
Lecciones relacionadas
- Java · Lección 51 · Avanzado · Versión: 2