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

CKTIS / Java

Branje bajtov UTF-8 in pogledi CharBuffer samo za branje

Preberite vse bajte, ki jih vrne kodirnik UTF-8, nato pa vsebino obdelanega CharBuffer preglejte s pogledom samo za branje z neodvisnim položajem.

Različica: Java SE 21

Sintaksa

Java SE 21 — java.nio.ByteBuffer
static ByteBuffer wrap(byte[] array)
static ByteBuffer wrap(byte[] array, int offset, int length)
int remaining()
byte get()
ByteBuffer get(byte[] dst)
ByteBuffer get(byte[] dst, int offset, int length)
byte get(int index)
ByteBuffer get(int index, byte[] dst)
ByteBuffer get(int index, byte[] dst, int offset, int length)

java.nio.CharBuffer
CharBuffer asReadOnlyBuffer()
CharBuffer rewind()
int remaining()
int limit()
CharBuffer limit(int newLimit)
int position()
CharBuffer position(int newPosition)
CharBuffer slice()
CharBuffer slice(int index, int length)
char charAt(int index)
String toString()

V Java SE 21 je aktivno območje medpomnilnika java.nio [position(), limit()): položaj označuje začetek, meja pa ni vključena. remaining() vrne limit() - position() v bajtih za ByteBuffer in v kodnih enotah UTF-16 (char), ne v kodnih točkah Unicode, za CharBuffer. position(int) sprejme 0..limit(), limit(int) pa 0..capacity() in po potrebi zniža položaj. Neveljavna vrednost sproži IllegalArgumentException.

StandardCharsets.UTF_8.newEncoder().encode(cb) kodira aktivno območje. Ob uspehu se položaj cb premakne do meje, znaki pa ostanejo. Vrnjeni ByteBuffer je pripravljen za branje: položaj je nič, meja pa označuje konec kodiranih bajtov. Na njem ne kličite flip(). Za branje vseh bajtov ustvarite byte[] bytes = new byte[encoded.remaining()] in pokličite encoded.get(bytes). Kodirnik privzeto sporoči nepravilno oblikovan vhod z izjemo CharacterCodingException.

ByteBuffer.wrap(array) uporablja isto polje bajtov brez kopiranja: položaj je nič, meja in kapaciteta pa sta array.length. wrap(array, offset, length) ohrani kapaciteto celotnega polja, vendar nastavi položaj na offset in mejo na offset + length. Neveljavno območje sproži IndexOutOfBoundsException. Relativni get() prebere en bajt, get(dst) zapolni ciljno polje, get(dst, offset, length) pa kopira length bajtov od podanega indeksa v ciljnem polju. Ti klici premaknejo položaj in ob pomanjkanju bajtov sprožijo BufferUnderflowException brez delnega prenosa. Absolutni različici get(index) in get(index, dst[, offset, length]) položaja ne spremenita; neveljaven indeks ali območje sproži IndexOutOfBoundsException.

asReadOnlyBuffer() ima skupno vsebino z izvornim medpomnilnikom in prevzame začetne vrednosti položaja, meje in oznake, ki so odtlej neodvisne. put prek pogleda sproži ReadOnlyBufferException, toda zapisi prek zapisljivega medpomnilnika so vidni v pogledu. Pogled, ustvarjen po kodiranju, ima sprva remaining() == 0. rewind() nastavi njegov položaj na nič in zavrže oznako, ne da bi spremenil mejo. Za ponovno branje istega območja izrecno nastavite prejšnji začetni položaj, če ni bil nič.

slice() ustvari pogled na preostalo območje, ne da bi premaknil položaj izvornega medpomnilnika. Novi položaj je nič, meja in kapaciteta sta enaki dolžini območja, oznaka ni določena in način samo za branje se ohrani. slice(index, length) uporabi absolutni indeks v medpomnilniku, ne odmika od položaja. Območje mora biti znotraj [0, limit()); prazno območje se lahko začne na meji. charAt(i) brez premika prebere char na position() + i in zahteva 0 <= i < remaining(). Neveljavno območje za slice ali indeks za charAt sproži IndexOutOfBoundsException. toString() vrne nespremenljiv String iz aktivnega območja, ne da bi spremenil položaj.

Primeri

import java.nio.ByteBuffer;
import java.nio.CharBuffer;
import java.nio.charset.CharacterCodingException;
import java.nio.charset.StandardCharsets;
import java.util.HexFormat;

public class BufferDemo {
    public static void main(String[] args) throws CharacterCodingException {
        CharBuffer cb = CharBuffer.wrap(new char[] {'[', '\u00E9', 'A', 'B', ']'});
        cb.position(1).limit(4);
        ByteBuffer encoded = StandardCharsets.UTF_8.newEncoder().encode(cb);
        System.out.println("input position=" + cb.position() + ", remaining=" + cb.remaining());

        byte[] bytes = new byte[encoded.remaining()];
        encoded.get(bytes);
        System.out.println("utf8=" + HexFormat.of().formatHex(bytes)
                + ", remaining=" + encoded.remaining());
        ByteBuffer suffix = ByteBuffer.wrap(bytes, 2, 2);
        System.out.println("suffix first=" + suffix.get() + ", remaining=" + suffix.remaining());

        CharBuffer view = cb.asReadOnlyBuffer();
        System.out.println("view initial remaining=" + view.remaining());
        view.rewind().position(2);
        CharBuffer tail = view.slice();
        System.out.println("charAt(0)=" + view.charAt(0) + ", view position=" + view.position()
                + ", input position=" + cb.position() + ", slice position=" + tail.position());

        String snapshot = tail.toString();
        cb.put(2, 'Z');
        System.out.println("snapshot=" + snapshot + ", slice now=" + tail.toString());
    }
}

Rezultat

input position=4, remaining=0
utf8=c3a94142, remaining=0
suffix first=65, remaining=1
view initial remaining=0
charAt(0)=A, view position=2, input position=4, slice position=0
snapshot=AB, slice now=ZB

Iz treh vrednosti `char` nastanejo štirje bajti UTF-8. Po zapisu v izvorni medpomnilnik pogled na izrez pokaže `ZB`, prejšnji String pa še vedno vsebuje `AB`.

Povezane lekcije

  • Java · Lekcija 51 · Napredna · Različica: 2

Viri