Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

StringBuilder — promjenjivi tekstni međuspremnik

StringBuilder omogućuje postupno sastavljanje i izmjenu teksta. Saznajte razliku između duljine i kapaciteta te što se događa kada setLength skrati ili produlji niz.

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

Sintaksa

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

java.lang.StringBuilder promjenjiv je niz znakova. append dodaje sadržaj, a toString() stvara rezultirajući String. Klasa ne jamči sinkronizaciju; nemojte dijeliti promjenjivu instancu među dretvama bez odgovarajuće sinkronizacije.

StringBuilder() stvara prazan međuspremnik kapaciteta 16. StringBuilder(int) stvara prazan međuspremnik zadanog kapaciteta; negativna vrijednost uzrokuje NegativeArraySizeException. Početni kapacitet nije duljina teksta.

StringBuilder.length() vraća broj UTF-16 char jedinica u sadržaju, što ne mora biti jednako broju znakova vidljivih korisniku. StringBuilder.capacity() označava prostor za te jedinice, uključujući već zauzeta mjesta. Kapacitet se automatski povećava kada zatreba više prostora.

StringBuilder.setLength(int) vraća void: manja duljina skraćuje kraj, a veća dodaje znakove vrijednosti nula ('\u0000'), a ne razmake. Negativna duljina uzrokuje IndexOutOfBoundsException. setLength(0) uklanja sav logički sadržaj; nemojte to smatrati sigurnim brisanjem podataka iz memorije.

Primjeri

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

Rezultat

0:16
4:8
Ja
4:0
0

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori