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

CKTIS / Java

ByteArrayOutputStream — escrever bytes em memória

ByteArrayOutputStream reúne bytes em memória. Aprende a escrever, a obter cópias independentes dos dados e porque close() não tem efeito.

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

Sintaxe

ByteArrayOutputStream out = new ByteArrayOutputStream();
out.write(intValue);
out.write(bytes, offset, length);
byte[] snapshot = out.toByteArray();
out.close();

ByteArrayOutputStream de java.io é um fluxo de saída que armazena bytes num array que cresce automaticamente, e não num ficheiro.

ByteArrayOutputStream.write(int) acrescenta um byte; write(byte[], int, int) acrescenta uma secção do array indicada pelo índice inicial e pelo número de bytes. Um intervalo inválido provoca IndexOutOfBoundsException.

ByteArrayOutputStream.toByteArray() devolve um novo array que copia os bytes acumulados. Alterar a cópia não altera o fluxo. A cópia requer memória adicional; evita acumular dados sem limite.

ByteArrayOutputStream.close() não tem efeito: são permitidas escritas posteriores e os dados continuam acessíveis. A assinatura continua a declarar IOException, como o exemplo prevê.

Exemplos

import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.util.Arrays;

public class Main {
    public static void main(String[] args) throws IOException {
        ByteArrayOutputStream out = new ByteArrayOutputStream();
        out.write(65);
        out.write(new byte[] {66, 67}, 0, 2);
        byte[] snapshot = out.toByteArray();
        snapshot[0] = 90;
        out.close();
        out.write(68);
        System.out.println(Arrays.toString(snapshot));
        System.out.println(Arrays.toString(out.toByteArray()));
    }
}

Resultado

[90, 66, 67]
[65, 66, 67, 68]

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