CKTIS / Java
StringBuilder: pojemność początkowa, długość i wzrost bufora
Dowiedz się, czym pojemność bufora różni się od długości tekstu i co się dzieje, gdy kolejne wywołania append przekroczą początkową pojemność.
Wersja: Java SE 21
Składnia
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()W Java SE 21 klasa java.lang.StringBuilder przechowuje modyfikowalny tekst. Konstruktor StringBuilder() tworzy pusty obiekt o pojemności początkowej 16, a StringBuilder(int) tworzy pusty obiekt o dokładnie podanej pojemności. W obu przypadkach początkowa długość wynosi 0. Ujemna pojemność powoduje zgłoszenie NegativeArraySizeException.
length() podaje liczbę zapisanych jednostek kodowych UTF-16 (char), nie liczbę punktów kodowych Unicode. capacity() podaje łączną liczbę jednostek, które mieszczą się w bieżącym buforze, wliczając już zapisane. Nie oznacza liczby wolnych miejsc ani rozmiaru bufora w bajtach. Gdy dopisywany tekst nie mieści się w buforze, bufor rośnie automatycznie.
append(String) dopisuje tekst na końcu; argument typu String o wartości null dopisuje "null". append(int) dopisuje dziesiętny zapis liczby, a nie znak o podanym kodzie. Obie metody zmieniają ten sam obiekt i zwracają do niego referencję, więc wywołania można łączyć w łańcuch.
toString() zwraca niemodyfikowalny String z bieżącą treścią. Późniejsze zmiany w buforze nie wpływają na ten wynik. Jeśli znasz przybliżoną długość końcową, możesz dobrać pojemność początkową tak, by ograniczyć realokacje; nie jest ona limitem długości.
Przykłady
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");
}
}Wynik
default: capacity=16, length=0 initial: capacity=4, length=0 text=ID=123 length=6 capacity >= length: true
Oba obiekty startują z długością 0. Drugi ma dokładnie pojemność 4. Łańcuch wywołań dopisuje `ID=` i `123`, a `toString()` zwraca `ID=123` o długości 6. Bufor musiał urosnąć; test sprawdza tylko `capacity() >= length()`, bez zakładania konkretnej pojemności po wzroście.
Powiązane lekcje
- Java · Lekcja 49 · Zaawansowany · Wersja: 2