Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

DataInputStream — čtení typovaných binárních dat

DataInputStream čte primitivní hodnoty a řetězce z binárního proudu. Je nutné znát pořadí polí a jejich kódování; čísla zapsaná jako text neparsuje.

Verze: 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 z balíčku java.io obaluje InputStream a čte binární data ve strojově nezávislém formátu. Čtené typy a jejich pořadí musí odpovídat formátu dat, například hodnotám zapsaným pomocí DataOutputStream. Proud typy polí nerozpoznává automaticky.

DataInputStream.readByte() spotřebuje jeden bajt a vrátí znaménkový byte v rozsahu od -128 do 127. DataInputStream.readInt() spotřebuje čtyři bajty a vrátí znaménkový 32bitový int. DataInputStream.readDouble() spotřebuje osm bajtů představujících hodnotu double ve formátu IEEE 754. Vícebajtové hodnoty se čtou v pořadí big-endian: nejprve nejvýznamnější bajt.

DataInputStream.readUTF() vrátí String: nejprve přečte dvoubajtovou délku bez znaménka a poté uvedený počet bajtů v upraveném UTF-8. Délka udává počet bajtů, nikoli znaků, a může být nejvýše 65535. Nejde o čtečku běžných souborů UTF-8; formát odpovídá metodě writeUTF().

Tyto metody vyvolají EOFException, pokud pro přečtení hodnoty není dostatek bajtů, místo aby vrátily značku konce. Jiné chyby vstupu/výstupu způsobí IOException a neplatné kódování řetězce může způsobit UTFDataFormatException. Současný přístup vyžaduje externí synchronizaci.

Příklady

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

Výsledek

-7
42
3.5
OK

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje