compact1, compact2, compact3

java.io

Класс PrintWriter

java.lang. Объект

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

java.io. PrintWriter

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

Closeable, Flushable, Appendable, AutoCloseable

public class PrintWriter
extends Writer

Печатные издания отформатированные представления объектов к текстовому потоку вывода. Этот class реализует все методы print, найденные в PrintStream. Это не содержит методы для того, чтобы записать необработанные байты, для которых программа должна использовать незакодированные потоки байтов.

В отличие от этого PrintStream class, если автоматическому сбрасыванию включают, оно будет сделано только, когда один из println, printf, или методов format будет вызван, а не всякий раз, когда символ новой строки, оказывается, выводится. Эти методы используют собственное понятие платформы разделителя строки, а не символа новой строки.

Методы в этом class никогда не выдают исключения ввода-вывода, хотя некоторые из его конструкторов могут. Клиент может запросить относительно того, произошли ли какие-либо ошибки, вызывая checkError().

С тех пор:

JDK1.1

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

Поля

Модификатор и Тип	Поле и Описание
protected Writer	Базовый поток вывода символов этого PrintWriter.

Поля, наследованные от class java.io. Писатель

блокировка

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

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

Конструктор и Описание
PrintWriter(File file) Создает новый PrintWriter, без автоматического сбрасывания строки, с указанным файлом.
PrintWriter(File file, String csn) Создает новый PrintWriter, без автоматического сбрасывания строки, с указанным файлом и набором символов.
PrintWriter(OutputStream out) Создает новый PrintWriter, без автоматического сбрасывания строки, от существующего OutputStream.
PrintWriter(OutputStream out, boolean autoFlush) Создает новый PrintWriter из существующего OutputStream.
PrintWriter(String fileName) Создает новый PrintWriter, без автоматического сбрасывания строки, с указанным именем файла.
PrintWriter(String fileName, String csn) Создает новый PrintWriter, без автоматического сбрасывания строки, с указанным именем файла и набором символов.
PrintWriter(Writer out) Создает новый PrintWriter, без автоматического сбрасывания строки.
PrintWriter(Writer out, boolean autoFlush) Создает новый PrintWriter.

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

Модификатор и Тип	Метод и Описание
PrintWriter	append(char c) Добавляет указанный символ этому писателю.
PrintWriter	append(CharSequence csq) Добавляет указанную символьную последовательность этому писателю.
PrintWriter	append(CharSequence csq, int start, int end) Добавляет подпоследовательность указанной символьной последовательности этому писателю.
boolean	checkError() Сбрасывает поток, если он не закрывается и проверяет свое ошибочное состояние.
protected void	clearError() Очищает ошибочное состояние этого потока.
void	close() Закрывает поток и выпускает любые системные ресурсы, связанные с этим.
void	flush() Сбрасывает поток.
PrintWriter	format(Locale l, String format, Object... args) Пишет отформатированная строка в этого писателя, использующего указанную строку формата и параметры.
PrintWriter	format(String format, Object... args) Пишет отформатированная строка в этого писателя, использующего указанную строку формата и параметры.
void	print(boolean b) Печатает булево значение.
void	print(char c) Печатает символ.
void	print(char[] s) Печатает массив символов.
void	print(double d) Печатает двойную точность число с плавающей точкой.
void	print(float f) Печатает число с плавающей точкой.
void	print(int i) Печатает целое число.
void	print(long l) Печатает длинное целое.
void	print(Object obj) Печатает объект.
void	print(String s) Печатает строку.
PrintWriter	printf(Locale l, String format, Object... args) Метод удобства, чтобы записать отформатированную строку этому писателю, использующему указанную строку формата и параметры.
PrintWriter	printf(String format, Object... args) Метод удобства, чтобы записать отформатированную строку этому писателю, использующему указанную строку формата и параметры.
void	println() Завершает текущую строку при записи строки разделителя строки.
void	println(boolean x) Печатает булево значение и затем завершает строку.
void	println(char x) Печатает символ и затем завершает строку.
void	println(char[] x) Печатает массив символов и затем завершает строку.
void	println(double x) Печатает двойную точность число с плавающей точкой и затем завершает строку.
void	println(float x) Печатает число с плавающей точкой и затем завершает строку.
void	println(int x) Печатает целое число и затем завершает строку.
void	println(long x) Печатает длинное целое и затем завершает строку.
void	println(Object x) Печатает Объект и затем завершает строку.
void	println(String x) Печатает Строку и затем завершает строку.
protected void	setError() Указывает, что ошибка произошла.
void	write(char[] buf) Пишет массив символов.
void	write(char[] buf, int off, int len) Пишет Часть массива символов.
void	write(int c) Пишет единственный символ.
void	write(String s) Пишет строка.
void	write(String s, int off, int len) Пишет часть строки.

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

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

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

protected Writer out

Базовый поток вывода символов этого PrintWriter.

С тех пор:

1.2

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

PrintWriter

public PrintWriter(Writer out)

Создает новый PrintWriter, без автоматического сбрасывания строки.

Параметры:

out - Поток вывода символов

PrintWriter

public PrintWriter(Writer out,
                   boolean autoFlush)

Создает новый PrintWriter.

Параметры:

out - Поток вывода символов

autoFlush - Булево; если это правда, println, printf, или методы format сбросят буфер вывода

PrintWriter

public PrintWriter(OutputStream out)

Создает новый PrintWriter, без автоматического сбрасывания строки, от существующего OutputStream. Этот конструктор удобства создает необходимый промежуточный OutputStreamWriter, который преобразует символы в байты, используя кодировку символов значения по умолчанию.

Параметры:

out - Поток вывода

См. Также:

OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)

PrintWriter

public PrintWriter(OutputStream out,
                   boolean autoFlush)

Создает новый PrintWriter из существующего OutputStream. Этот конструктор удобства создает необходимый промежуточный OutputStreamWriter, который преобразует символы в байты, используя кодировку символов значения по умолчанию.

Параметры:

out - Поток вывода

autoFlush - Булево; если это правда, println, printf, или методы format сбросят буфер вывода

См. Также:

OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)

PrintWriter

public PrintWriter(String fileName)
            throws FileNotFoundException

Создает новый PrintWriter, без автоматического сбрасывания строки, с указанным именем файла. Этот конструктор удобства создает необходимое промежуточное звено OutputStreamWriter, который закодирует символы, используя набор символов значения по умолчанию для этого экземпляра виртуальной машины Java.

Параметры:

fileName - Имя файла, чтобы использовать в качестве места назначения этого писателя. Если файл будет существовать тогда, то это будет усеченным, чтобы обнулить размер; иначе, новый файл будет создаваться. Вывод будет записан файлу и буферизуется.

Броски:

FileNotFoundException - Если данная строка не обозначает существующий, перезаписываемый регулярный файл, и новый регулярный файл того имени не может быть создан, или если некоторая другая ошибка происходит, открываясь или создавая файл

SecurityException - Если менеджер безопасности присутствует и checkWrite(fileName) отрицает доступ для записи к файлу

С тех пор:

1.5

PrintWriter

public PrintWriter(String fileName,
                   String csn)
            throws FileNotFoundException,
                   UnsupportedEncodingException

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

Параметры:

fileName - Имя файла, чтобы использовать в качестве места назначения этого писателя. Если файл будет существовать тогда, то это будет усеченным, чтобы обнулить размер; иначе, новый файл будет создаваться. Вывод будет записан файлу и буферизуется.

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

Броски:

FileNotFoundException - Если данная строка не обозначает существующий, перезаписываемый регулярный файл, и новый регулярный файл того имени не может быть создан, или если некоторая другая ошибка происходит, открываясь или создавая файл

SecurityException - Если менеджер безопасности присутствует и checkWrite(fileName) отрицает доступ для записи к файлу

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

С тех пор:

1.5

PrintWriter

public PrintWriter(File file)
            throws FileNotFoundException

Создает новый PrintWriter, без автоматического сбрасывания строки, с указанным файлом. Этот конструктор удобства создает необходимое промежуточное звено OutputStreamWriter, который закодирует символы, используя набор символов значения по умолчанию для этого экземпляра виртуальной машины Java.

Параметры:

file - Файл, чтобы использовать в качестве места назначения этого писателя. Если файл будет существовать тогда, то это будет усеченным, чтобы обнулить размер; иначе, новый файл будет создаваться. Вывод будет записан файлу и буферизуется.

Броски:

FileNotFoundException - Если данный объект файла не обозначает существующий, перезаписываемый регулярный файл, и новый регулярный файл того имени не может быть создан, или если некоторая другая ошибка происходит, открываясь или создавая файл

SecurityException - Если менеджер безопасности присутствует и checkWrite(file.getPath()) отрицает доступ для записи к файлу

С тех пор:

1.5

PrintWriter

public PrintWriter(File file,
                   String csn)
            throws FileNotFoundException,
                   UnsupportedEncodingException

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

Параметры:

file - Файл, чтобы использовать в качестве места назначения этого писателя. Если файл будет существовать тогда, то это будет усеченным, чтобы обнулить размер; иначе, новый файл будет создаваться. Вывод будет записан файлу и буферизуется.

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

Броски:

FileNotFoundException - Если данный объект файла не обозначает существующий, перезаписываемый регулярный файл, и новый регулярный файл того имени не может быть создан, или если некоторая другая ошибка происходит, открываясь или создавая файл

SecurityException - Если менеджер безопасности присутствует и checkWrite(file.getPath()) отрицает доступ для записи к файлу

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

С тех пор:

1.5

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

сброс

public void flush()

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

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

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

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

flush в class Writer

См. Также:

checkError()

близко

public void close()

Закрывает поток и выпускает любые системные ресурсы, связанные с этим. Закрытие ранее закрытого потока не имеет никакого эффекта.

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

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

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

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

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

close в class Writer

См. Также:

checkError()

checkError

public boolean checkError()

Сбрасывает поток, если он не закрывается и проверяет свое ошибочное состояние.

Возвраты:

true если поток печати встретился с ошибкой, или на базовом потоке вывода или во время преобразования формата.

setError

protected void setError()

Указывает, что ошибка произошла.

Этот метод вызовет последующие вызовы checkError() не возвратить true до clearError() вызывается.

clearError

protected void clearError()

Очищает ошибочное состояние этого потока.

Этот метод вызовет последующие вызовы checkError() чтобы возвратить false до, другая операция записи приводит к сбою и вызывает setError().

С тех пор:

1.6

записать

public void write(int c)

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

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

write в class Writer

Параметры:

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

записать

public void write(char[] buf,
                  int off,
                  int len)

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

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

write в class Writer

Параметры:

buf - Массив символов

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

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

записать

public void write(char[] buf)

Пишет массив символов. Этот метод не может быть наследован от Писателя class, потому что это должно подавить исключения ввода-вывода.

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

write в class Writer

Параметры:

buf - Массив символов, которые будут записаны

записать

public void write(String s,
                  int off,
                  int len)

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

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

write в class Writer

Параметры:

s - Строка

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

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

записать

public void write(String s)

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

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

write в class Writer

Параметры:

s - Строка, которая будет записана

печать

public void print(boolean b)

Печатает булево значение. Строка, произведенная String.valueOf(boolean) преобразовывается в байты согласно кодировке символов значения по умолчанию платформы, и эти байты пишутся точно способом write(int) метод.

Параметры:

b - boolean быть напечатанным

печать

public void print(char c)

Печатает символ. Символ преобразовывается в один или более байтов согласно кодировке символов значения по умолчанию платформы, и эти байты пишутся точно способом write(int) метод.

Параметры:

c - char быть напечатанным

печать

public void print(int i)

Печатает целое число. Строка, произведенная String.valueOf(int) преобразовывается в байты согласно кодировке символов значения по умолчанию платформы, и эти байты пишутся точно способом write(int) метод.

Параметры:

i - int быть напечатанным

См. Также:

Integer.toString(int)

печать

public void print(long l)

Печатает длинное целое. Строка, произведенная String.valueOf(long) преобразовывается в байты согласно кодировке символов значения по умолчанию платформы, и эти байты пишутся точно способом write(int) метод.

Параметры:

l - long быть напечатанным

См. Также:

Long.toString(long)

печать

public void print(float f)

Печатает число с плавающей точкой. Строка, произведенная String.valueOf(float) преобразовывается в байты согласно кодировке символов значения по умолчанию платформы, и эти байты пишутся точно способом write(int) метод.

Параметры:

f - float быть напечатанным

См. Также:

Float.toString(float)

печать

public void print(double d)

Печатает двойную точность число с плавающей точкой. Строка, произведенная String.valueOf(double) преобразовывается в байты согласно кодировке символов значения по умолчанию платформы, и эти байты пишутся точно способом write(int) метод.

Параметры:

d - double быть напечатанным

См. Также:

Double.toString(double)

печать

public void print(char[] s)

Печатает массив символов. Символы преобразовываются в байты согласно кодировке символов значения по умолчанию платформы, и эти байты пишутся точно способом write(int) метод.

Параметры:

s - Массив случайных работ, которые будут напечатаны

Броски:

NullPointerException - Если s null

печать

public void print(String s)

Печатает строку. Если параметр null тогда строка "null" печатается. Иначе, символы строки преобразовываются в байты согласно кодировке символов значения по умолчанию платформы, и эти байты пишутся точно способом write(int) метод.

Параметры:

s - String быть напечатанным

печать

public void print(Object obj)

Печатает объект. Строка, произведенная String.valueOf(Object) метод преобразовывается в байты согласно кодировке символов значения по умолчанию платформы, и эти байты пишутся точно способом write(int) метод.

Параметры:

obj - Object быть напечатанным

См. Также:

Object.toString()

println

public void println()

Завершает текущую строку при записи строки разделителя строки. Строка разделителя строки определяется системным свойством line.separator, и не обязательно единственный символ новой строки ('\n').

println

public void println(boolean x)

Печатает булево значение и затем завершает строку. Этот метод ведет себя, как если бы он вызывает print(boolean) и затем println().

Параметры:

x - boolean значение, которое будет напечатано

println

public void println(char x)

Печатает символ и затем завершает строку. Этот метод ведет себя, как если бы он вызывает print(char) и затем println().

Параметры:

x - char значение, которое будет напечатано

println

public void println(int x)

Печатает целое число и затем завершает строку. Этот метод ведет себя, как если бы он вызывает print(int) и затем println().

Параметры:

x - int значение, которое будет напечатано

println

public void println(long x)

Печатает длинное целое и затем завершает строку. Этот метод ведет себя, как если бы он вызывает print(long) и затем println().

Параметры:

x - long значение, которое будет напечатано

println

public void println(float x)

Печатает число с плавающей точкой и затем завершает строку. Этот метод ведет себя, как если бы он вызывает print(float) и затем println().

Параметры:

x - float значение, которое будет напечатано

println

public void println(double x)

Печатает двойную точность число с плавающей точкой и затем завершает строку. Этот метод ведет себя, как если бы он вызывает print(double) и затем println().

Параметры:

x - double значение, которое будет напечатано

println

public void println(char[] x)

Печатает массив символов и затем завершает строку. Этот метод ведет себя, как если бы он вызывает print(char[]) и затем println().

Параметры:

x - массив char значения, которые будут напечатаны

println

public void println(String x)

Печатает Строку и затем завершает строку. Этот метод ведет себя, как если бы он вызывает print(String) и затем println().

Параметры:

x - String значение, которое будет напечатано

println

public void println(Object x)

Печатает Объект и затем завершает строку. Это вызовы метода сначала String.valueOf (x), чтобы получить строковое значение печатного объекта, затем ведет себя, как если бы это вызывает print(String) и затем println().

Параметры:

x - Object быть напечатанным.

printf

public PrintWriter printf(String format,
                          Object... args)

Метод удобства, чтобы записать отформатированную строку этому писателю, использующему указанную строку формата и параметры. Если автоматическое сбрасывание включается, призывает к этому методу, сбросит буфер вывода.

Вызов этого метода формы out.printf(format, args) ведет себя точно таким же образом как вызов

     out.format(format, args) 

Параметры:

format - Строка формата как описано в Формате представляет синтаксис в виде строки.

args - На параметры ссылаются спецификаторы формата в строке формата. Если есть больше параметров чем спецификаторы формата, дополнительные параметры игнорируются. Число параметров является переменным и может быть нулем. Максимальное количество параметров ограничивается максимальной размерностью массива Java как определено Спецификацией Виртуальной машины Java™. Поведение на параметре null зависит от преобразования.

Возвраты:

Этот писатель

Броски:

IllegalFormatException - Если строка формата содержит недопустимый синтаксис, спецификатор формата, который является несовместимым с данными параметрами, недостаточные параметры, данные строку формата, или другие недопустимые условия. Для спецификации всех возможных ошибок форматирования см. раздел Деталей спецификации средства форматирования class.

NullPointerException - Если format является null

С тех пор:

1.5

printf

public PrintWriter printf(Locale l,
                          String format,
                          Object... args)

Метод удобства, чтобы записать отформатированную строку этому писателю, использующему указанную строку формата и параметры. Если автоматическое сбрасывание включается, призывает к этому методу, сбросит буфер вывода.

Вызов этого метода формы out.printf(l, format, args) ведет себя точно таким же образом как вызов

     out.format(l, format, args) 

Параметры:

l - Локаль, чтобы применяться во время форматирования. Если l является null тогда, никакая локализация не применяется.

format - Строка формата как описано в Формате представляет синтаксис в виде строки.

args - На параметры ссылаются спецификаторы формата в строке формата. Если есть больше параметров чем спецификаторы формата, дополнительные параметры игнорируются. Число параметров является переменным и может быть нулем. Максимальное количество параметров ограничивается максимальной размерностью массива Java как определено Спецификацией Виртуальной машины Java™. Поведение на параметре null зависит от преобразования.

Возвраты:

Этот писатель

Броски:

IllegalFormatException - Если строка формата содержит недопустимый синтаксис, спецификатор формата, который является несовместимым с данными параметрами, недостаточные параметры, данные строку формата, или другие недопустимые условия. Для спецификации всех возможных ошибок форматирования см. раздел Деталей спецификации средства форматирования class.

NullPointerException - Если format является null

С тех пор:

1.5

формат

public PrintWriter format(String format,
                          Object... args)

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

Локаль, всегда используемая, является той, возвращенной Locale.getDefault(), независимо от любых предыдущих вызовов других методов форматирования на этом объекте.

Параметры:

format - Строка формата как описано в Формате представляет синтаксис в виде строки.

args - На параметры ссылаются спецификаторы формата в строке формата. Если есть больше параметров чем спецификаторы формата, дополнительные параметры игнорируются. Число параметров является переменным и может быть нулем. Максимальное количество параметров ограничивается максимальной размерностью массива Java как определено Спецификацией Виртуальной машины Java™. Поведение на параметре null зависит от преобразования.

Возвраты:

Этот писатель

Броски:

IllegalFormatException - Если строка формата содержит недопустимый синтаксис, спецификатор формата, который является несовместимым с данными параметрами, недостаточные параметры, данные строку формата, или другие недопустимые условия. Для спецификации всех возможных ошибок форматирования см. раздел Деталей Средства форматирования спецификация class.

NullPointerException - Если format является null

С тех пор:

1.5

формат

public PrintWriter format(Locale l,
                          String format,
                          Object... args)

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

Параметры:

l - Локаль, чтобы применяться во время форматирования. Если l является null тогда, никакая локализация не применяется.

format - Строка формата как описано в Формате представляет синтаксис в виде строки.

args - На параметры ссылаются спецификаторы формата в строке формата. Если есть больше параметров чем спецификаторы формата, дополнительные параметры игнорируются. Число параметров является переменным и может быть нулем. Максимальное количество параметров ограничивается максимальной размерностью массива Java как определено Спецификацией Виртуальной машины Java™. Поведение на параметре null зависит от преобразования.

Возвраты:

Этот писатель

Броски:

IllegalFormatException - Если строка формата содержит недопустимый синтаксис, спецификатор формата, который является несовместимым с данными параметрами, недостаточные параметры, данные строку формата, или другие недопустимые условия. Для спецификации всех возможных ошибок форматирования см. раздел Деталей спецификации средства форматирования class.

NullPointerException - Если format является null

С тех пор:

1.5

добавить

public PrintWriter append(CharSequence csq)

Добавляет указанную символьную последовательность этому писателю.

Вызов этого метода формы out.append(csq) ведет себя точно таким же образом как вызов

     out.write(csq.toString()) 

В зависимости от спецификации toString для символьной последовательности csq не может быть добавлена вся последовательность. Например, вызов метода toString символьного буфера возвратит подпоследовательность, контент которой зависит от позиции буфера и предела.

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

append в интерфейсе Appendable

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

append в class Writer

Параметры:

csq - Символьная последовательность, чтобы добавить. Если csq является null, то эти четыре символа "null" добавляются этому писателю.

Возвраты:

Этот писатель

С тех пор:

1.5

добавить

public PrintWriter append(CharSequence csq,
                          int start,
                          int end)

Добавляет подпоследовательность указанной символьной последовательности этому писателю.

Вызов этого метода формы out.append(csq, start, end), когда csq не является null, ведет себя точно таким же образом как вызов

     out.write(csq.subSequence(start, end).toString()) 

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

append в интерфейсе Appendable

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

append в class Writer

Параметры:

csq - Символьная последовательность, от которой будет добавлена подпоследовательность. Если csq будет null, то символы будут добавлены как будто csq, содержавший эти четыре символа "null".

start - Индексирование первого символа в подпоследовательности

end - Индексирование символа после последнего знака в подпоследовательности

Возвраты:

Этот писатель

Броски:

IndexOutOfBoundsException - Если start или end отрицательны, start больше чем end, или end больше чем csq.length()

С тех пор:

1.5

добавить

public PrintWriter append(char c)

Добавляет указанный символ этому писателю.

Вызов этого метода формы out.append(c) ведет себя точно таким же образом как вызов

     out.write(c) 

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

append в интерфейсе Appendable

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

append в class Writer

Параметры:

c - 16-разрядный символ, чтобы добавить

Возвраты:

Этот писатель

С тех пор:

1.5