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.