CKTIS / Java
StringBuilder: capacità iniziale, lunghezza e crescita del buffer
Distingui la capacità del buffer dalla lunghezza del testo, concatena le chiamate ad append e verifica la crescita del buffer senza presumere una capacità finale precisa.
Versione: Java SE 21
Sintassi
java.lang.StringBuilder
public StringBuilder()
public StringBuilder(int capacity)
public StringBuilder append(String str)
public StringBuilder append(int i)
public String toString()
public int capacity()
public int length()In Java SE 21, java.lang.StringBuilder contiene testo modificabile. StringBuilder() crea un oggetto vuoto con capacità 16; StringBuilder(int) lo crea vuoto con esattamente la capacità indicata. In entrambi i casi la lunghezza iniziale è 0. Una capacità negativa provoca una NegativeArraySizeException.
length() conta le unità di codice UTF-16 (char) memorizzate, non i punti di codice Unicode. capacity() indica quante unità possono stare in tutto nel buffer corrente, incluse quelle già memorizzate. Non indica né i posti liberi né la dimensione in byte. Se l’aggiunta supera tale capacità, il buffer cresce automaticamente.
append(String) aggiunge testo in coda; un argomento di tipo String con valore null aggiunge "null". append(int) aggiunge la rappresentazione decimale dell’intero, non il carattere con quel codice. Entrambi gli overload modificano e restituiscono lo stesso oggetto, permettendo di concatenare le chiamate.
toString() restituisce uno String immutabile con il testo corrente. Le modifiche successive al builder non cambiano il risultato. Se puoi stimare la lunghezza finale, scegliere una capacità iniziale adeguata può ridurre le riallocazioni; tale capacità non è un limite di lunghezza.
Esempi
public class Main {
public static void main(String[] args) {
StringBuilder defaults = new StringBuilder();
StringBuilder text = new StringBuilder(4);
System.out.println("default: capacity=" + defaults.capacity()
+ ", length=" + defaults.length());
System.out.println("initial: capacity=" + text.capacity()
+ ", length=" + text.length());
text.append("ID=").append(123);
String result = text.toString();
int length = text.length();
if (text.capacity() < length) {
throw new AssertionError("capacity < length");
}
System.out.println("text=" + result);
System.out.println("length=" + length);
System.out.println("capacity >= length: true");
}
}Risultato
default: capacity=16, length=0 initial: capacity=4, length=0 text=ID=123 length=6 capacity >= length: true
Entrambi gli oggetti partono con lunghezza 0. Il secondo ha una capacità iniziale di 4 esatti. Le chiamate aggiungono `ID=` e `123`, e `toString()` restituisce `ID=123`, di lunghezza 6. Il buffer ha dovuto crescere; la verifica richiede solo `capacity() >= length()` e non presume una capacità precisa dopo la crescita.
Lezioni correlate
- Java · Lezione 49 · Avanzato · Versione: 2