CKTIS / Java
CharBuffer: rozsahy dat a sdílená zobrazení
CharBuffer obsahuje hodnoty char v rozsahu řízeném pomocí position a limit. Poznejte indexování relativní k pozici a rozdíl mezi sdíleným zobrazením pouze pro čtení a kopií dat.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
CharBuffer b = CharBuffer.wrap(charArray);
b.position(start).limit(end);
CharBuffer view = b.slice();
CharBuffer readOnly = view.asReadOnlyBuffer();java.nio.CharBuffer je buffer hodnot char. CharBuffer.position() označuje následující pozici, CharBuffer.limit() výhradní hranici a CharBuffer.remaining() vrací limit() - position(). position(int) nastavuje pozici a limit(int) nastavuje limit. Metoda remaining() nemá přetíženou variantu s argumentem a počet zbývajících prvků nelze nastavit přímo. Platí 0 <= position() <= limit() <= capacity(). Snížení limitu pod pozici sníží také pozici.
CharBuffer.charAt(i) přečte prvek na pozici position() + i, aniž by posunul pozici; vyžaduje 0 <= i < remaining(). CharBuffer.toString() vrací text z rozsahu [position(), limit()), rovněž bez posunutí pozice.
CharBuffer.slice() vytvoří sdílené zobrazení zbývajícího rozsahu: pozice je nula a limit i kapacita se rovnají původní hodnotě remaining(). CharBuffer.asReadOnlyBuffer() sdílí data a zpočátku zachovává stav zdroje. Pozice, limit a značka každého zobrazení jsou nezávislé. Pouze pro čtení neznamená neměnná data: zápisy přes jiné zapisovatelné zobrazení zůstávají viditelné; zápis přes zobrazení pouze pro čtení vyvolá ReadOnlyBufferException.
CharBuffer.rewind() nastaví pozici na nulu a odstraní značku, přičemž zachová limit i data. Funguje také u zobrazení pouze pro čtení. V příkladu jsou změny provedené přes s viditelné přes ro, ale změna pozice ro nezmění pozici b.
Příklady
import java.nio.CharBuffer;
public class Main {
public static void main(String[] args) {
CharBuffer b = CharBuffer.wrap(new char[] {'A', 'B', 'C', 'D', 'E'});
b.position(1).limit(4);
CharBuffer s = b.slice();
CharBuffer ro = s.asReadOnlyBuffer();
System.out.println(b.remaining() + ":" + b.charAt(0) + ":" + b.toString());
s.put(0, 'X');
ro.position(1);
System.out.println(ro.toString());
ro.rewind();
System.out.println(ro.toString());
System.out.println(b.position() + ":" + b.limit() + ":" + b.toString());
}
}Výsledek
3:B:BCD CD XCD 1:4:XCD
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.