WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

StringBuilder: Anfangskapazität, Länge und Pufferwachstum

Unterscheide Pufferkapazität und Textlänge, verkette append-Aufrufe und prüfe das Pufferwachstum, ohne eine bestimmte Endkapazität vorauszusetzen.

Version: Java SE 21

Syntax

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 speichert java.lang.StringBuilder veränderbaren Text. StringBuilder() startet leer mit Kapazität 16; StringBuilder(int) startet leer mit genau der angegebenen Kapazität. Beide starten mit Länge 0. Eine negative Kapazität führt zu einer NegativeArraySizeException.

length() zählt die gespeicherten UTF-16-Codeeinheiten (char-Werte), nicht die Unicode-Codepunkte. capacity() gibt an, wie viele Codeeinheiten insgesamt in den aktuellen Puffer passen, einschließlich der bereits gespeicherten. Das ist weder die Zahl der freien Plätze noch die Größe in Byte. Reicht die Kapazität beim Anhängen nicht aus, wächst der Puffer automatisch.

append(String) hängt Text am Ende an; ein String-Argument mit dem Wert null hängt "null" an. append(int) hängt die Dezimaldarstellung der Zahl an, nicht das Zeichen mit diesem Code. Beide Überladungen verändern dasselbe Objekt und geben es zurück, sodass sich Aufrufe verketten lassen.

toString() liefert einen unveränderlichen String mit dem aktuellen Text. Spätere Änderungen am Builder wirken sich darauf nicht aus. Lässt sich die endgültige Länge abschätzen, kann eine passende Anfangskapazität die Zahl der Neuallokationen senken; sie begrenzt die Länge nicht.

Beispiele

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

Ergebnis

default: capacity=16, length=0
initial: capacity=4, length=0
text=ID=123
length=6
capacity >= length: true

Beide Builder starten mit Länge 0. Der zweite hat anfangs genau Kapazität 4. Die Aufrufkette hängt `ID=` und `123` an; `toString()` liefert `ID=123` mit Länge 6. Der Puffer musste wachsen. Die Prüfung verlangt nur `capacity() >= length()` und setzt keine bestimmte Kapazität nach dem Wachstum voraus.

Zugehörige Lektionen

  • Java · Lektion 49 · Fortgeschritten · Version: 2

Quellen