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