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