Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Porównywanie zawartości tekstu za pomocą String.contentEquals

Porównuj zawartość String z CharSequence lub StringBuffer bez konwersji argumentu na String.

Wersja: Java SE 21

Składnia

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

String.contentEquals(CharSequence) sprawdza, czy obie sekwencje mają te same jednostki UTF-16 (char) w tej samej kolejności. Rozróżnia wielkość liter, nie normalizuje Unicode i porównuje StringBuilder bez konwersji na String. Natomiast String.equals(Object) zwraca true tylko dla drugiego String o identycznej zawartości. Przeciążenie contentEquals(StringBuffer) synchronizuje się na buforze; wersja z CharSequence robi to również, gdy argument faktycznie jest StringBuffer. Argument null powoduje NullPointerException w obu przeciążeniach contentEquals.

Przykłady

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

Wynik

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

`StringBuilder` ma tę samą zawartość, ale nie jest obiektem `String`, stąd odpowiednio `true` dla `contentEquals` i `false` dla `equals`. Przeciążenie z `StringBuffer` zwraca `true` przed dopisaniem `!` i `false` po nim.

Powiązane lekcje

  • Java · Lekcja 51 · Zaawansowany · Wersja: 2

Źródła