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

CKTIS / Java

ByteBuffer: zdieľané pole, kapacita a čítanie bez zmeny pozície

Použi existujúce pole bajtov bez kopírovania, odlíš kapacitu od limitu a prečítaj bajt na zvolenom indexe bez zmeny pozície buffera.

Verzia: Java SE 21

Syntax

import java.nio.ByteBuffer;

ByteBuffer buffer = ByteBuffer.wrap(array);
ByteBuffer window = ByteBuffer.wrap(array, offset, length);
int capacity = buffer.capacity();
byte atIndex = buffer.get(index);
byte next = buffer.get();

Statická metóda wrap triedy java.nio.ByteBuffer vytvorí buffer nad existujúcim poľom byte[] bez kopírovania údajov. Zápis do poľa je viditeľný v bufferi a zápis cez buffer mení to isté pole. Po volaní ByteBuffer.wrap(array) je počiatočná pozícia 0 a limit aj kapacita sa rovnajú array.length.

Preťažená verzia ByteBuffer.wrap(array, offset, length) nastaví počiatočnú pozíciu na offset a limit na offset + length, ale kapacita zostane array.length. Musí platiť 0 <= offset <= array.length a 0 <= length <= array.length - offset; inak metóda vyvolá IndexOutOfBoundsException. Index 0 stále zodpovedá prvku array[0], nie array[offset].

Metóda capacity(), zdedená z java.nio.Buffer, vracia pevnú kapacitu buffera v bajtoch, nie počet bajtov, ktoré zostávajú na relatívne čítanie. Ten vracia remaining() ako limit() - position(). Vždy platí 0 <= position() <= limit() <= capacity().

get(index) prečíta jeden byte na indexe počítanom od začiatku buffera a pozíciu nezmení. Index môže byť menší než aktuálna pozícia, musí však spĺňať 0 <= index < limit(); inak metóda vyvolá IndexOutOfBoundsException. Relatívne get() naopak číta na aktuálnej pozícii a zvýši ju o jeden. Ak sa pozícia rovná limitu, vyvolá BufferUnderflowException.

Príklady

import java.nio.ByteBuffer;

public class Main {
    public static void main(String[] args) {
        byte[] data = {10, 20, 30, 40};
        ByteBuffer buffer = ByteBuffer.wrap(data, 1, 2);
        System.out.println("capacity=" + buffer.capacity());
        System.out.println("limit=" + buffer.limit());

        data[0] = 11;
        System.out.println("get(0)=" + buffer.get(0));
        System.out.println("position=" + buffer.position());

        System.out.println("get()=" + buffer.get());
        System.out.println("position=" + buffer.position());

        buffer.put(2, (byte) 33);
        System.out.println("data[2]=" + data[2]);
    }
}

Výsledok

capacity=4
limit=3
get(0)=11
position=1
get()=20
position=2
data[2]=33

Pri pozícii `1` a limite `3` prečíta `get(0)` hodnotu `11` zapísanú do poľa a pozíciu nezmení. Nasledujúce `get()` vráti `20` a posunie pozíciu na `2`. Zápis cez buffer zmení `data[2]` na `33`. Volanie `get(3)` by vyvolalo výnimku: `3` sa rovná limitu, hoci je menšie než kapacita `4`.

Súvisiace lekcie

  • Java · Lekcia 60 · Stredne pokročilá · Verzia: 2

Zdroje