Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

StringBuilder: kapacita, neměnné výsledky a opětovné použití

Nastavte kapacitu měnitelného textového bufferu, ukládejte neměnné výsledky a používejte samostatný buffer pro každé vlákno. Každý bajt zapište dvěma hexadecimálními číslicemi.

Verze: Java SE 21

Syntaxe

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

V Java SE 21 vytvoří StringBuilder(int) z balíčku java.lang prázdný buffer: length() začíná na 0 a capacity() udává počáteční kapacitu v kódových jednotkách UTF-16. Kapacita není mez délky; buffer se podle potřeby zvětšuje. Záporná kapacita vyvolá NegativeArraySizeException.

append(String) připojí text (argument null typu String připojí text null), append(int) připojí desítkový zápis a append(char) připojí jednu kódovou jednotku. Každá z těchto přetížených metod vrací tentýž buffer, takže volání lze řetězit. toString() zachytí aktuální obsah jako neměnný String, který pozdější úpravy bufferu neovlivní.

setLength(0) logicky vyprázdní buffer před vytvořením dalšího výsledku pomocí append(...) a toString(). Nejde o požadavek na zmenšení kapacity ani o bezpečné vymazání dat. Zkrácení zachová začátek, prodloužení doplní U+0000 a záporná délka vyvolá IndexOutOfBoundsException. StringBuilder není bezpečný pro souběžný přístup: každé pracovní vlákno sestaví čtyři řádky ve vlastním bufferu a hlavní vlákno čte hotové řetězce po join().

V hexadecimálním zápisu bez oddělovačů zabírá každý bajt přesně dvě číslice. Math.multiplyExact(bytes.length, 2) spočítá počáteční kapacitu a vyvolá ArithmeticException, pokud se výsledek nevejde do int. Byte.toUnsignedInt vrátí hodnotu od 0 do 255; horní i dolní čtyři bity vyberou po jedné hexadecimální číslici s malými písmeny. String.length() ve výsledku počítá kódové jednotky UTF-16, nikoli vstupní bajty.

Příklady

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

Výsledek

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

Každé pracovní vlákno použije vlastní buffer pro čtyři řádky. Po `join()` hlavní vlákno vypíše nejdřív řádky A a potom B bez ohledu na pořadí běhu vláken. Čtyři bajty dají `000fa5ff` o délce `8`.

Související lekce

  • Java · Lekce 28 · Pokročilá · Verze: 2
  • Java · Lekce 35 · Pokročilá · Verze: 2
  • Java · Lekce 62 · Pokročilá · Verze: 2

Zdroje