CKTIS / Java
StringBuilder: начален капацитет, дължина и нарастване на буфера
Разграничи капацитета на буфера от дължината на текста, свържи извиквания на append и провери нарастването, без да разчиташ на точен краен капацитет.
Версия: Java SE 21
Синтаксис
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()В Java SE 21 java.lang.StringBuilder съхранява текст, който може да се променя. StringBuilder() създава празен обект с капацитет 16, а StringBuilder(int) създава празен обект с точно зададения капацитет. И в двата случая началната дължина е 0. Отрицателният капацитет предизвиква NegativeArraySizeException.
length() брои съхранените кодови единици на UTF-16 (стойности от тип char), а не кодовите точки на Unicode. capacity() показва колко кодови единици общо побира текущият буфер, включително вече записаните. Това не е нито броят на свободните места, нито размер в байтове. Ако добавеният текст надхвърли този капацитет, буферът нараства автоматично.
append(String) добавя текст в края; аргумент от тип String със стойност null добавя "null". append(int) добавя десетичния запис на цялото число, а не знака с този код. И двата претоварени варианта променят и връщат същия обект, така че извикванията могат да се свързват във верига.
toString() връща неизменим String с текущия текст. Последващите промени в обекта StringBuilder не засягат резултата. Ако можеш да оцениш крайната дължина, изборът на начален капацитет може да намали броя на повторните заделяния на памет; този капацитет не ограничава дължината.
Примери
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");
}
}Резултат
default: capacity=16, length=0 initial: capacity=4, length=0 text=ID=123 length=6 capacity >= length: true
И двата обекта започват с дължина 0. Вторият има начален капацитет точно 4. Веригата от извиквания добавя `ID=` и `123`, а `toString()` връща `ID=123` с дължина 6. Буферът е трябвало да нарасне; проверката изисква само `capacity() >= length()` и не предполага конкретен капацитет след нарастването.
Свързани уроци
- Java · Урок 49 · Напреднало · Версия: 2