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 IOExceptionDataInputStream 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.