CKTIS / Java
CharBuffer: intervalos de dados e vistas partilhadas
CharBuffer contém valores char num intervalo controlado por position e limit. Aprende a indexação relativa à posição e a diferença entre uma vista partilhada só de leitura e uma cópia dos dados.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
CharBuffer b = CharBuffer.wrap(charArray);
b.position(start).limit(end);
CharBuffer view = b.slice();
CharBuffer readOnly = view.asReadOnlyBuffer();java.nio.CharBuffer é um buffer de valores char. CharBuffer.position() indica a posição seguinte, CharBuffer.limit() é o limite exclusivo e CharBuffer.remaining() devolve limit() - position(). position(int) e limit(int) definem a posição e o limite, respetivamente. remaining() não tem nenhuma sobrecarga que receba um argumento e não existe um método para definir diretamente o número de elementos restantes. Verifica-se 0 <= position() <= limit() <= capacity(). Se o limite for reduzido para um valor inferior à posição, a posição também é reduzida.
CharBuffer.charAt(i) lê o elemento em position() + i sem avançar a posição; requer 0 <= i < remaining(). CharBuffer.toString() devolve o texto de [position(), limit()), também sem avançar a posição.
CharBuffer.slice() cria uma vista partilhada do intervalo restante: a posição é zero, e o limite e a capacidade são iguais ao remaining() original. CharBuffer.asReadOnlyBuffer() partilha os dados e conserva inicialmente o estado da origem. A posição, o limite e a marca de cada vista são independentes. Só de leitura não significa que os dados sejam imutáveis: as escritas através de outra vista gravável continuam visíveis; escrever através da vista só de leitura lança ReadOnlyBufferException.
CharBuffer.rewind() repõe a posição a zero e descarta a marca, preservando o limite e os dados. Também funciona numa vista só de leitura. No exemplo, as alterações através de s são visíveis através de ro, mas alterar a posição de ro não altera a posição de b.
Exemplos
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());
}
}Resultado
3:B:BCD CD XCD 1:4:XCD
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.