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

CKTIS / Java

StringBuilder.append — ajouter du texte

StringBuilder.append(String) ajoute du texte à la fin d’un builder existant et renvoie ce même objet, ce qui permet d’enchaîner les appels.

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

Syntaxe

public StringBuilder append(String str)

StringBuilder.append possède plusieurs surcharges. La surcharge append(String str) ajoute les caractères de str dans leur ordre. Elle modifie le builder existant et renvoie une référence vers ce même objet, ce qui permet d’enchaîner les appels.

Pour un argument String dont la valeur est null, les quatre caractères "null" sont ajoutés. Dans l’exemple, missing est explicitement typé String, ce qui sélectionne la surcharge appropriée. toString() renvoie le résultat sous forme de String.

StringBuilder ne peut pas être partagé entre plusieurs threads en toute sécurité sans synchronisation.

Exemples

public class Main {
    public static void main(String[] args) {
        StringBuilder builder = new StringBuilder("Hello");
        String missing = null;
        builder.append(", ").append("Java").append("! ").append(missing);
        System.out.println(builder.toString());
    }
}

Résultat

Hello, Java! null

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