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