Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

StringBuilder — un tampon de texte modifiable

StringBuilder permet de construire et de modifier du texte progressivement. Découvrez la différence entre longueur et capacité, ainsi que les effets de la troncature ou de l’extension de la séquence avec setLength.

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

Syntaxe

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

java.lang.StringBuilder est une séquence de caractères modifiable. append ajoute du contenu, et toString() crée le String résultant. La classe ne garantit pas la synchronisation ; ne partagez pas une instance modifiable entre plusieurs threads sans synchronisation appropriée.

StringBuilder() crée un tampon vide de capacité 16. StringBuilder(int) crée un tampon vide de la capacité indiquée ; une valeur négative provoque NegativeArraySizeException. La capacité initiale n’est pas la longueur du texte.

StringBuilder.length() renvoie le nombre d’unités char UTF-16 du contenu, qui ne correspond pas nécessairement au nombre de caractères visibles par l’utilisateur. StringBuilder.capacity() indique l’espace disponible pour ces unités, y compris les positions déjà occupées. La capacité augmente automatiquement lorsque davantage d’espace est nécessaire.

StringBuilder.setLength(int) renvoie void : une longueur plus petite tronque la fin, tandis qu’une longueur plus grande ajoute des caractères de valeur zéro ('\u0000'), et non des espaces. Une longueur négative provoque IndexOutOfBoundsException. setLength(0) supprime tout le contenu logique ; ne considérez pas cela comme un effacement sécurisé des données en mémoire.

Exemples

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

Résultat

0:16
4:8
Ja
4:0
0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources