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