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

CKTIS / Java

ByteBuffer: sdílené pole, kapacita a čtení beze změny pozice

Použij existující pole bajtů bez kopírování, rozliš kapacitu od limitu a přečti bajt na zvoleném indexu beze změny pozice bufferu.

Verze: Java SE 21

Syntaxe

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á metoda wrap třídy java.nio.ByteBuffer vytvoří buffer nad existujícím polem byte[] bez kopírování dat. Zápis do pole je v bufferu vidět a zápis přes buffer mění totéž pole. Po volání ByteBuffer.wrap(array) je počáteční pozice 0 a limit i kapacita se rovnají array.length.

Přetížená varianta ByteBuffer.wrap(array, offset, length) nastaví počáteční pozici na offset a limit na offset + length, ale kapacita zůstane array.length. Musí platit 0 <= offset <= array.length a 0 <= length <= array.length - offset; jinak metoda vyvolá IndexOutOfBoundsException. Index 0 stále odpovídá prvku array[0], nikoli array[offset].

Metoda capacity(), zděděná z java.nio.Buffer, vrací pevnou kapacitu bufferu v bajtech, nikoli počet bajtů zbývajících pro relativní čtení. Ten vrací remaining() jako limit() - position(). Vždy platí 0 <= position() <= limit() <= capacity().

get(index) přečte jeden byte na indexu počítaném od začátku bufferu a pozici nezmění. Index může být menší než aktuální pozice, musí však splňovat 0 <= index < limit(); jinak metoda vyvolá IndexOutOfBoundsException. Naproti tomu relativní get() čte na aktuální pozici a zvýší ji o jedna. Pokud se pozice rovná limitu, vyvolá BufferUnderflowException.

Pří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ýsledek

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

Při pozici `1` a limitu `3` přečte `get(0)` hodnotu `11` zapsanou do pole a pozici nezmění. Následující `get()` vrátí `20` a posune pozici na `2`. Zápis přes buffer změní `data[2]` na `33`. Volání `get(3)` by vyvolalo výjimku: `3` se rovná limitu, přestože je menší než kapacita `4`.

Související lekce

  • Java · Lekce 60 · Středně pokročilá · Verze: 2

Zdroje