Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

StringBuilder: počáteční kapacita, délka a růst vyrovnávací paměti

Rozlišuj kapacitu vyrovnávací paměti a délku textu, řetěz volání append a ověř růst bez předpokladu konkrétní výsledné kapacity.

Verze: 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()

V Java SE 21 uchovává java.lang.StringBuilder měnitelný text. StringBuilder() vytvoří prázdný objekt s kapacitou 16; StringBuilder(int) vytvoří prázdný objekt s přesně zadanou kapacitou. V obou případech je počáteční délka 0. Záporná kapacita vyvolá NegativeArraySizeException.

length() počítá uložené kódové jednotky UTF-16 (hodnoty char), nikoli kódové body Unicode. capacity() udává, kolik jednotek se celkem vejde do aktuální vyrovnávací paměti včetně těch již uložených. Nejde o počet volných míst ani o velikost v bajtech. Když se přidávaný text nevejde, paměť se automaticky zvětší.

append(String) přidá text na konec; argument typu String s hodnotou null přidá "null". append(int) přidá desítkový zápis čísla, nikoli znak s tímto kódem. Obě přetížené varianty mění a vracejí tentýž objekt, takže volání lze řetězit.

toString() vrátí neměnný String s aktuálním textem. Pozdější změny v objektu StringBuilder se do výsledku nepromítnou. Pokud dokážeš odhadnout konečnou délku, vhodná počáteční kapacita může omezit počet realokací; kapacita délku neomezuje.

Příklady

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

Výsledek

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

Oba objekty začínají s délkou 0. Druhý má počáteční kapacitu přesně 4. Řetězec volání přidá `ID=` a `123` a `toString()` vrátí `ID=123` o délce 6. Vyrovnávací paměť se musela zvětšit; kontrola vyžaduje pouze `capacity() >= length()` a nepředpokládá konkrétní kapacitu po zvětšení.

Související lekce

  • Java · Lekce 49 · Pokročilá · Verze: 2

Zdroje