CKTIS / Java
DataInputStream — čitanje tipiziranih binarnih podataka
DataInputStream čita primitivne vrijednosti i nizove znakova iz binarnog toka. Potrebno je poznavati redoslijed polja i njihovo kodiranje; ne parsira brojeve zapisane kao tekst.
Verzija: 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 IOExceptionDataInputStream iz paketa java.io omata InputStream i čita binarne podatke u formatu neovisnom o računalu. Vrste i redoslijed čitanja moraju odgovarati formatu podataka, primjerice vrijednostima koje zapisuje DataOutputStream. Tok ne prepoznaje automatski vrste polja.
DataInputStream.readByte() troši jedan bajt i vraća predznačeni byte u rasponu od -128 do 127. DataInputStream.readInt() troši četiri bajta i vraća predznačeni 32-bitni int. DataInputStream.readDouble() troši osam bajtova koji predstavljaju vrijednost double u formatu IEEE 754. Višebajtne vrijednosti čitaju se redoslijedom big-endian: prvo najznačajniji bajt.
DataInputStream.readUTF() vraća String: najprije čita dvobajtnu duljinu bez predznaka, a zatim navedeni broj bajtova u izmijenjenom UTF-8. Duljina broji bajtove, a ne znakove, i iznosi najviše 65535. Ovo nije čitač običnih UTF-8 datoteka; format odgovara metodi writeUTF().
Ove metode izbacuju EOFException ako nema dovoljno bajtova za čitanje vrijednosti, umjesto da vrate oznaku kraja. Druge ulazno-izlazne pogreške uzrokuju IOException, a neispravno kodiranje niza može uzrokovati UTFDataFormatException. Istodobni pristup zahtijeva vanjsku sinkronizaciju.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.