Интерфейс 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. Обратите внимание, что, поскольку этот метод обрабатывает байты, он не поддерживает ввод полного набора символов 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 можно использовать для записи данных, пригодных для чтения этим методом.