Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

StringBuilder: kapaciteta, nespremenljivi nizi in ponovna uporaba

Določi kapaciteto spremenljivega besedilnega medpomnilnika, shrani nespremenljive rezultate in uporabi ločen medpomnilnik za vsako nit. Vsak bajt zapiši z dvema šestnajstiškima števkama.

Različica: Java SE 21

Sintaksa

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 konstruktor StringBuilder(int) iz paketa java.lang ustvari prazen medpomnilnik: length() je sprva 0, capacity() pa poda začetno kapaciteto v kodnih enotah UTF-16. Kapaciteta ne omejuje dolžine; medpomnilnik po potrebi zraste. Negativna kapaciteta sproži NegativeArraySizeException.

append(String) doda besedilo (argument null tipa String doda besedilo null), append(int) doda desetiški zapis, append(char) pa eno kodno enoto. Vsaka različica vrne isti medpomnilnik, zato lahko klice verižiš. toString() zajame trenutno vsebino kot nespremenljiv String, na katerega poznejše spremembe medpomnilnika ne vplivajo.

setLength(0) logično izprazni medpomnilnik, preden z append(...) in toString() sestaviš naslednji rezultat. To ni zahteva za zmanjšanje kapacitete niti varen izbris podatkov. Krajšanje ohrani začetni del, podaljšanje doda U+0000, negativna dolžina pa sproži IndexOutOfBoundsException. StringBuilder ni varen za sočasno uporabo: vsaka delovna nit sestavi štiri vrstice v svojem medpomnilniku, glavna nit pa po join() prebere nastale nize.

V šestnajstiškem zapisu brez ločil vsak bajt zasede natanko dve števki. Math.multiplyExact(bytes.length, 2) izračuna začetno kapaciteto in sproži ArithmeticException, če rezultata ni mogoče predstaviti kot int. Byte.toUnsignedInt vrne vrednost od 0 do 255; zgornji in spodnji štirje biti izberejo vsak po eno šestnajstiško števko z malimi črkami. String.length() v rezultatu šteje kodne enote UTF-16, ne vhodnih bajtov.

Primeri

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

Rezultat

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

Vsaka delovna nit znova uporabi svoj medpomnilnik za štiri vrstice. Po `join()` glavna nit izpiše najprej vrstice A in nato vrstice B, ne glede na vrstni red izvajanja. Štirje bajti dajo `000fa5ff` dolžine `8`.

Povezane lekcije

  • Java · Lekcija 28 · Napredna · Različica: 2
  • Java · Lekcija 35 · Napredna · Različica: 2
  • Java · Lekcija 62 · Napredna · Različica: 2

Viri