Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes