CKTIS / Java
DataInputStream — четене на типизирани двоични данни
DataInputStream чете примитивни стойности и низове от двоичен поток. Трябва да знаете реда и кодирането на полетата; класът не анализира числа, записани като текст.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
new DataInputStream(InputStream in)
byte readByte() throws IOException
int readInt() throws IOException
double readDouble() throws IOException
String readUTF() throws IOExceptionDataInputStream от пакета java.io обвива InputStream и чете двоични данни във формат, независим от машината. Типовете и редът на четене трябва да съответстват на формата на данните, например на стойности, записани чрез DataOutputStream. Потокът не разпознава автоматично типовете на полетата.
DataInputStream.readByte() консумира един байт и връща знаков byte със стойност от -128 до 127. DataInputStream.readInt() консумира четири байта и връща знаков 32-битов int. DataInputStream.readDouble() консумира осем байта, представящи стойност double във формат IEEE 754. Многобайтовите стойности се четат в ред big-endian: първо най-значимият байт.
DataInputStream.readUTF() връща String: първо прочита двубайтова дължина без знак, след което посочения брой байтове в модифициран UTF-8. Дължината брои байтове, а не знаци, и е най-много 65535. Това не е четец за обикновени UTF-8 файлове; форматът съответства на writeUTF().
Тези методи хвърлят EOFException, когато няма достатъчно байтове за прочитане на стойност, вместо да връщат маркер за край. Други грешки при вход/изход причиняват IOException, а невалидно кодиране на низ може да причини UTFDataFormatException. Едновременният достъп изисква външна синхронизация.
Примери
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());
}
}
}Резултат
-7 42 3.5 OK
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.