java.io

Класс OutputStreamWriter

java.lang. Объект

java.io. Писатель

java.io. OutputStreamWriter

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

Closeable, Flushable, Appendable, AutoCloseable

Прямые Известные Подклассы:

FileWriter

public class OutputStreamWriter
extends Writer

OutputStreamWriter является мостом от символьных потоков до потоков байтов: Символы, записанные этому, кодируются в байты, используя указанное charset. Набор символов, который это использует, может быть определен по имени или может быть дан явно, или набор символов платформы по умолчанию может быть принят.

Каждый вызов записи () метод заставляет преобразователь кодирования быть вызванным на данный символ (ы). Получающиеся байты накапливаются в буфере прежде, чем быть записанным в базовый поток вывода. Размер этого буфера может быть определен, но по умолчанию это является достаточно большим в большинстве целей. Отметьте, что символы, которые передают к записи () методы, не буферизуются.

Для главной эффективности рассмотрите обертывание OutputStreamWriter в пределах BufferedWriter, чтобы избежать частых вызовов преобразователя. Например:

 Writer out
   = new BufferedWriter(new OutputStreamWriter(System.out));
 

Суррогатная пара является символом, представленным последовательностью двух значений char: высокий заместитель в диапазоне '\uD800' к '\uDBFF', сопровождаемому низким заместителем в диапазоне '\uDC00' к '\uDFFF'.

Уродливый суррогатный элемент является высоким заместителем, который не сопровождается низким заместителем или низким заместителем, которому не предшествует высокий заместитель.

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

С тех пор:

JDK1.1

См. Также:

BufferedWriter, OutputStream, Charset

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

Поля java.io унаследованный от класса. Писатель

блокировка

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

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

Конструктор и Описание
OutputStreamWriter(OutputStream out) Создает OutputStreamWriter, который использует кодировку символов по умолчанию.
OutputStreamWriter(OutputStream out, Charset cs) Создает OutputStreamWriter, который использует данный набор символов.
OutputStreamWriter(OutputStream out, CharsetEncoder enc) Создает OutputStreamWriter, который использует данный кодер набора символов.
OutputStreamWriter(OutputStream out, String charsetName) Создает OutputStreamWriter, который использует именованный набор символов.

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

Методы

Модификатор и Тип	Метод и Описание
void	close() Закрывает поток, сбрасывая это сначала.
void	flush() Сбрасывает поток.
Строка	getEncoding() Возвращает имя кодировки символов, используемой этим потоком.
void	write(char[] cbuf, int off, int len) Пишет часть массива символов.
void	write(int c) Пишет единственный символ.
void	write(String str, int off, int len) Пишет часть строки.

Методы java.io унаследованный от класса. Писатель

append, append, append, write, write

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

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

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

OutputStreamWriter

public OutputStreamWriter(OutputStream out,
                  String charsetName)
                   throws UnsupportedEncodingException

Создает OutputStreamWriter, который использует именованный набор символов.

Параметры:

out - OutputStream

charsetName - Имя поддерживаемого набор символов

Броски:

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

OutputStreamWriter

public OutputStreamWriter(OutputStream out)

Создает OutputStreamWriter, который использует кодировку символов по умолчанию.

Параметры:

out - OutputStream

OutputStreamWriter

public OutputStreamWriter(OutputStream out,
                  Charset cs)

Создает OutputStreamWriter, который использует данный набор символов.

Параметры:

out - OutputStream

cs - Набор символов

С тех пор:

1.4

OutputStreamWriter

public OutputStreamWriter(OutputStream out,
                  CharsetEncoder enc)

Создает OutputStreamWriter, который использует данный кодер набора символов.

Параметры:

out - OutputStream

enc - Кодер набора символов

С тех пор:

1.4

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

getEncoding

public String getEncoding()

Возвращает имя кодировки символов, используемой этим потоком.

Если у кодирования есть историческое имя тогда, что имя возвращается; иначе каноническое имя кодирования возвращается.

Если этот экземпляр создавался с OutputStreamWriter(OutputStream, String) конструктор тогда возвращенное имя, будучи уникальным для кодирования, может отличаться от имени, которое передают конструктору. Этот метод может возвратить null, если поток был закрыт.

Возвраты:

Историческое имя этого кодирования, или возможно null если поток был закрыт

См. Также:

Charset

записать

public void write(int c)
           throws IOException

Пишет единственный символ.

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

write в классе Writer

Параметры:

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

Броски:

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

записать

public void write(char[] cbuf,
         int off,
         int len)
           throws IOException

Пишет часть массива символов.

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

write в классе Writer

Параметры:

cbuf - Буфер символов

off - Смещение, из которого можно начать писать символы

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

Броски:

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

записать

public void write(String str,
         int off,
         int len)
           throws IOException

Пишет часть строки.

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

write в классе Writer

Параметры:

str - Строка

off - Смещение, из которого можно начать писать символы

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

Броски:

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

сброс

public void flush()
           throws IOException

Сбрасывает поток.

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

flush в интерфейсе Flushable

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

flush в классе Writer

Броски:

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

близко

public void close()
           throws IOException

Описание скопировало с класса: Writer

Закрывает поток, сбрасывая это сначала. Как только поток был закрыт, далее запишите () или сброс (), вызовы заставят IOException быть брошенным. Закрытие ранее закрытого потока не имеет никакого эффекта.

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

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

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

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

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

close в классе Writer

Броски:

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