Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

StringBuilder — měnitelný textový buffer

StringBuilder umožňuje postupně vytvářet a upravovat text. Poznejte rozdíl mezi délkou a kapacitou a zjistěte, co se stane, když setLength sekvenci zkrátí nebo prodlouží.

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

Syntaxe

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

java.lang.StringBuilder je měnitelná znaková posloupnost. append přidává obsah a toString() vytvoří výsledný String. Třída nezaručuje synchronizaci; nesdílejte měnitelnou instanci mezi vlákny bez odpovídající synchronizace.

StringBuilder() vytvoří prázdný buffer s kapacitou 16. StringBuilder(int) vytvoří prázdný buffer se zadanou kapacitou; záporná hodnota způsobí NegativeArraySizeException. Počáteční kapacita není délka textu.

StringBuilder.length() vrací počet jednotek UTF-16 char v obsahu, nikoli nutně počet znaků viditelných uživateli. StringBuilder.capacity() udává prostor pro tyto jednotky včetně již obsazených pozic. Když je potřeba více místa, kapacita se automaticky zvětší.

StringBuilder.setLength(int) vrací void: menší délka zkrátí konec, zatímco větší délka přidá znaky s hodnotou nula ('\u0000'), nikoli mezery. Záporná délka způsobí IndexOutOfBoundsException. setLength(0) odstraní veškerý logický obsah; nepovažujte to za bezpečné vymazání dat z paměti.

Příklady

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

Výsledek

0:16
4:8
Ja
4:0
0

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje