Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

DataInputStream — leggere dati binari tipizzati

DataInputStream legge valori primitivi e stringhe da uno stream binario. È necessario conoscere l’ordine dei campi e la loro codifica; non analizza i numeri scritti come testo.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

new DataInputStream(InputStream in)
byte readByte() throws IOException
int readInt() throws IOException
double readDouble() throws IOException
String readUTF() throws IOException

DataInputStream del package java.io avvolge un InputStream e legge dati binari in un formato indipendente dalla macchina. I tipi e l’ordine di lettura devono corrispondere al formato dei dati, per esempio ai valori scritti da DataOutputStream. Lo stream non identifica automaticamente i tipi dei campi.

DataInputStream.readByte() consuma un byte e restituisce un byte con segno, da -128 a 127. DataInputStream.readInt() consuma quattro byte e restituisce un int con segno a 32 bit. DataInputStream.readDouble() consuma otto byte che rappresentano un valore double nel formato IEEE 754. I valori composti da più byte vengono letti in ordine big-endian: prima il byte più significativo.

DataInputStream.readUTF() restituisce uno String: legge prima una lunghezza senza segno di due byte, poi il numero indicato di byte in UTF-8 modificato. La lunghezza conta i byte, non i caratteri, e non supera 65535. Non è un lettore per normali file UTF-8; il formato corrisponde a writeUTF().

Questi metodi generano EOFException se non ci sono abbastanza byte per leggere un valore, invece di restituire un indicatore di fine. Gli altri errori di input/output causano IOException, mentre una codifica della stringa non valida può causare UTFDataFormatException. L’accesso simultaneo richiede una sincronizzazione esterna.

Esempi

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());
        }
    }
}

Risultato

-7
42
3.5
OK

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti