CKTIS / Java
StringBuilder: počiatočná kapacita, dĺžka a rast vyrovnávacej pamäte
Rozlišuj kapacitu vyrovnávacej pamäte a dĺžku textu, reťaz volania append a over rast bez toho, aby si predpokladal konkrétnu výslednú kapacitu.
Verzia: 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()V Java SE 21 uchováva java.lang.StringBuilder meniteľný text. StringBuilder() vytvorí prázdny objekt s kapacitou 16; StringBuilder(int) vytvorí prázdny objekt s presne zadanou kapacitou. V oboch prípadoch je počiatočná dĺžka 0. Záporná kapacita vyvolá NegativeArraySizeException.
length() počíta uložené kódové jednotky UTF-16 (hodnoty char), nie kódové body Unicode. capacity() udáva, koľko jednotiek sa celkovo zmestí do aktuálnej vyrovnávacej pamäte, vrátane už uložených. Nejde o počet voľných miest ani o veľkosť v bajtoch. Keď sa pridávaný text nezmestí, pamäť sa automaticky zväčší.
append(String) pridá text na koniec; argument typu String s hodnotou null pridá "null". append(int) pridá desiatkový zápis čísla, nie znak s týmto kódom. Obe preťažené verzie menia a vracajú ten istý objekt, takže volania možno reťaziť.
toString() vráti nemenný String s aktuálnym textom. Neskoršie zmeny objektu StringBuilder výsledok neovplyvnia. Ak vieš odhadnúť konečnú dĺžku, vhodná počiatočná kapacita môže znížiť počet realokácií; kapacita nie je hornou hranicou dĺžky.
Prí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ýsledok
default: capacity=16, length=0 initial: capacity=4, length=0 text=ID=123 length=6 capacity >= length: true
Oba objekty začínajú s dĺžkou 0. Druhý má počiatočnú kapacitu presne 4. Reťaz volaní pridá `ID=` a `123` a `toString()` vráti `ID=123` s dĺžkou 6. Vyrovnávacia pamäť sa musela zväčšiť; kontrola vyžaduje iba `capacity() >= length()` a nepredpokladá konkrétnu kapacitu po zväčšení.
Súvisiace lekcie
- Java · Lekcia 49 · Pokročilá · Verzia: 2