Spec-Zone .ru
спецификации, руководства, описания, API
|
public class OutputStreamWriter extends Writer
charset
. Набор символов, который это использует, может быть определен по имени или может быть дан явно, или набор символов значения по умолчанию платформы может быть принят. Каждый вызов записи () метод заставляет преобразователь кодирования быть вызванным на данный символ (ы). Получающиеся байты накапливаются в буфере прежде, чем быть записанным в базовый поток вывода. Размер этого буфера может быть определен, но по умолчанию это является достаточно большим в большинстве целей. Отметьте, что символы, которые передают к записи () методы, не буферизуются.
Для главной эффективности рассмотрите обертывание OutputStreamWriter в пределах BufferedWriter, чтобы избежать частых вызовов преобразователя. Например:
Writer out = new BufferedWriter(new OutputStreamWriter(System.out));
Суррогатная пара является символом, представленным последовательностью двух значений char: высокий заместитель в диапазоне '\uD800' к '\uDBFF', сопровождаемому низким заместителем в диапазоне '\uDC00' к '\uDFFF'.
Уродливый суррогатный элемент является высоким заместителем, который не сопровождается низким заместителем или низким заместителем, которому не предшествует высокий заместитель.
Этот class всегда заменяет уродливые суррогатные элементы и неотображаемые символьные последовательности с последовательностью замены значения по умолчанию набора символов. class CharsetEncoder должен использоваться, когда больше управления процессом кодирования требуется.
BufferedWriter
, OutputStream
, Charset
блокировка
Конструктор и Описание |
---|
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)
Пишет часть строки.
|
public OutputStreamWriter(OutputStream out, String charsetName) throws UnsupportedEncodingException
out
- OutputStreamcharsetName
- Имя поддерживаемого
набор символов
UnsupportedEncodingException
- Если именованное кодирование не поддерживаетсяpublic OutputStreamWriter(OutputStream out)
out
- OutputStreampublic OutputStreamWriter(OutputStream out, Charset cs)
out
- OutputStreamcs
- Набор символовpublic OutputStreamWriter(OutputStream out, CharsetEncoder enc)
out
- OutputStreamenc
- Кодер набора символовpublic String getEncoding()
Если у кодирования есть историческое имя тогда, что имя возвращается; иначе каноническое имя кодирования возвращается.
Если этот экземпляр создавался с OutputStreamWriter(OutputStream, String)
конструктор тогда возвращенное имя, будучи уникальным для кодирования, может отличаться от имени, которое передают конструктору. Этот метод может возвратить null, если поток был закрыт.
null
если поток был закрытCharset
public void write(int c) throws IOException
write
в class Writer
c
- интервал, определяющий символ, который будет записанIOException
- Если ошибка ввода-вывода происходитpublic void write(char[] cbuf, int off, int len) throws IOException
write
в class Writer
cbuf
- Буфер символовoff
- Смещение, из которого можно начать писать символыlen
- Число символов, чтобы записатьIOException
- Если ошибка ввода-вывода происходитpublic void write(String str, int off, int len) throws IOException
write
в class Writer
str
- Строкаoff
- Смещение, из которого можно начать писать символыlen
- Число символов, чтобы записатьIOException
- Если ошибка ввода-вывода происходитpublic void flush() throws IOException
flush
в интерфейсе Flushable
flush
в class Writer
IOException
- Если ошибка ввода-вывода происходитpublic void close() throws IOException
Writer
close
в интерфейсе Closeable
close
в интерфейсе AutoCloseable
close
в class Writer
IOException
- Если ошибка ввода-вывода происходит
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92