Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

DataInputStream — branje tipiziranih binarnih podatkov

DataInputStream bere primitivne vrednosti in nize iz binarnega toka. Poznati morate vrstni red polj in njihovo kodiranje; števil, zapisanih kot besedilo, ne razčlenjuje.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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

DataInputStream iz paketa java.io ovije InputStream in bere binarne podatke v od računalnika neodvisni obliki. Vrste in vrstni red branja se morajo ujemati z obliko podatkov, na primer z vrednostmi, ki jih zapiše DataOutputStream. Tok vrst polj ne prepozna samodejno.

DataInputStream.readByte() porabi en bajt in vrne predznačeni byte z vrednostjo od -128 do 127. DataInputStream.readInt() porabi štiri bajte in vrne predznačeni 32-bitni int. DataInputStream.readDouble() porabi osem bajtov, ki predstavljajo vrednost double v obliki IEEE 754. Večbajtne vrednosti se berejo v vrstnem redu big-endian: najprej najpomembnejši bajt.

DataInputStream.readUTF() vrne String: najprej prebere dvobajtno dolžino brez predznaka, nato pa navedeno število bajtov v spremenjenem UTF-8. Dolžina šteje bajte, ne znakov, in je največ 65535. To ni bralnik za običajne datoteke UTF-8; oblika ustreza writeUTF().

Te metode sprožijo EOFException, kadar za branje vrednosti ni dovolj bajtov, namesto da bi vrnile oznako konca. Druge vhodno-izhodne napake povzročijo IOException, neveljavno kodiranje niza pa lahko povzroči UTFDataFormatException. Sočasni dostop zahteva zunanjo sinhronizacijo.

Primeri

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

Rezultat

-7
42
3.5
OK

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri