CKTIS / Java
StringBuilder: capaciteit, momentopnamen en bufferhergebruik
Kies de capaciteit van een wijzigbare tekstbuffer, bewaar onveranderlijke resultaten en geef elke thread een eigen buffer. Schrijf elk byte als twee hexadecimale cijfers.
Versie: Java SE 21
Syntax
StringBuilder(int capacity)
StringBuilder append(String str)
StringBuilder append(int i)
StringBuilder append(char c)
String toString()
void setLength(int newLength)
int length() // StringBuilder and String
int capacity() // StringBuilderIn Java SE 21 maakt StringBuilder(int) uit java.lang een lege buffer: length() begint op 0, terwijl capacity() de begincapaciteit in UTF-16-code-eenheden aangeeft. De capaciteit is geen lengtelimiet; de buffer groeit als dat nodig is. Een negatieve capaciteit veroorzaakt een NegativeArraySizeException.
append(String) voegt tekst toe (een null-argument van het type String voegt null toe), append(int) voegt de decimale weergave toe en append(char) voegt één code-eenheid toe. Elke overload geeft dezelfde buffer terug, zodat je aanroepen kunt ketenen. toString() legt de huidige inhoud vast in een onveranderlijke String die door latere wijzigingen aan de buffer niet verandert.
setLength(0) maakt de buffer logisch leeg voordat je met append(...) en toString() het volgende resultaat maakt. Het is geen verzoek om de capaciteit te verkleinen en geen veilige manier om gegevens te wissen. Bij inkorten blijft het voorvoegsel behouden, bij verlengen wordt aangevuld met U+0000, en een negatieve lengte veroorzaakt een IndexOutOfBoundsException. StringBuilder is niet thread-safe: elke werkthread bouwt vier regels in zijn eigen buffer, en de hoofdthread leest de resulterende strings na join().
Bij hex zonder scheidingstekens neemt elk byte precies twee cijfers in. Math.multiplyExact(bytes.length, 2) berekent de begincapaciteit en veroorzaakt een ArithmeticException als het resultaat niet in een int past. Byte.toUnsignedInt geeft een waarde van 0 tot 255; de hoogste en laagste vier bits kiezen elk één hexadecimaal cijfer, met kleine letters. String.length() telt in het resultaat UTF-16-code-eenheden, niet de invoerbytes.
Voorbeelden
public class BuilderDemo {
private static final String HEX = "0123456789abcdef";
private static void writeRows(String worker, String[] rows) {
StringBuilder line = new StringBuilder(8);
for (int i = 0; i < rows.length; i++) {
line.setLength(0);
rows[i] = line.append(worker).append(":").append(i + 1).toString();
}
}
private static String toHex(byte[] bytes) {
StringBuilder hex = new StringBuilder(Math.multiplyExact(bytes.length, 2));
for (byte b : bytes) {
int value = Byte.toUnsignedInt(b);
hex.append(HEX.charAt(value >>> 4));
hex.append(HEX.charAt(value & 0x0f));
}
return hex.toString();
}
public static void main(String[] args) throws InterruptedException {
String[] aRows = new String[4];
String[] bRows = new String[4];
Thread a = new Thread(() -> writeRows("A", aRows));
Thread b = new Thread(() -> writeRows("B", bRows));
a.start();
b.start();
a.join();
b.join();
for (String row : aRows) System.out.println(row);
for (String row : bRows) System.out.println(row);
String hex = toHex(new byte[] {0x00, 0x0f, (byte) 0xa5, (byte) 0xff});
System.out.println("hex=" + hex + ", length=" + hex.length());
}
}Resultaat
A:1 A:2 A:3 A:4 B:1 B:2 B:3 B:4 hex=000fa5ff, length=8
Elke werkthread hergebruikt zijn eigen buffer voor vier regels. Na `join()` drukt de hoofdthread eerst de regels van A af en dan die van B, ongeacht de uitvoeringsvolgorde. De vier bytes leveren `000fa5ff` met lengte `8` op.
Gerelateerde lessen
- Java · Les 28 · Gevorderd · Versie: 2
- Java · Les 35 · Gevorderd · Versie: 2
- Java · Les 62 · Gevorderd · Versie: 2