CKTIS / Java
CharBuffer: диапазони от данни и споделени изгледи
CharBuffer съдържа стойности char в диапазон, управляван от position и limit. Научете за индексирането спрямо позицията и разликата между споделен изглед само за четене и копие на данните.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
CharBuffer b = CharBuffer.wrap(charArray);
b.position(start).limit(end);
CharBuffer view = b.slice();
CharBuffer readOnly = view.asReadOnlyBuffer();java.nio.CharBuffer е буфер от стойности char. CharBuffer.position() указва следващата позиция, CharBuffer.limit() е изключващата граница, а CharBuffer.remaining() връща limit() - position(). position(int) задава позицията, а limit(int) задава границата. Методът remaining() няма вариант с аргумент и броят на оставащите елементи не може да се задава пряко. Важи 0 <= position() <= limit() <= capacity(). Ако limit бъде намален под position, position също се намалява.
CharBuffer.charAt(i) прочита елемента на position() + i, без да премества position; изисква се 0 <= i < remaining(). CharBuffer.toString() връща текста от [position(), limit()), също без да премества position.
CharBuffer.slice() създава споделен изглед на оставащия диапазон: position е нула, а limit и капацитетът са равни на първоначалния remaining(). CharBuffer.asReadOnlyBuffer() споделя данните и първоначално запазва състоянието на източника. Position, limit и маркерът на всеки изглед са независими. Само за четене не означава, че данните са неизменни: записите чрез друг изглед с възможност за запис остават видими; записът чрез изгледа само за четене предизвиква ReadOnlyBufferException.
CharBuffer.rewind() задава position на нула и премахва маркера, като запазва limit и данните. Работи и върху изглед само за четене. В примера промените чрез s се виждат чрез ro, но промяната на позицията на ro не променя позицията на b.
Примери
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());
}
}Резултат
3:B:BCD CD XCD 1:4:XCD
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.