Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

StringBuilder: kapacita, nemenné výsledky a opätovné použitie

Nastavte kapacitu meniteľného textového buffera, uchovajte nemenné výsledky a použite samostatný buffer pre každé vlákno. Každý bajt zapíšte dvoma hexadecimálnymi číslicami.

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

V Java SE 21 vytvorí StringBuilder(int) z balíka java.lang prázdny buffer: length() začína na 0 a capacity() udáva počiatočnú kapacitu v kódových jednotkách UTF-16. Kapacita nie je limit dĺžky; buffer sa podľa potreby zväčšuje. Záporná kapacita vyvolá NegativeArraySizeException.

append(String) pripojí text (argument null typu String pripojí text null), append(int) pripojí desiatkový zápis a append(char) pripojí jednu kódovú jednotku. Každý z týchto variantov vráti ten istý buffer, takže volania možno reťaziť. toString() zachytí aktuálny obsah ako nemenný String, ktorý neskoršie zmeny buffera neovplyvnia.

setLength(0) logicky vyprázdni buffer pred vytvorením ďalšieho výsledku pomocou append(...) a toString(). Nie je to požiadavka na zmenšenie kapacity ani bezpečné vymazanie údajov. Skrátenie zachová začiatok, predĺženie doplní U+0000 a záporná dĺžka vyvolá IndexOutOfBoundsException. StringBuilder nie je bezpečný pre súbežný prístup: každé pracovné vlákno zostaví štyri riadky vo vlastnom bufferi a hlavné vlákno číta hotové reťazce po join().

Pri hexadecimálnom zápise bez oddeľovačov zaberá každý bajt presne dve číslice. Math.multiplyExact(bytes.length, 2) vypočíta počiatočnú kapacitu a vyvolá ArithmeticException, ak sa výsledok nezmestí do int. Byte.toUnsignedInt vráti hodnotu od 0 do 255; horné aj dolné štyri bity vyberú po jednej hexadecimálnej číslici s malými písmenami. String.length() vo výsledku počíta kódové jednotky UTF-16, nie vstupné bajty.

Prí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ýsledok

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 opakovane použije vlastný buffer na štyri riadky. Po `join()` hlavné vlákno vypíše najprv riadky A a potom B bez ohľadu na poradie behu vlákien. Štyri bajty dajú `000fa5ff` s dĺžkou `8`.

Súvisiace lekcie

  • Java · Lekcia 28 · Pokročilá · Verzia: 2
  • Java · Lekcia 35 · Pokročilá · Verzia: 2
  • Java · Lekcia 62 · Pokročilá · Verzia: 2

Zdroje