Интерфейс DataInput

void readFully(byte[] b) throws IOException

Считывает несколько байтов из входного потока и сохраняет их в массив буфера b. Количество считанных байтов равно длине b.

Этот метод блокируется, пока не выполнится одно из следующих условий:

• b.length байтов входных данных доступны, в этом случае выполняется нормальное возвращение.
• Обнаружен конец файла, в этом случае генерируется исключение EOFException.
• Возникает ошибка ввода-вывода, в этом случае генерируется исключение IOException, отличное от EOFException.

Если b равно null, генерируется исключение NullPointerException. Если b.length равно нулю, байты не считываются. В противном случае, первый считанный байт сохраняется в элемент b[0], следующий - в b[1] и так далее. Если из этого метода выбрасывается исключение, то некоторые, но не все байты b могут быть обновлены данными из входного потока.

void readFully(byte[] b, int off, int len) throws IOException

Считывает len байтов из входного потока.

Этот метод блокируется, пока не выполнится одно из следующих условий:

• len байтов входных данных доступны, в этом случае выполняется нормальное возвращение.
• Обнаружен конец файла, в этом случае генерируется исключение EOFException.
• Возникает ошибка ввода-вывода, в этом случае генерируется исключение IOException, отличное от EOFException.

Если b равно null, генерируется исключение NullPointerException. Если off отрицательно, или len отрицательно, или off+len больше длины массива b, генерируется исключение IndexOutOfBoundsException. Если len равно нулю, байты не считываются. В противном случае, первый считанный байт сохраняется в элемент b[off], следующий - в b[off+1] и так далее. Количество считанных байтов не превышает len.

int skipBytes(int n) throws IOException

Попытка пропустить n байтов данных из входного потока, отбросив пропущенные байты. Однако, может быть пропущено меньшее количество байтов, возможно, ноль. Это может произойти по многим причинам; достижение конца файла до того, как будет пропущено n байтов, является лишь одним из вариантов. Этот метод никогда не выбрасывает исключение EOFException. Возвращается фактическое количество пропущенных байтов.

boolean readBoolean() throws IOException

Считывает один байт входного потока и возвращает true, если этот байт не равен нулю, и false, если этот байт равен нулю. Этот метод подходит для считывания байта, записанного методом writeBoolean интерфейса DataOutput.

byte readByte() throws IOException

Считывает и возвращает один байт. Байты обрабатываются как знаковое значение в диапазоне от -128 до 127 включительно. Этот метод подходит для считывания байта, записанного методом writeByte интерфейса DataOutput.

int readUnsignedByte() throws IOException

Считывает один входной байт, расширяет его до типа int с заполнением нулями и возвращает результат, который, следовательно, находится в диапазоне от 0 до 255. Этот метод подходит для считывания байта, записанного методом writeByte интерфейса DataOutput, если аргумент к методу writeByte должен был быть значением в диапазоне от 0 до 255.

short readShort() throws IOException

Считывает два входных байта и возвращает значение типа short. Пусть a - первый считанный байт, а b - второй байт. Возвращаемое значение равно:

(short)((a << 8) | (b & 0xff))
 

Этот метод подходит для считывания байтов, записанных методом writeShort интерфейса DataOutput.

int readUnsignedShort() throws IOException

Считывает два входных байта и возвращает значение типа int в диапазоне от 0 до 65535. Пусть a - первый считанный байт, а b - второй байт. Возвращаемое значение равно:

(((a & 0xff) << 8) | (b & 0xff))
 

Этот метод подходит для считывания байтов, записанных методом writeShort интерфейса DataOutput, если аргумент к методу writeShort должен был быть значением в диапазоне от 0 до 65535.

char readChar() throws IOException

Считывает два входных байта и возвращает значение типа char. Пусть a - первый считанный байт, а b - второй байт. Возвращаемое значение равно:

(char)((a << 8) | (b & 0xff))
 

Этот метод подходит для считывания байтов, записанных методом writeChar интерфейса DataOutput.

int readInt() throws IOException

Считывает четыре входных байта и возвращает значение типа int. Пусть a-d - первый по четвёртый считанные байты. Возвращаемое значение равно:

 (((a & 0xff) << 24) | ((b & 0xff) << 16) |
  ((c & 0xff) <<  8) | (d & 0xff))
 

Этот метод подходит для считывания байтов, записанных методом writeInt интерфейса DataOutput.

long readLong() throws IOException

Считывает восемь входных байтов и возвращает значение типа long. Пусть a-h - первый по восьмой считанные байты. Возвращаемое значение равно:

 (((long)(a & 0xff) << 56) |
  ((long)(b & 0xff) << 48) |
  ((long)(c & 0xff) << 40) |
  ((long)(d & 0xff) << 32) |
  ((long)(e & 0xff) << 24) |
  ((long)(f & 0xff) << 16) |
  ((long)(g & 0xff) <<  8) |
  ((long)(h & 0xff)))
 

Этот метод подходит для считывания байтов, записанных методом writeLong интерфейса DataOutput.

float readFloat() throws IOException

Считывает четыре входных байта и возвращает значение типа float. Это делается путём сначала построения значения типа int точно так же, как в методе readInt, а затем преобразования этого значения типа int в значение типа float точно так же, как в методе Float.intBitsToFloat. Этот метод подходит для считывания байтов, записанных методом writeFloat интерфейса DataOutput.

double readDouble() throws IOException

Считывает восемь входных байтов и возвращает значение типа double. Это делается путём сначала построения значения типа long точно так же, как в методе readLong, а затем преобразования этого значения типа long в значение типа double точно так же, как в методе Double.longBitsToDouble. Этот метод подходит для считывания байтов, записанных методом writeDouble интерфейса DataOutput.

String readLine() throws IOException

Считывает следующую строку текста из входного потока. Он считывает последовательные байты, преобразуя каждый байт в отдельный символ, пока не встретит разделитель строк или конец файла; считанные символы затем возвращаются как строка String. Обратите внимание, что поскольку этот метод обрабатывает байты, он не поддерживает ввод всего набора символов Юникод.

Если конец файла встречен до того, как можно прочитать хотя бы один байт, то возвращается null. В противном случае каждый считанный байт преобразуется в тип char с помощью нулевого расширения. Если встречен символ '\n', он отбрасывается, и чтение прекращается. Если встречен символ '\r', он отбрасывается, и, если следующий байт преобразуется в символ '\n', то и он отбрасывается; чтение прекращается. Если конец файла встречен до того, как встречены символы '\n' и '\r', чтение прекращается. После прекращения чтения возвращается строка String, содержащая все считанные и не отброшенные символы в порядке следования. Обратите внимание, что каждое значение символа в этой строке будет меньше, чем \u0100, то есть, (char)256.

String readUTF() throws IOException

Считывает строку, закодированную в формате изменённый UTF-8. Общая спецификация метода readUTF заключается в том, что он считывает представление строки символов Юникод, закодированной в формате изменённый UTF-8; эта строка символов затем возвращается как String.

Сначала считываются два байта и используются для построения целого без знака 16 бит точно так же, как в методе readUnsignedShort. Это целое значение называется длина UTF и определяет количество дополнительных байтов, которые должны быть прочитаны. Затем эти байты преобразуются в символы, рассматривая их группами. Длина каждой группы вычисляется из значения первого байта группы. Байты, следующие за группой, если таковые есть, являются первыми байтами следующей группы.

Если первый байт группы соответствует битовой схеме 0xxxxxxx (где x означает "может быть 0 или 1"), то группа состоит только из этого байта. Байты преобразуется в символ с помощью нулевого расширения.

Если первый байт группы соответствует битовой схеме 110xxxxx, то группа состоит из этого байта a и второго байта b. Если байта b нет (потому что байт a был последним из считанных байтов), или если байт b не соответствует битовой схеме 10xxxxxx, то бросается исключение UTFDataFormatException. В противном случае группа преобразуется в символ:

(char)(((a & 0x1F) << 6) | (b & 0x3F))
 

Если первый байт группы соответствует битовой схеме 1110xxxx, то группа состоит из этого байта a и ещё двух байтов b и c. Если байта c нет (потому что байт a был одним из последних двух считанных байтов), или байт b или байт c не соответствуют битовой схеме 10xxxxxx, то бросается исключение UTFDataFormatException. В противном случае группа преобразуется в символ:

 (char)(((a & 0x0F) << 12) | ((b & 0x3F) << 6) | (c & 0x3F))
 

Если первый байт группы соответствует схеме 1111xxxx или схеме 10xxxxxx, то бросается исключение UTFDataFormatException.

Если конец файла встречен в любой момент во время всего этого процесса, то бросается исключение EOFException.

После преобразования каждой группы в символ путём этого процесса символы собираются в том же порядке, в котором соответствующие группы были прочитаны из входного потока, образуя строку String, которая и возвращается.

Метод writeUTF интерфейса DataOutput может использоваться для записи данных, пригодных для считывания этим методом.