База знанияИзпитен център
BGБългарски
Избери език13

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

Източници