Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

StringBuilder: začetna zmogljivost, dolžina in rast medpomnilnika

Loči zmogljivost medpomnilnika od dolžine besedila, veriži klice append in preveri rast, ne da bi predpostavil točno končno zmogljivost.

Različica: Java SE 21

Sintaksa

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 java.lang.StringBuilder hrani spremenljivo besedilo. StringBuilder() ustvari prazen objekt z zmogljivostjo 16, StringBuilder(int) pa prazen objekt z natančno podano zmogljivostjo. V obeh primerih je začetna dolžina 0. Negativna zmogljivost sproži NegativeArraySizeException.

length() šteje shranjene kodne enote UTF-16 (vrednosti char), ne kodnih točk Unicode. capacity() pove, koliko kodnih enot lahko trenutni medpomnilnik vsebuje skupaj z že shranjenimi. To ni število prostih mest niti velikost v bajtih. Če dodano besedilo preseže to zmogljivost, se medpomnilnik samodejno poveča.

append(String) doda besedilo na konec; argument tipa String z vrednostjo null doda "null". append(int) doda desetiški zapis celega števila, ne znaka s to kodo. Obe različici spremenita in vrneta isti objekt, zato lahko klice verižiš.

toString() vrne nespremenljiv String s trenutnim besedilom. Poznejše spremembe objekta StringBuilder ne vplivajo na rezultat. Če lahko oceniš končno dolžino, z izbiro začetne zmogljivosti lahko zmanjšaš število ponovnih dodelitev pomnilnika; zmogljivost ni omejitev dolžine.

Primeri

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

Rezultat

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

Oba objekta začneta z dolžino 0. Drugi ima začetno zmogljivost natanko 4. Zaporedje klicev doda `ID=` in `123`, `toString()` pa vrne `ID=123` z dolžino 6. Medpomnilnik se je moral povečati; preverjanje zahteva le `capacity() >= length()` in ne predpostavlja določene zmogljivosti po povečanju.

Povezane lekcije

  • Java · Lekcija 49 · Napredna · Različica: 2

Viri