Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Confrontare il testo con String.contentEquals

Confronta una String con un oggetto CharSequence o StringBuffer senza convertire l’argomento in String.

Versione: Java SE 21

Sintassi

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

String.contentEquals(CharSequence) verifica che le stesse unità di codice UTF-16 (valori char) compaiano nello stesso ordine. Il confronto distingue maiuscole e minuscole, non normalizza Unicode e funziona con un StringBuilder senza convertirlo in String. String.equals(Object), invece, riconosce soltanto un altro String con contenuto identico. contentEquals(StringBuffer) acquisisce il lock del buffer; l’overload CharSequence fa lo stesso se l’argomento è effettivamente un StringBuffer. Entrambi gli overload di contentEquals lanciano NullPointerException se ricevono null.

Esempi

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

Risultato

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

Lo `StringBuilder` ha lo stesso contenuto, ma non è una `String`: `contentEquals` restituisce `true` e `equals` restituisce `false`. L’overload per `StringBuffer` restituisce `true` prima di aggiungere `!` e `false` dopo.

Lezioni correlate

  • Java · Lezione 51 · Avanzato · Versione: 2

Fonti