CKTIS / Java
DataOutputStream — escrita de dados binários
DataOutputStream escreve valores primitivos e cadeias de caracteres num fluxo binário, num formato definido. Aprende os tamanhos dos dados, a ordem dos bytes e as limitações de writeUTF.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
new DataOutputStream(OutputStream out)
void writeByte(int v) throws IOException
void writeInt(int v) throws IOException
void writeDouble(double v) throws IOException
void writeUTF(String str) throws IOExceptionDataOutputStream, de java.io, envolve um OutputStream e escreve dados binários em vez de representações textuais. A leitura com DataInputStream tem de respeitar a ordem e os tipos dos valores escritos.
DataOutputStream.writeByte(int) escreve apenas os 8 bits menos significativos: 257 produz o byte 0x01, sem validar o intervalo. DataOutputStream.writeInt(int) escreve 4 bytes em ordem big-endian, começando pelo mais significativo. DataOutputStream.writeDouble(double) escreve 8 bytes nessa mesma ordem, após a conversão através de Double.doubleToLongBits.
DataOutputStream.writeUTF(String) escreve um comprimento dos dados de dois bytes, expresso em bytes, seguido de UTF-8 modificado. Não é UTF-8 normal: NUL ocupa 2 bytes e os caracteres fora do plano multilingue básico são codificados como pares de substitutos. O limite é de 65535 bytes de dados codificados, não de caracteres; ultrapassá-lo provoca UTFDataFormatException.
Os métodos de escrita podem lançar IOException. A partilha do fluxo entre várias threads requer sincronização. O exemplo apresenta os 17 bytes esperados em formato hexadecimal. A documentação abrange Java SE 21; nem o ambiente de execução do repositório nem o ambiente de produção foram atestados.
Exemplos
import java.io.ByteArrayOutputStream;
import java.io.DataOutputStream;
import java.io.IOException;
import java.util.HexFormat;
public class Main {
public static void main(String[] args) throws IOException {
ByteArrayOutputStream bytes = new ByteArrayOutputStream();
try (DataOutputStream out = new DataOutputStream(bytes)) {
out.writeByte(257);
out.writeInt(42);
out.writeDouble(1.5);
out.writeUTF("OK");
}
System.out.println(HexFormat.of().formatHex(bytes.toByteArray()));
}
}Resultado
010000002a3ff800000000000000024f4b
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.