CKTIS / Java
ByteBuffer: dijeljeno polje, kapacitet i čitanje bez pomicanja položaja
Upotrijebi postojeće polje bajtova bez kopiranja, razlikuj kapacitet od granice i pročitaj bajt na odabranom indeksu bez promjene položaja međuspremnika.
Verzija: Java SE 21
Sintaksa
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();Statička metoda wrap klase java.nio.ByteBuffer stvara međuspremnik koji koristi postojeće polje byte[] bez kopiranja podataka. Upis u polje vidljiv je u međuspremniku, a upis preko međuspremnika mijenja isto polje. Uz ByteBuffer.wrap(array) početni je položaj 0, a granica i kapacitet jednaki su array.length.
Preopterećena verzija ByteBuffer.wrap(array, offset, length) postavlja početni položaj na offset i granicu na offset + length, ali kapacitet ostaje array.length. Mora vrijediti 0 <= offset <= array.length i 0 <= length <= array.length - offset; u suprotnom metoda baca IndexOutOfBoundsException. Indeks 0 i dalje odgovara elementu array[0], a ne array[offset].
Metoda capacity(), naslijeđena iz java.nio.Buffer, vraća fiksni kapacitet međuspremnika u bajtovima, a ne broj preostalih bajtova za relativno čitanje. Taj broj vraća remaining() kao limit() - position(). Uvijek vrijedi 0 <= position() <= limit() <= capacity().
get(index) čita jedan byte na indeksu koji se računa od početka međuspremnika i ne mijenja položaj. Indeks može biti manji od trenutačnog položaja, ali mora zadovoljavati 0 <= index < limit(); inače metoda baca IndexOutOfBoundsException. Nasuprot tome, relativni get() čita na trenutačnom položaju i povećava ga za jedan. Ako je položaj jednak granici, baca BufferUnderflowException.
Primjeri
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]);
}
}Rezultat
capacity=4 limit=3 get(0)=11 position=1 get()=20 position=2 data[2]=33
Uz položaj `1` i granicu `3`, `get(0)` čita vrijednost `11` upisanu u polje i ne mijenja položaj. Sljedeći `get()` vraća `20` i pomiče položaj na `2`. Upis preko međuspremnika mijenja `data[2]` na `33`. Poziv `get(3)` bacio bi iznimku: `3` je jednako granici, iako je manje od kapaciteta `4`.
Povezane lekcije
- Java · Lekcija 60 · Srednje · Verzija: 2