CKTIS / Java
StringBuilder — meniteľný textový buffer
StringBuilder umožňuje postupne vytvárať a upravovať text. Spoznajte rozdiel medzi dĺžkou a kapacitou a zistite, čo sa stane, keď setLength sekvenciu skráti alebo predĺži.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
new StringBuilder();
new StringBuilder(8);
int length();
int capacity();
void setLength(int newLength);java.lang.StringBuilder je meniteľná znaková sekvencia. append pridáva obsah a toString() vytvorí výsledný String. Trieda nezaručuje synchronizáciu; nezdieľajte meniteľnú inštanciu medzi vláknami bez náležitej synchronizácie.
StringBuilder() vytvorí prázdny buffer s kapacitou 16. StringBuilder(int) vytvorí prázdny buffer so zadanou kapacitou; záporná hodnota spôsobí NegativeArraySizeException. Počiatočná kapacita nie je dĺžka textu.
StringBuilder.length() vracia počet jednotiek UTF-16 char v obsahu, nie nevyhnutne počet znakov viditeľných používateľovi. StringBuilder.capacity() udáva priestor pre tieto jednotky vrátane už obsadených pozícií. Keď je potrebný ďalší priestor, kapacita sa automaticky zväčší.
StringBuilder.setLength(int) vracia void: menšia dĺžka skráti koniec, zatiaľ čo väčšia dĺžka pridá znaky s hodnotou nula ('\u0000'), nie medzery. Záporná dĺžka spôsobí IndexOutOfBoundsException. setLength(0) odstráni všetok logický obsah; nepovažujte to za bezpečné vymazanie údajov z pamäte.
Prí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ýsledok
0:16 4:8 Ja 4:0 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.