Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

StringBuilder — modyfikowalny bufor tekstu

StringBuilder pozwala stopniowo budować i zmieniać tekst. Poznaj różnicę między długością a pojemnością oraz skutki skracania i wydłużania sekwencji przez setLength.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

new StringBuilder();
new StringBuilder(8);
int length();
int capacity();
void setLength(int newLength);

java.lang.StringBuilder to modyfikowalna sekwencja znaków. append dopisuje treść, a toString() tworzy wynikowy String. Klasa nie gwarantuje synchronizacji; nie współdziel modyfikowanej instancji między wątkami bez odpowiedniej synchronizacji.

StringBuilder() tworzy pusty bufor o pojemności 16. StringBuilder(int) tworzy pusty bufor o podanej pojemności; wartość ujemna powoduje NegativeArraySizeException. Pojemność początkowa nie jest długością tekstu.

StringBuilder.length() zwraca liczbę jednostek char UTF-16 w treści, niekoniecznie liczbę znaków widocznych dla użytkownika. StringBuilder.capacity() określa pojemność na takie jednostki, łącznie z już zajętymi miejscami. Pojemność rośnie automatycznie, gdy potrzeba więcej miejsca.

StringBuilder.setLength(int) zwraca void: mniejsza długość obcina końcówkę, większa dopisuje znaki o wartości zero ('\u0000'), a nie spacje. Ujemna długość powoduje IndexOutOfBoundsException. setLength(0) usuwa całą treść logiczną; nie traktuj tego jako bezpiecznego wymazania danych z pamięci.

Przykłady

public class Main {
    public static void main(String[] args) {
        StringBuilder defaults = new StringBuilder();
        System.out.println(defaults.length() + ":" + defaults.capacity());

        StringBuilder text = new StringBuilder(8);
        text.append("Java");
        System.out.println(text.length() + ":" + text.capacity());

        text.setLength(2);
        System.out.println(text.toString());

        text.setLength(4);
        System.out.println(text.length() + ":" + (int) text.charAt(2));

        text.setLength(0);
        System.out.println(text.length());
    }
}

Wynik

0:16
4:8
Ja
4:0
0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła