Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes