Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje