Писатель (Платформа Java SE 8 b92)

java.lang. Объект
- java.io. Писатель

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

Closeable, Flushable, Appendable, AutoCloseable

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

BufferedWriter, CharArrayWriter, FilterWriter, OutputStreamWriter, PipedWriter, PrintWriter, StringWriter
```
public abstract class Writer
extends Object
implements Appendable, Closeable, Flushable
```
Абстрактный class для того, чтобы записать в символьные потоки. Единственные методы, которые должен реализовать подкласс, являются записью (случайная работа [], интервал, интервал), сброс (), и близко (). Большинство подклассов, однако, переопределит некоторые из методов, определенных здесь, чтобы обеспечить более высокую эффективность, дополнительную функциональность, или обоих.

С тех пор:

JDK1.1

См. Также:

Writer, BufferedWriter, CharArrayWriter, FilterWriter, OutputStreamWriter, FileWriter, PipedWriter, PrintWriter, StringWriter, Reader

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

Поля
Модификатор и Тип	Поле и Описание
`protected Object`	`блокировка` Объект, используемый, чтобы синхронизировать операции на этом потоке.

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

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`Writer()` Создает нового символьно-потокового писателя, критические разделы которого будут синхронизироваться на писателе непосредственно.
`protected`	`Writer(Object lock)` Создает нового символьно-потокового писателя, критические разделы которого будут синхронизироваться на данном объекте.

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

Все Методы Методы экземпляра Абстрактные Методы Конкретные Методы
Модификатор и Тип	Метод и Описание
`Писатель`	`append(char c)` Добавляет указанный символ этому писателю.
`Писатель`	`append(CharSequence csq)` Добавляет указанную символьную последовательность этому писателю.
`Писатель`	`append(CharSequence csq, int start, int end)` Добавляет подпоследовательность указанной символьной последовательности этому писателю.
`abstract void`	`close()` Закрывает поток, сбрасывая это сначала.
`abstract void`	`flush()` Сбрасывает поток.
`void`	`write(char[] cbuf)` Пишет массив символов.
`abstract void`	`write(char[] cbuf, int off, int len)` Пишет часть массива символов.
`void`	`write(int c)` Пишет единственный символ.
`void`	`write(String str)` Пишет строка.
`void`	`write(String str, int off, int len)` Пишет часть строки.

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - блокировка
```
protected Object lock
```
    Объект, используемый, чтобы синхронизировать операции на этом потоке. Для эффективности символьный потоковый объект может использовать объект кроме себя, чтобы защитить критические разделы. Подкласс должен поэтому использовать объект в этом поле, а не this или синхронизируемом методе.
- Деталь конструктора
  - Писатель
```
protected Writer()
```
    Создает нового символьно-потокового писателя, критические разделы которого будут синхронизироваться на писателе непосредственно.
  - Писатель
```
protected Writer(Object lock)
```
    Создает нового символьно-потокового писателя, критические разделы которого будут синхронизироваться на данном объекте.
    
    Параметры:
    
    lock - Объект синхронизироваться на
- Деталь метода
  - записать
```
public void write(int c)
           throws IOException
```
    Пишет единственный символ. Символ, который будет записан, содержится в 16 битах младшего разряда данного целочисленного значения; 16 битов старшего разряда игнорируются.
    Подклассы, которые намереваются поддерживать эффективный одно-символьный вывод, должны переопределить этот метод.
    
    Параметры:
    
    c - интервал, определяющий символ, который будет записан
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит
  - записать
```
public void write(char[] cbuf)
           throws IOException
```
    Пишет массив символов.
    
    Параметры:
    
    cbuf - Массив символов, которые будут записаны
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит
  - записать
```
public abstract void write(char[] cbuf,
                           int off,
                           int len)
                    throws IOException
```
    Пишет часть массива символов.
    
    Параметры:
    
    cbuf - Массив символов
    
    off - Смещение, из которого можно начать писать символы
    
    len - Число символов, чтобы записать
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит
  - записать
```
public void write(String str)
           throws IOException
```
    Пишет строка.
    
    Параметры:
    
    str - Строка, которая будет записана
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит
  - записать
```
public void write(String str,
                  int off,
                  int len)
           throws IOException
```
    Пишет часть строки.
    
    Параметры:
    
    str - Строка
    
    off - Смещение, из которого можно начать писать символы
    
    len - Число символов, чтобы записать
    
    Броски:
    
    IndexOutOfBoundsException - Если off отрицателен, или len отрицателен, или off+len отрицателен или больше чем длина данной строки
    
    IOException - Если ошибка ввода-вывода происходит
  - добавить
```
public Writer append(CharSequence csq)
              throws IOException
```
    Добавляет указанную символьную последовательность этому писателю.
    Вызов этого метода формы out.append(csq) ведет себя точно таким же образом как вызов
```
     out.write(csq.toString()) 
```
    В зависимости от спецификации toString для символьной последовательности csq не может быть добавлена вся последовательность. Например, вызов метода toString символьного буфера возвратит подпоследовательность, контент которой зависит от позиции буфера и предела.
    Определенный:
    
    append в интерфейсе Appendable
    
    Параметры:
    
    csq - Символьная последовательность, чтобы добавить. Если csq является null, то эти четыре символа "null" добавляются этому писателю.
    
    Возвраты:
    
    Этот писатель
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит
    
    С тех пор:
    
    1.5
  - добавить
```
public Writer append(CharSequence csq,
                     int start,
                     int end)
              throws IOException
```
    Добавляет подпоследовательность указанной символьной последовательности этому писателю. Appendable.
    Вызов этого метода формы out.append(csq, start, end), когда csq не является null, ведет себя точно таким же образом как вызов
```
     out.write(csq.subSequence(start, end).toString()) 
```
    Определенный:
    
    append в интерфейсе Appendable
    
    Параметры:
    
    csq - Символьная последовательность, от которой будет добавлена подпоследовательность. Если csq будет null, то символы будут добавлены как будто csq, содержавший эти четыре символа "null".
    
    start - Индексирование первого символа в подпоследовательности
    
    end - Индексирование символа после последнего знака в подпоследовательности
    
    Возвраты:
    
    Этот писатель
    
    Броски:
    
    IndexOutOfBoundsException - Если start или end отрицательны, start больше чем end, или end больше чем csq.length()
    
    IOException - Если ошибка ввода-вывода происходит
    
    С тех пор:
    
    1.5
  - добавить
```
public Writer append(char c)
              throws IOException
```
    Добавляет указанный символ этому писателю.
    Вызов этого метода формы out.append(c) ведет себя точно таким же образом как вызов
```
     out.write(c) 
```
    Определенный:
    
    append в интерфейсе Appendable
    
    Параметры:
    
    c - 16-разрядный символ, чтобы добавить
    
    Возвраты:
    
    Этот писатель
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит
    
    С тех пор:
    
    1.5
  - сброс
```
public abstract void flush()
                    throws IOException
```
    Сбрасывает поток. Если поток сохранил какие-либо символы от различной записи () методы в буфере, запишите им сразу в их намеченное место назначения. Затем, если то место назначения является другим символьным или потоком байтов, сбросьте его. Таким образом один сброс () вызов сбросит все буферы в цепочке Писателей и OutputStreams.
    Если намеченное место назначения этого потока будет абстракцией, обеспеченной базовой операционной системой, например файл, то сбрасывание потока гарантирует только, что байты, ранее записанные потоку, передают к операционной системе для того, чтобы записать; это не гарантирует, что они фактически пишутся физическому устройству, такому как дисковод.
    
    Определенный:
    
    flush в интерфейсе Flushable
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит
  - близко
```
public abstract void close()
                    throws IOException
```
    Закрывает поток, сбрасывая это сначала. Как только поток был закрыт, далее запишите () или сброс (), вызовы заставят IOException быть брошенным. Закрытие ранее закрытого потока не имеет никакого эффекта.
    
    Определенный:
    
    close в интерфейсе Closeable
    
    Определенный:
    
    close в интерфейсе AutoCloseable
    
    Броски:
    
    IOException - Если ошибка ввода-вывода происходит

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

Писатель класса

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

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

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

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

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

блокировка

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

Писатель

Писатель

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

записать

записать

записать

записать

записать

добавить

добавить

добавить

сброс

близко