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

CKTIS / Java

DataOutputStream — écrire des données binaires

DataOutputStream écrit des valeurs primitives et des chaînes dans un flux binaire selon un format défini. Découvrez la taille des données, l’ordre des octets et les limites de writeUTF.

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

Syntaxe

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 IOException

DataOutputStream de java.io enveloppe un OutputStream et écrit des données binaires plutôt que des représentations textuelles. La lecture avec DataInputStream doit respecter l’ordre et les types des valeurs écrites.

DataOutputStream.writeByte(int) n’écrit que les 8 bits de poids faible : 257 produit l’octet 0x01, sans vérification de plage. DataOutputStream.writeInt(int) écrit 4 octets en ordre big-endian, en commençant par le plus significatif. DataOutputStream.writeDouble(double) écrit 8 octets dans le même ordre, après conversion au moyen de Double.doubleToLongBits.

DataOutputStream.writeUTF(String) écrit une longueur de données de deux octets, exprimée en octets, puis du UTF-8 modifié. Ce n’est pas du UTF-8 ordinaire : NUL occupe 2 octets et les caractères hors du plan multilingue de base sont encodés sous forme de paires de substitution. La limite est de 65535 octets de données encodées, et non de caractères ; la dépasser provoque UTFDataFormatException.

Les méthodes d’écriture peuvent lever IOException. Le partage du flux entre plusieurs threads nécessite une synchronisation. L’exemple affiche les 17 octets attendus en hexadécimal. La documentation porte sur Java SE 21 ; ni l’environnement d’exécution du dépôt ni celui de production n’a été attesté.

Exemples

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

Résultat

010000002a3ff800000000000000024f4b

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