Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

DataInputStream — leer datos binarios tipados

DataInputStream lee valores primitivos y cadenas de un flujo binario. Es necesario conocer el orden y la codificación de los campos; no analiza números escritos como texto.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

DataInputStream del paquete java.io envuelve un InputStream y lee datos binarios en un formato independiente de la máquina. Los tipos y el orden de lectura deben coincidir con el formato de los datos, por ejemplo, con los valores escritos por DataOutputStream. El flujo no identifica automáticamente los tipos de los campos.

DataInputStream.readByte() consume un byte y devuelve un byte con signo, entre -128 y 127. DataInputStream.readInt() consume cuatro bytes y devuelve un int de 32 bits con signo. DataInputStream.readDouble() consume ocho bytes que representan un valor double en formato IEEE 754. Los valores de varios bytes se leen en orden big-endian: primero el byte más significativo.

DataInputStream.readUTF() devuelve un String: primero lee una longitud sin signo de dos bytes y, después, esa cantidad de bytes en UTF-8 modificado. La longitud cuenta bytes, no caracteres, y como máximo es 65535. No es un lector para archivos UTF-8 normales; el formato corresponde a writeUTF().

Estos métodos lanzan EOFException si no hay suficientes bytes para leer un valor, en lugar de devolver una marca de fin. Otros fallos de entrada/salida provocan IOException, y una codificación de cadena no válida puede provocar UTFDataFormatException. El acceso concurrente requiere sincronización externa.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes