Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła