WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Text mit String.contentEquals vergleichen

Vergleiche einen String mit einer CharSequence oder einem StringBuffer, ohne das Argument in einen String umzuwandeln.

Version: Java SE 21

Syntax

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

String.contentEquals(CharSequence) prüft, ob dieselben UTF-16-Codeeinheiten (char-Werte) in derselben Reihenfolge vorliegen. Die Methode unterscheidet Groß- und Kleinschreibung, normalisiert Unicode nicht und vergleicht auch einen StringBuilder ohne Umwandlung in String. String.equals(Object) akzeptiert dagegen nur einen anderen String mit identischem Inhalt. contentEquals(StringBuffer) synchronisiert sich auf dem Puffer; die CharSequence-Überladung tut das ebenfalls, wenn das Argument tatsächlich ein StringBuffer ist. Beide Überladungen von contentEquals werfen bei null eine NullPointerException.

Beispiele

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));
    }
}

Ergebnis

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

Der `StringBuilder` hat denselben Inhalt, ist aber kein `String`. Deshalb liefert `contentEquals` den Wert `true` und `equals` den Wert `false`. Die `StringBuffer`-Überladung liefert vor dem Anhängen von `!` den Wert `true` und danach `false`.

Zugehörige Lektionen

  • Java · Lektion 51 · Fortgeschritten · Version: 2

Quellen