CKTIS / Java
CharBuffer: zakres danych i współdzielone widoki
CharBuffer przechowuje wartości char w zakresie wyznaczonym przez position i limit. Poznaj indeksowanie względem pozycji oraz różnicę między współdzielonym widokiem tylko do odczytu a kopią danych.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
CharBuffer b = CharBuffer.wrap(charArray);
b.position(start).limit(end);
CharBuffer view = b.slice();
CharBuffer readOnly = view.asReadOnlyBuffer();java.nio.CharBuffer to bufor wartości char. CharBuffer.position() wskazuje następną pozycję, CharBuffer.limit() wyznacza wyłączną granicę, a CharBuffer.remaining() zwraca limit() - position(). Metody position(int) i limit(int) ustawiają odpowiednio pozycję i limit. Metoda remaining() nie ma wariantu z argumentem ani metody ustawiającej liczbę pozostałych elementów bezpośrednio. Obowiązuje 0 <= position() <= limit() <= capacity(). Obniżenie limitu poniżej pozycji obniża też pozycję.
CharBuffer.charAt(i) odczytuje element position() + i, bez przesuwania pozycji; wymaga 0 <= i < remaining(). CharBuffer.toString() zwraca tekst z zakresu [position(), limit()), również bez przesuwania pozycji.
CharBuffer.slice() tworzy współdzielony widok pozostałego zakresu: pozycja wynosi zero, a limit i pojemność są równe pierwotnemu remaining(). CharBuffer.asReadOnlyBuffer() współdzieli dane i początkowo zachowuje stan źródła. Stan pozycji, limitu i znacznika każdego widoku jest niezależny. Tylko odczyt nie oznacza niezmienności danych: zapis przez inny zapisywalny widok pozostaje widoczny; zapis przez widok tylko do odczytu powoduje ReadOnlyBufferException.
CharBuffer.rewind() zeruje pozycję i usuwa znacznik, zachowując limit oraz dane. Działa także na widoku tylko do odczytu. W przykładzie zmiana przez s jest widoczna przez ro, ale przesunięcie ro nie zmienia pozycji b.
Przykłady
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());
}
}Wynik
3:B:BCD CD XCD 1:4:XCD
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.