WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

StringBuilder – ein veränderbarer Textpuffer

Mit StringBuilder kannst du Text schrittweise aufbauen und ändern. Erfahre den Unterschied zwischen Länge und Kapazität und was passiert, wenn setLength die Sequenz kürzt oder verlängert.

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

Syntax

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

java.lang.StringBuilder ist eine veränderbare Zeichenfolge. append fügt Inhalt hinzu, und toString() erstellt den resultierenden String. Die Klasse garantiert keine Synchronisierung; teile eine veränderbare Instanz nicht ohne geeignete Synchronisierung zwischen Threads.

StringBuilder() erstellt einen leeren Puffer mit einer Kapazität von 16. StringBuilder(int) erstellt einen leeren Puffer mit der angegebenen Kapazität; ein negativer Wert verursacht NegativeArraySizeException. Die Anfangskapazität ist nicht die Textlänge.

StringBuilder.length() gibt die Anzahl der UTF-16-char-Einheiten im Inhalt zurück, nicht unbedingt die Anzahl der für Nutzer sichtbaren Zeichen. StringBuilder.capacity() gibt den Platz für diese Einheiten an, einschließlich bereits belegter Stellen. Wenn mehr Platz benötigt wird, wächst die Kapazität automatisch.

StringBuilder.setLength(int) gibt void zurück: Eine kleinere Länge kürzt das Ende, während eine größere Länge Zeichen mit dem Wert null ('\u0000') anhängt, keine Leerzeichen. Eine negative Länge verursacht IndexOutOfBoundsException. setLength(0) entfernt den gesamten logischen Inhalt; betrachte dies nicht als sicheres Löschen von Daten aus dem Speicher.

Beispiele

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

Ergebnis

0:16
4:8
Ja
4:0
0

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen