DataOutput (Платформа Java SE 7)

Все Известные Подынтерфейсы:

ImageOutputStream, ObjectOutput

Все Известные Классы с реализацией:

DataOutputStream, FileCacheImageOutputStream, FileImageOutputStream, ImageOutputStreamImpl, MemoryCacheImageOutputStream, ObjectOutputStream, RandomAccessFile
```
public interface DataOutput
```
DataOutput интерфейс предусматривает преобразование данных от любых из типов примитивов Java к серии байтов и записи этих байтов к двоичному потоку. Есть также средство для того, чтобы преобразовать a String в измененный формат UTF-8 и запись получающейся серии байтов.
Для всех методов в этом интерфейсе, которые пишут байты, это - обычно истина это, если байт не может быть записан ни по какой причине, IOException бросается.

С тех пор:

JDK1.0

См. Также:
DataInput, DataOutputStream

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`void`	`write(byte[] b)` Записи к потоку вывода все байты в массиве `b`.
`void`	`write(byte[] b, int off, int len)` Записи `len` байты от массива `b`, в порядке, к потоку вывода.
`void`	`write(int b)` Записи к потоку вывода восемь битов младшего разряда параметра `b`.
`void`	`writeBoolean(boolean v)` Записи a `boolean` оцените этому потоку вывода.
`void`	`writeByte(int v)` Записи к потоку вывода восемь младших разрядов - биты параметра `v`.
`void`	`writeBytes(String s)` Пишет строка в поток вывода.
`void`	`writeChar(int v)` Записи a `char` значение, которое состоит из двух байтов к потоку вывода.
`void`	`writeChars(String s)` Пишет каждый символ в строке `s`, к потоку вывода, в порядке, два байта за символ.
`void`	`writeDouble(double v)` Записи a `double` значение, которое состоит из восьми байтов к потоку вывода.
`void`	`writeFloat(float v)` Записи a `float` значение, которое состоит из четырех байтов к потоку вывода.
`void`	`writeInt(int v)` Записи `int` значение, которое состоит из четырех байтов к потоку вывода.
`void`	`writeLong(long v)` Записи a `long` значение, которое состоит из восьми байтов к потоку вывода.
`void`	`writeShort(int v)` Записи два байта к потоку вывода, чтобы представить значение параметра.
`void`	`writeUTF(String s)` Записи два байта информации о длине к потоку вывода, сопровождаемому измененным представлением UTF-8 каждого символа в строке `s`.

- Деталь метода
  - записать
```
void write(int b)
           throws IOException
```
    Записи к потоку вывода восемь битов младшего разряда параметра b. 24 бита старшего разряда b игнорируются.
    
    Параметры:
    b - байт, который будет записан.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - записать
```
void write(byte[] b)
           throws IOException
```
    Записи к потоку вывода все байты в массиве b. Если b null, a NullPointerException бросается. Если b.length нуль, тогда никакие байты не пишутся. Иначе, байт b[0] пишется сначала, тогда b[1], и так далее; последний записанный байт b[b.length-1].
    
    Параметры:
    b - данные.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - записать
```
void write(byte[] b,
         int off,
         int len)
           throws IOException
```
    Записи len байты от массива b, в порядке, к потоку вывода. Если b null, a NullPointerException бросается. Если off отрицательно, или len отрицательно, или off+len больше чем длина массива b, тогда IndexOutOfBoundsException бросается. Если len нуль, тогда никакие байты не пишутся. Иначе, байт b[off] пишется сначала, тогда b[off+1], и так далее; последний записанный байт b[off+len-1].
    
    Параметры:
    b - данные.
    off - запуск смещается в данных.
    len - число байтов, чтобы записать.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - writeBoolean
```
void writeBoolean(boolean v)
                  throws IOException
```
    Записи a boolean оцените этому потоку вывода. Если параметр v true, значение (byte)1 пишется; если v false, значение (byte)0 пишется. Байт, записанный этим методом, может быть считан readBoolean метод интерфейса DataInput, который тогда возвратит a boolean равный v.
    
    Параметры:
    v - булевская переменная, которая будет записана.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - writeByte
```
void writeByte(int v)
               throws IOException
```
    Записи к потоку вывода восемь младших разрядов - биты параметра v. 24 бита старшего разряда v игнорируются. (Это означает это writeByte делает точно ту же самую вещь как write для целочисленного параметра.) Байт, записанный этим методом, может быть считан readByte метод интерфейса DataInput, который тогда возвратит a byte равный (byte)v.
    
    Параметры:
    v - значение байта, которое будет записано.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - writeShort
```
void writeShort(int v)
                throws IOException
```
    Записи два байта к потоку вывода, чтобы представить значение параметра. Значения байта, которые будут записаны, в показанном порядке:
```
 (byte)(0xff & (v >> 8))
 (byte)(0xff & v)
  
```
    Байты, записанные этим методом, могут быть считаны readShort метод интерфейса DataInput , который тогда возвратит a short равный (short)v.
    Параметры:
    v - short значение, которое будет записано.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - writeChar
```
void writeChar(int v)
               throws IOException
```
    Записи a char значение, которое состоит из двух байтов к потоку вывода. Значения байта, которые будут записаны, в показанном порядке:
```
 (byte)(0xff & (v >> 8))
 (byte)(0xff & v)
 
```
    Байты, записанные этим методом, могут быть считаны readChar метод интерфейса DataInput , который тогда возвратит a char равный (char)v.
    Параметры:
    v - char значение, которое будет записано.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - writeInt
```
void writeInt(int v)
              throws IOException
```
    Записи int значение, которое состоит из четырех байтов к потоку вывода. Значения байта, которые будут записаны, в показанном порядке:
```
 (byte)(0xff & (v >> 24))
 (byte)(0xff & (v >> 16))
 (byte)(0xff & (v >>    8))
 (byte)(0xff & v)
 
```
    Байты, записанные этим методом, могут быть считаны readInt метод интерфейса DataInput , который тогда возвратится int равный v.
    Параметры:
    v - int значение, которое будет записано.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - writeLong
```
void writeLong(long v)
               throws IOException
```
    Записи a long значение, которое состоит из восьми байтов к потоку вывода. Значения байта, которые будут записаны, в показанном порядке:
```
 (byte)(0xff & (v >> 56))
 (byte)(0xff & (v >> 48))
 (byte)(0xff & (v >> 40))
 (byte)(0xff & (v >> 32))
 (byte)(0xff & (v >> 24))
 (byte)(0xff & (v >> 16))
 (byte)(0xff & (v >>  8))
 (byte)(0xff & v)
 
```
    Байты, записанные этим методом, могут быть считаны readLong метод интерфейса DataInput , который тогда возвратит a long равный v.
    Параметры:
    v - long значение, которое будет записано.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - writeFloat
```
void writeFloat(float v)
                throws IOException
```
    Записи a float значение, которое состоит из четырех байтов к потоку вывода. Это делает это, как будто это сначала преобразовывает это float оцените int точно способом Float.floatToIntBits метод и затем пишет int значение точно способом writeInt метод. Байты, записанные этим методом, могут быть считаны readFloat метод интерфейса DataInput, который тогда возвратит a float равный v.
    
    Параметры:
    v - float значение, которое будет записано.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - writeDouble
```
void writeDouble(double v)
                 throws IOException
```
    Записи a double значение, которое состоит из восьми байтов к потоку вывода. Это делает это, как будто это сначала преобразовывает это double оцените a long точно способом Double.doubleToLongBits метод и затем пишет long значение точно способом writeLong метод. Байты, записанные этим методом, могут быть считаны readDouble метод интерфейса DataInput, который тогда возвратит a double равный v.
    
    Параметры:
    v - double значение, которое будет записано.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - writeBytes
```
void writeBytes(String s)
                throws IOException
```
    Пишет строка в поток вывода. Для каждого символа в строке s, взятый в порядке, один байт пишется потоку вывода. Если s null, a NullPointerException бросается.
    Если s.length нуль, тогда никакие байты не пишутся. Иначе, символ s[0] пишется сначала, тогда s[1], и так далее; записанный последний знак s[s.length-1]. Для каждого символа один байт пишется, байт младшего разряда, точно способом writeByte метод. Старший разряд восемь битов каждого символа в строке игнорируется.
    
    Параметры:
    s - строка байтов, которые будут записаны.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - writeChars
```
void writeChars(String s)
                throws IOException
```
    Пишет каждый символ в строке s, к потоку вывода, в порядке, два байта за символ. Если s null, a NullPointerException бросается. Если s.length нуль, тогда никакие символы не пишутся. Иначе, символ s[0] пишется сначала, тогда s[1], и так далее; записанный последний знак s[s.length-1]. Для каждого символа два байта фактически пишутся, байт старшего разряда сначала, точно способом writeChar метод.
    
    Параметры:
    s - строковое значение, которое будет записано.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.
  - writeUTF
```
void writeUTF(String s)
              throws IOException
```
    Записи два байта информации о длине к потоку вывода, сопровождаемому измененным представлением UTF-8 каждого символа в строке s. Если s null, a NullPointerException бросается. Каждый символ в строке s преобразовывается в группу один, два, или три байта, в зависимости от значения символа.
    Если символ c находится в диапазоне \u0001 через \u007f, это представляется на один байт:
```
(byte)c 
```
    Если символ c \u0000 или находится в диапазоне \u0080 через \u07ff, тогда это представляется на два байта, чтобы быть записанным в показанном порядке:
```
 (byte)(0xc0 | (0x1f & (c >> 6)))
 (byte)(0x80 | (0x3f & c))
  
```
    Если символ c находится в диапазоне \u0800 через uffff, тогда это представляется на три байта, чтобы быть записанным в показанном порядке:
```
 (byte)(0xe0 | (0x0f & (c >> 12)))
 (byte)(0x80 | (0x3f & (c >>  6)))
 (byte)(0x80 | (0x3f & c))
  
```
    Во-первых, общее количество байтов должно было представить все символы s вычисляется. Если это число больше чем 65535, тогда a UTFDataFormatException бросается. Иначе, эта длина пишется потоку вывода точно способом writeShort метод; после этого один - два - или трехбайтовое представление каждого символа в строке s пишется.
    Байты, записанные этим методом, могут быть считаны readUTF метод интерфейса DataInput , который тогда возвратит a String равный s.
    Параметры:
    s - строковое значение, которое будет записано.
    
    Броски:
    
    IOException - если ошибка ввода-вывода происходит.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный DataOutput

Сводка метода

Деталь метода

записать

записать

записать

writeBoolean

writeByte

writeShort

writeChar

writeInt

writeLong

writeFloat

writeDouble

writeBytes

writeChars

writeUTF