CKTIS / Java
StringBuilder : capacité initiale, longueur et agrandissement du tampon
Distinguez la capacité du tampon de la longueur du texte, enchaînez les appels à append et vérifiez que le tampon a grandi sans supposer une capacité finale précise.
Version : Java SE 21
Syntaxe
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()Dans Java SE 21, java.lang.StringBuilder stocke du texte modifiable. StringBuilder() crée un objet vide de capacité 16 ; StringBuilder(int) crée un objet vide dont la capacité est exactement celle demandée. Dans les deux cas, la longueur initiale est de 0. Une capacité négative déclenche une NegativeArraySizeException.
length() compte les unités de code UTF-16 (char) stockées, et non les points de code Unicode. capacity() indique combien d’unités de code le tampon actuel peut contenir au total, unités déjà stockées comprises. Ce n’est ni le nombre de places libres ni une taille en octets. Lorsque l’ajout dépasse cette capacité, le tampon s’agrandit automatiquement.
append(String) ajoute du texte à la fin ; un argument de type String valant null ajoute "null". append(int) ajoute la représentation décimale de l’entier, et non le caractère de ce code. Les deux surcharges modifient et renvoient le même objet, ce qui permet d’enchaîner les appels.
toString() renvoie un String immuable contenant le texte actuel. Les modifications ultérieures du builder ne changent pas ce résultat. Si la longueur finale est prévisible, choisir une capacité initiale adaptée peut limiter les réallocations ; cette capacité n’est pas une limite de longueur.
Exemples
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");
}
}Résultat
default: capacity=16, length=0 initial: capacity=4, length=0 text=ID=123 length=6 capacity >= length: true
Les deux objets commencent avec une longueur de 0. Le second a une capacité initiale de 4 exactement. Les appels ajoutent `ID=` puis `123`, et `toString()` renvoie `ID=123`, de longueur 6. Le tampon a dû s’agrandir ; le test exige seulement `capacity() >= length()`, sans supposer de capacité précise après l’agrandissement.
Leçons associées
- Java · Leçon 49 · Avancé · Version : 2