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

CKTIS / Java

StringBuilder — променяем текстов буфер

StringBuilder ви позволява постепенно да създавате и променяте текст. Научете разликата между дължина и капацитет и какво се случва, когато setLength съкращава или удължава последователността.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

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

java.lang.StringBuilder е променяема последователност от знаци. append добавя съдържание, а toString() създава получения String. Класът не гарантира синхронизация; не споделяйте променяем екземпляр между нишки без подходяща синхронизация.

StringBuilder() създава празен буфер с капацитет 16. StringBuilder(int) създава празен буфер с посочения капацитет; отрицателна стойност причинява NegativeArraySizeException. Началният капацитет не е дължината на текста.

StringBuilder.length() връща броя UTF-16 char единици в съдържанието, който не е непременно равен на броя видими за потребителя знаци. StringBuilder.capacity() показва мястото за тези единици, включително вече заетите позиции. Капацитетът се увеличава автоматично, когато е необходимо повече място.

StringBuilder.setLength(int) връща void: по-малка дължина съкращава края, а по-голяма добавя знаци със стойност нула ('\u0000'), а не интервали. Отрицателната дължина причинява IndexOutOfBoundsException. setLength(0) премахва цялото логическо съдържание; не приемайте това за сигурно изтриване на данни от паметта.

Примери

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());
    }
}

Резултат

0:16
4:8
Ja
4:0
0

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници