Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

StringBuilder: un buffer di testo modificabile

StringBuilder consente di creare e modificare il testo in modo progressivo. Scopri la differenza tra lunghezza e capacità e cosa succede quando setLength tronca o estende la sequenza.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

new StringBuilder();
new StringBuilder(8);
int length();
int capacity();
void setLength(int newLength);

java.lang.StringBuilder è una sequenza di caratteri modificabile. append aggiunge contenuto e toString() crea lo String risultante. La classe non garantisce la sincronizzazione; non condividere un’istanza modificabile tra thread senza un’adeguata sincronizzazione.

StringBuilder() crea un buffer vuoto con capacità 16. StringBuilder(int) crea un buffer vuoto con la capacità specificata; un valore negativo causa NegativeArraySizeException. La capacità iniziale non è la lunghezza del testo.

StringBuilder.length() restituisce il numero di unità char UTF-16 nel contenuto, che non corrisponde necessariamente al numero di caratteri visibili all’utente. StringBuilder.capacity() indica lo spazio disponibile per tali unità, comprese le posizioni già occupate. La capacità aumenta automaticamente quando serve più spazio.

StringBuilder.setLength(int) restituisce void: una lunghezza inferiore tronca la parte finale, mentre una lunghezza superiore aggiunge caratteri con valore zero ('\u0000'), non spazi. Una lunghezza negativa causa IndexOutOfBoundsException. setLength(0) rimuove tutto il contenuto logico; non considerarlo una cancellazione sicura dei dati dalla memoria.

Esempi

public class Main {
    public static void main(String[] args) {
        StringBuilder defaults = new StringBuilder();
        System.out.println(defaults.length() + ":" + defaults.capacity());

        StringBuilder text = new StringBuilder(8);
        text.append("Java");
        System.out.println(text.length() + ":" + text.capacity());

        text.setLength(2);
        System.out.println(text.toString());

        text.setLength(4);
        System.out.println(text.length() + ":" + (int) text.charAt(2));

        text.setLength(0);
        System.out.println(text.length());
    }
}

Risultato

0:16
4:8
Ja
4:0
0

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti