CKTIS / Java
StringBuilder — spremenljiv besedilni medpomnilnik
StringBuilder omogoča postopno sestavljanje in spreminjanje besedila. Spoznajte razliko med dolžino in zmogljivostjo ter kaj se zgodi, ko setLength zaporedje skrajša ali podaljša.
Različica: 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 je spremenljivo zaporedje znakov. append doda vsebino, toString() pa ustvari končni String. Razred ne zagotavlja sinhronizacije; spremenljivega primerka ne delite med nitmi brez ustrezne sinhronizacije.
StringBuilder() ustvari prazen medpomnilnik z zmogljivostjo 16. StringBuilder(int) ustvari prazen medpomnilnik z navedeno zmogljivostjo; negativna vrednost povzroči NegativeArraySizeException. Začetna zmogljivost ni dolžina besedila.
StringBuilder.length() vrne število enot UTF-16 char v vsebini, ne nujno števila uporabniku vidnih znakov. StringBuilder.capacity() označuje prostor za te enote, vključno z že zasedenimi mesti. Ko je potrebnega več prostora, se zmogljivost samodejno poveča.
StringBuilder.setLength(int) vrne void: krajša dolžina odreže konec, daljša pa doda znake z vrednostjo nič ('\u0000'), ne presledkov. Negativna dolžina povzroči IndexOutOfBoundsException. setLength(0) odstrani vso logično vsebino; tega ne obravnavajte kot varno brisanje podatkov iz pomnilnika.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.