Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

StringBuilder: pojemność, zapis i ponowne użycie bufora

Twórz bufory o dobranej pojemności, zachowuj wyniki jako niezmienne napisy i używaj oddzielnych buforów w wątkach. Formatuj każdy bajt jako dwie cyfry szesnastkowe.

Wersja: Java SE 21

Składnia

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()     // StringBuilder

W Java SE 21 konstruktor StringBuilder(int) z pakietu java.lang tworzy pusty bufor: length() zwraca 0, a capacity() podaje początkową pojemność w jednostkach kodowych UTF-16. Pojemność nie jest limitem długości: bufor rośnie w razie potrzeby. Ujemna pojemność powoduje NegativeArraySizeException.

append(String) dopisuje tekst (dla argumentu null typu String dopisuje null), append(int) dopisuje zapis dziesiętny, a append(char) dopisuje jedną jednostkę kodową. Każde z tych przeciążeń zwraca ten sam bufor, więc wywołania można łączyć. toString() utrwala bieżącą zawartość w niezmiennym String, którego późniejsze zmiany bufora nie zmienią.

setLength(0) opróżnia bufor logicznie, aby można było ponownie wywołać append(...) i toString(). To nie jest żądanie zmniejszenia pojemności ani metoda bezpiecznego wymazywania danych. Skrócenie zachowuje prefiks, wydłużenie dodaje U+0000, a ujemna długość powoduje IndexOutOfBoundsException. StringBuilder nie jest bezpieczny w użyciu współbieżnym: każdy wątek roboczy buduje cztery wiersze we własnym buforze, a wątek główny odczytuje gotowe napisy po join().

W zapisie hex bez separatorów każdy bajt zajmuje dokładnie dwie cyfry. Math.multiplyExact(bytes.length, 2) oblicza początkową pojemność i zgłasza ArithmeticException, jeśli wynik nie mieści się w int. Byte.toUnsignedInt daje wartość od 0 do 255; górne i dolne cztery bity wybierają po jednej małej cyfrze hex. Wynikowe String.length() liczy jednostki kodowe UTF-16, nie bajty wejściowe.

Przykłady

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

Wynik

A:1
A:2
A:3
A:4
B:1
B:2
B:3
B:4
hex=000fa5ff, length=8

Każdy wątek roboczy używa jednego bufora do czterech wierszy. Wątek główny po `join()` drukuje najpierw wiersze A, potem B, niezależnie od kolejności wykonania wątków. Cztery bajty dają `000fa5ff` o długości `8`.

Powiązane lekcje

  • Java · Lekcja 28 · Zaawansowany · Wersja: 2
  • Java · Lekcja 35 · Zaawansowany · Wersja: 2
  • Java · Lekcja 62 · Zaawansowany · Wersja: 2

Źródła