CKTIS / Java
CharBuffer: gegevensbereiken en gedeelde views
CharBuffer bevat char-waarden binnen een bereik dat wordt bepaald door position en limit. Leer positioneel indexeren en het verschil tussen een gedeelde alleen-lezen-view en een kopie van de gegevens.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
CharBuffer b = CharBuffer.wrap(charArray);
b.position(start).limit(end);
CharBuffer view = b.slice();
CharBuffer readOnly = view.asReadOnlyBuffer();java.nio.CharBuffer is een buffer voor char-waarden. CharBuffer.position() geeft de volgende positie aan, CharBuffer.limit() is de exclusieve grens en CharBuffer.remaining() retourneert limit() - position(). position(int) stelt de positie in en limit(int) de limiet. remaining() heeft geen overload met een argument, en het aantal resterende elementen kan niet rechtstreeks worden ingesteld. Er geldt 0 <= position() <= limit() <= capacity(). Als de limiet onder de positie wordt verlaagd, wordt ook de positie verlaagd.
CharBuffer.charAt(i) leest het element op position() + i zonder de positie te verplaatsen; hiervoor geldt 0 <= i < remaining(). CharBuffer.toString() retourneert tekst uit [position(), limit()), eveneens zonder de positie te verplaatsen.
CharBuffer.slice() maakt een gedeelde view van het resterende bereik: de positie is nul en de limiet en capaciteit zijn gelijk aan de oorspronkelijke remaining(). CharBuffer.asReadOnlyBuffer() deelt de gegevens en behoudt aanvankelijk de toestand van de bron. De positie, limiet en markering van elke view zijn onafhankelijk. Alleen-lezen betekent niet dat de gegevens onveranderlijk zijn: schrijfbewerkingen via een andere schrijfbare view blijven zichtbaar; schrijven via de alleen-lezen-view veroorzaakt ReadOnlyBufferException.
CharBuffer.rewind() zet de positie op nul en verwijdert de markering, terwijl de limiet en gegevens behouden blijven. De methode werkt ook op een alleen-lezen-view. In het voorbeeld zijn wijzigingen via s zichtbaar via ro, maar het verplaatsen van ro verandert de positie van b niet.
Voorbeelden
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());
}
}Resultaat
3:B:BCD CD XCD 1:4:XCD
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.