CKTIS / Java
DataInputStream — ler dados binários tipados
DataInputStream lê valores primitivos e cadeias de caracteres de um fluxo binário. É necessário conhecer a ordem dos campos e a respetiva codificação; não analisa números escritos como texto.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
new DataInputStream(InputStream in)
byte readByte() throws IOException
int readInt() throws IOException
double readDouble() throws IOException
String readUTF() throws IOExceptionDataInputStream do pacote java.io envolve um InputStream e lê dados binários num formato independente da máquina. Os tipos e a ordem de leitura têm de corresponder ao formato dos dados, por exemplo, aos valores escritos por DataOutputStream. O fluxo não identifica automaticamente os tipos dos campos.
DataInputStream.readByte() consome um byte e devolve um byte com sinal, de -128 a 127. DataInputStream.readInt() consome quatro bytes e devolve um int de 32 bits com sinal. DataInputStream.readDouble() consome oito bytes que representam um valor double no formato IEEE 754. Os valores com vários bytes são lidos por ordem big-endian: primeiro o byte mais significativo.
DataInputStream.readUTF() devolve um String: primeiro lê um comprimento sem sinal de dois bytes e, em seguida, essa quantidade de bytes em UTF-8 modificado. O comprimento conta bytes, não caracteres, e é no máximo 65535. Não é um leitor para ficheiros UTF-8 comuns; o formato corresponde a writeUTF().
Estes métodos lançam EOFException quando não existem bytes suficientes para ler um valor, em vez de devolverem uma marca de fim. As outras falhas de entrada/saída causam IOException, e uma codificação de cadeia inválida pode causar UTFDataFormatException. O acesso concorrente requer sincronização externa.
Exemplos
import java.io.ByteArrayInputStream;
import java.io.DataInputStream;
import java.io.IOException;
public class Main {
public static void main(String[] args) throws IOException {
byte[] data = {
-7,
0, 0, 0, 42,
0x40, 0x0C, 0, 0, 0, 0, 0, 0,
0, 2, 0x4F, 0x4B
};
try (DataInputStream in = new DataInputStream(
new ByteArrayInputStream(data))) {
System.out.println(in.readByte());
System.out.println(in.readInt());
System.out.println(in.readDouble());
System.out.println(in.readUTF());
}
}
}Resultado
-7 42 3.5 OK
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.