Интерфейс 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.intBitsToFloat. Этот метод подходит для чтения байтов, записанных методом writeFloat интерфейса DataOutput.

double readDouble() throws IOException

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

String readLine() throws IOException

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

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

String readUTF() throws IOException

Считывает строку, закодированную в формате изменённого UTF-8. Общая спецификация метода readUTF заключается в том, что он считывает представление строки символов Unicode, закодированной в формате изменённого 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 может использоваться для записи данных, пригодных для чтения этим методом.