Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

DataInputStream — lire des données binaires typées

DataInputStream lit des valeurs primitives et des chaînes depuis un flux binaire. Il faut connaître l’ordre des champs et leur encodage ; cette classe ne parse pas les nombres écrits sous forme de texte.

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

Syntaxe

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

DataInputStream du package java.io enveloppe un InputStream et lit des données binaires dans un format indépendant de la machine. Les types et l’ordre de lecture doivent correspondre au format des données, par exemple aux valeurs écrites par DataOutputStream. Le flux ne reconnaît pas automatiquement les types des champs.

DataInputStream.readByte() consomme un octet et renvoie un byte signé, compris entre -128 et 127. DataInputStream.readInt() consomme quatre octets et renvoie un int signé de 32 bits. DataInputStream.readDouble() consomme huit octets représentant une valeur double au format IEEE 754. Les valeurs sur plusieurs octets sont lues en ordre big-endian : l’octet de poids fort en premier.

DataInputStream.readUTF() renvoie un String : la méthode lit d’abord une longueur non signée sur deux octets, puis le nombre d’octets indiqué en UTF-8 modifié. La longueur compte les octets, et non les caractères, et ne dépasse pas 65535. Ce n’est pas un lecteur de fichiers UTF-8 ordinaires ; le format correspond à writeUTF().

Ces méthodes lancent une EOFException s’il manque des octets pour lire une valeur, au lieu de renvoyer un marqueur de fin. Les autres erreurs d’entrée/sortie provoquent une IOException, et un encodage de chaîne invalide peut provoquer une UTFDataFormatException. Un accès concurrent nécessite une synchronisation externe.

Exemples

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

Résultat

-7
42
3.5
OK

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources