compact1, compact2, compact3

java.io

Класс ByteArrayOutputStream

java.lang. Объект

java.io. OutputStream

java.io. ByteArrayOutputStream

Все Реализованные Интерфейсы:

Closeable, Flushable, AutoCloseable

public class ByteArrayOutputStream
extends OutputStream

Этот class реализует поток вывода, в котором данные пишутся в байтовый массив. Буфер автоматически растет, поскольку данные пишутся ему. Данные могут быть получены, используя toByteArray() и toString().

Закрытие ByteArrayOutputStream не имеет никакого эффекта. Методы в этом class можно вызвать после того, как поток был закрыт, не генерируя IOException.

С тех пор:

JDK1.0

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected byte[]	buf Буфер, где данные хранятся.
protected int	количество Число допустимых байтов в буфере.

Сводка конструктора

Конструкторы

Конструктор и Описание
ByteArrayOutputStream() Создает новый поток вывода байтового массива.
ByteArrayOutputStream(int size) Создает новый поток вывода байтового массива, с буферностью указанного размера, в байтах.

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

Модификатор и Тип	Метод и Описание
void	close() Закрытие ByteArrayOutputStream не имеет никакого эффекта.
void	reset() Сбросы count поле этого потока вывода байтового массива, чтобы обнулить, так, чтобы весь в настоящий момент накопленный вывод в потоке вывода был отброшен.
int	size() Возвращает текущий размер буфера.
byte[]	toByteArray() Создает недавно выделенный байтовый массив.
Строка	toString() Преобразовывает содержание буфера в строку, декодирующую байты, используя набор символов значения по умолчанию платформы.
Строка	toString(int hibyte) Осуждаемый. Этот метод должным образом не преобразовывает байты в символы. С JDK 1.1, привилегированный способ сделать это через toString(String enc) метод, который берет параметр имени кодирования, или toString() метод, который использует кодировку символов значения по умолчанию платформы.
Строка	toString(String charsetName) Преобразовывает содержание буфера в строку, декодируя байты, используя именованное charset.
void	write(byte[] b, int off, int len) Записи len байты от указанного байтового массива, запускающегося при смещении off к этому потоку вывода байтового массива.
void	write(int b) Пишет указанный байт в этот поток вывода байтового массива.
void	writeTo(OutputStream out) Пишет полное содержание этого потока вывода байтового массива к указанному параметру потока вывода, как будто, вызывая использование метода записи потока вывода out.write(buf, 0, count).

Методы, наследованные от class java.io. OutputStream

flush, write

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Полевая Деталь

buf

protected byte[] buf

Буфер, где данные хранятся.

количество

protected int count

Число допустимых байтов в буфере.

Деталь конструктора

ByteArrayOutputStream

public ByteArrayOutputStream()

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

ByteArrayOutputStream

public ByteArrayOutputStream(int size)

Создает новый поток вывода байтового массива, с буферностью указанного размера, в байтах.

Параметры:

size - начальный размер.

Броски:

IllegalArgumentException - если размер отрицателен.

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

записать

public void write(int b)

Пишет указанный байт в этот поток вывода байтового массива.

Определенный:

write в class OutputStream

Параметры:

b - байт, который будет записан.

записать

public void write(byte[] b,
                  int off,
                  int len)

Записи len байты от указанного байтового массива, запускающегося при смещении off к этому потоку вывода байтового массива.

Переопределения:

write в class OutputStream

Параметры:

b - данные.

off - запуск смещается в данных.

len - число байтов, чтобы записать.

writeTo

public void writeTo(OutputStream out)
             throws IOException

Пишет полное содержание этого потока вывода байтового массива к указанному параметру потока вывода, как будто, вызывая использование метода записи потока вывода out.write(buf, 0, count).

Параметры:

out - поток вывода, в который можно записать данные.

Броски:

IOException - если ошибка ввода-вывода происходит.

сброс

public void reset()

Сбросы count поле этого потока вывода байтового массива, чтобы обнулить, так, чтобы весь в настоящий момент накопленный вывод в потоке вывода был отброшен. Поток вывода может использоваться снова, снова используя уже выделенное пространство буфера.

См. Также:

ByteArrayInputStream.count

toByteArray

public byte[] toByteArray()

Создает недавно выделенный байтовый массив. Его размер является текущим размером этого потока вывода, и допустимое содержание буфера было скопировано в это.

Возвраты:

текущее содержание этого потока вывода, как байтовый массив.

См. Также:

size()

размер

public int size()

Возвращает текущий размер буфера.

Возвраты:

значение count поле, которое является числом допустимых байтов в этом потоке вывода.

См. Также:

count

toString

public String toString()

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

Этот метод всегда заменяет уродливый ввод и неотображаемо-символьные последовательности с заменяющей строкой значения по умолчанию для набора символов значения по умолчанию платформы. class CharsetDecoder должен использоваться, когда больше управления процессом декодирования требуется.

Переопределения:

toString в class Object

Возвраты:

Строка декодируется от содержания буфера.

С тех пор:

JDK1.1

toString

public String toString(String charsetName)
                throws UnsupportedEncodingException

Преобразовывает содержание буфера в строку, декодируя байты, используя именованное charset. Длина нового String является функцией набора символов, и следовательно, возможно, не равна длине байтового массива.

Этот метод всегда заменяет уродливый ввод и неотображаемо-символьные последовательности с заменяющей строкой значения по умолчанию этого набора символов. CharsetDecoder class должен использоваться, когда больше управления процессом декодирования требуется.

Параметры:

charsetName - имя поддерживаемого charset

Возвраты:

Строка декодируется от содержания буфера.

Броски:

UnsupportedEncodingException - Если именованный набор символов не поддерживается

С тех пор:

JDK1.1

toString

@Deprecated
public String toString(int hibyte)

Осуждаемый. Этот метод должным образом не преобразовывает байты в символы. С JDK 1.1, привилегированный способ сделать это через toString(String enc) метод, который берет параметр имени кодирования, или toString() метод, который использует кодировку символов значения по умолчанию платформы.

Создает недавно выделенную строку. Его размер является текущим размером потока вывода, и допустимое содержание буфера было скопировано в это. Каждый символ c в получающейся строке создается из соответствующего элемента b в байтовом массиве так, что:

     c == (char)(((hibyte & 0xff) << 8) | (b & 0xff))
 

Параметры:

hibyte - высокий байт каждого получающегося символа Unicode.

Возвраты:

текущее содержание потока вывода, как строка.

См. Также:

size(), toString(String), toString()

близко

public void close()
           throws IOException

Закрытие ByteArrayOutputStream не имеет никакого эффекта. Методы в этом class можно вызвать после того, как поток был закрыт, не генерируя IOException.

Определенный:

close в интерфейсе Closeable

Определенный:

close в интерфейсе AutoCloseable

Переопределения:

close в class OutputStream

Броски:

IOException - если ошибка ввода-вывода происходит.