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

CKTIS / Java

ByteArrayInputStream — ler bytes de um array

ByteArrayInputStream expõe um array de bytes como fluxo de entrada. close() não impede a continuação da leitura.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public ByteArrayInputStream(byte[] buf)
public ByteArrayInputStream(byte[] buf, int offset, int length)
public void close() throws IOException

java.io.ByteArrayInputStream é uma subclasse de InputStream que lê bytes da memória. O construtor aceita um array completo ou um intervalo definido por offset e length. Não copia o array: as alterações ao seu conteúdo podem afetar leituras posteriores.

read() devolve um int entre 0 e 255, ou -1 no fim do fluxo. available() indica o número de bytes restantes.

mark(int readAheadLimit) guarda a posição e reset() regressa a essa posição. O argumento readAheadLimit é obrigatório, embora esta classe ignore o seu valor. A marca inicial aponta para o início do intervalo selecionado.

ByteArrayInputStream.close() não tem efeito; a leitura e reset() continuam a funcionar. No entanto, a sua declaração inclui throws IOException, pelo que quem o utiliza tem de tratar ou declarar a exceção. Não generalize este comportamento a outros fluxos.

Exemplos

import java.io.ByteArrayInputStream;
import java.io.IOException;

public class Main {
    public static void main(String[] args) throws IOException {
        byte[] data = {10, (byte) 255};
        ByteArrayInputStream input = new ByteArrayInputStream(data);

        System.out.println(input.read());
        input.close();
        System.out.println(input.read());
        System.out.println(input.read());
        input.reset();
        System.out.println(input.read());
    }
}

Resultado

10
255
-1
10

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