Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

DataInputStream — čítanie typovaných binárnych údajov

DataInputStream číta primitívne hodnoty a reťazce z binárneho prúdu. Je potrebné poznať poradie polí a ich kódovanie; čísla zapísané ako text neparsuje.

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

Syntax

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

DataInputStream z balíka java.io obaľuje InputStream a číta binárne údaje vo formáte nezávislom od počítača. Čítané typy a ich poradie musia zodpovedať formátu údajov, napríklad hodnotám zapísaným pomocou DataOutputStream. Prúd typy polí nerozpoznáva automaticky.

DataInputStream.readByte() spotrebuje jeden bajt a vráti znamienkový byte v rozsahu od -128 do 127. DataInputStream.readInt() spotrebuje štyri bajty a vráti znamienkový 32-bitový int. DataInputStream.readDouble() spotrebuje osem bajtov predstavujúcich hodnotu double vo formáte IEEE 754. Viacbajtové hodnoty sa čítajú v poradí big-endian: najprv najvýznamnejší bajt.

DataInputStream.readUTF() vráti String: najprv prečíta dvojbajtovú dĺžku bez znamienka a potom uvedený počet bajtov v upravenom UTF-8. Dĺžka udáva počet bajtov, nie znakov, a môže byť najviac 65535. Nie je to čítačka bežných súborov UTF-8; formát zodpovedá metóde writeUTF().

Tieto metódy vyvolajú EOFException, ak na prečítanie hodnoty nie je dostatok bajtov, namiesto toho, aby vrátili značku konca. Iné chyby vstupu/výstupu spôsobia IOException a neplatné kódovanie reťazca môže spôsobiť UTFDataFormatException. Súbežný prístup vyžaduje externú synchronizáciu.

Prí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ýsledok

-7
42
3.5
OK

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje