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.