compact1, compact2, compact3

java.io

Класс PrintStream

java.lang. Объект

java.io. OutputStream

java.io. FilterOutputStream

java.io. PrintStream

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

Closeable, Flushable, Appendable, AutoCloseable

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

LogStream

public class PrintStream
extends FilterOutputStream
implements Appendable, Closeable

A PrintStream добавляет функциональность к другому потоку вывода, а именно, возможность напечатать представления различных значений данных удобно. Две других функции обеспечиваются также. В отличие от других потоков вывода, a PrintStream никогда броски IOException; вместо этого, исключительные ситуации просто набор внутренний флаг, который может быть протестирован через checkError метод. Дополнительно, a PrintStream может быть создан, чтобы сбросить автоматически; это означает что flush метод автоматически вызывается после того, как байтовый массив пишется, один из println методы вызываются, или символ новой строки или байт ('\n') пишется.

Все символы напечатаны a PrintStream преобразовываются в байты, используя кодировку символов значения по умолчанию платформы. PrintWriter class должен использоваться в ситуациях, которые требуют символов записи, а не байтов.

С тех пор:

JDK1.0

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

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

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

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

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

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

Модификатор и Тип	Метод и Описание
PrintStream	append(char c) Добавляет указанный символ к этому потоку вывода.
PrintStream	append(CharSequence csq) Добавляет указанную символьную последовательность к этому потоку вывода.
PrintStream	append(CharSequence csq, int start, int end) Добавляет подпоследовательность указанной символьной последовательности к этому потоку вывода.
boolean	checkError() Сбрасывает поток и проверяет его ошибочное состояние.
protected void	clearError() Очищает внутреннее ошибочное состояние этого потока.
void	close() Закрывает поток.
void	flush() Сбрасывает поток.
PrintStream	format(Locale l, String format, Object... args) Пишет отформатированная строка в этот поток вывода, используя указанную строку формата и параметры.
PrintStream	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) Печатает строку.
PrintStream	printf(Locale l, String format, Object... args) Метод удобства, чтобы записать отформатированную строку в этот поток вывода, используя указанную строку формата и параметры.
PrintStream	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() Устанавливает ошибочное состояние потока к true.
void	write(byte[] buf, int off, int len) Записи len байты от указанного байтового массива, запускающегося при смещении off к этому потоку.
void	write(int b) Пишет указанный байт в этот поток.

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

записать

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

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

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

PrintStream

public PrintStream(OutputStream out)

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

Параметры:

out - Поток вывода, к которому будут напечатаны значения и объекты

См. Также:

PrintWriter.PrintWriter(java.io.OutputStream)

PrintStream

public PrintStream(OutputStream out,
                   boolean autoFlush)

Создает новый поток печати.

Параметры:

out - Поток вывода, к которому будут напечатаны значения и объекты

autoFlush - Булево; если это правда, буфер вывода будет сброшен всякий раз, когда байтовый массив пишется, один из println методы вызываются, или символ новой строки или байт ('\n') пишется

См. Также:

PrintWriter.PrintWriter(java.io.OutputStream, boolean)

PrintStream

public PrintStream(OutputStream out,
                   boolean autoFlush,
                   String encoding)
            throws UnsupportedEncodingException

Создает новый поток печати.

Параметры:

out - Поток вывода, к которому будут напечатаны значения и объекты

autoFlush - Булево; если это правда, буфер вывода будет сброшен всякий раз, когда байтовый массив пишется, один из println методы вызываются, или символ новой строки или байт ('\n') пишется

encoding - Имя поддерживаемой кодировки символов

Броски:

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

С тех пор:

1.4

PrintStream

public PrintStream(String fileName)
            throws FileNotFoundException

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

Параметры:

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

Броски:

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

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

С тех пор:

1.5

PrintStream

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

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

Параметры:

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

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

Броски:

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

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

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

С тех пор:

1.5

PrintStream

public PrintStream(File file)
            throws FileNotFoundException

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

Параметры:

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

Броски:

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

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

С тех пор:

1.5

PrintStream

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

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

Параметры:

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

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

Броски:

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

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

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

С тех пор:

1.5

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

сброс

public void flush()

Сбрасывает поток. Это делается при записи любых буферизованных выходных байтов в базовый поток вывода и затем сбрасывая тот поток.

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

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

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

flush в class FilterOutputStream

См. Также:

OutputStream.flush()

близко

public void close()

Закрывает поток. Это делается, сбрасывая поток и затем закрывая базовый поток вывода.

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

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

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

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

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

close в class FilterOutputStream

См. Также:

OutputStream.close()

checkError

public boolean checkError()

Сбрасывает поток и проверяет его ошибочное состояние. Внутреннее ошибочное состояние устанавливается в true когда базовый поток вывода бросает IOException кроме InterruptedIOException, и когда setError метод вызывается. Если работа на базовом потоке вывода бросает InterruptedIOException, тогда PrintStream преобразовывает исключение назад в прерывание, делая:

     Thread.currentThread().interrupt();
 

или эквивалент.

Возвраты:

true если и только если этот поток встретился IOException кроме InterruptedIOException, или setError метод был вызван

setError

protected void setError()

Устанавливает ошибочное состояние потока к true.

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

С тех пор:

JDK1.1

clearError

protected void clearError()

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

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

С тех пор:

1.6

записать

public void write(int b)

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

Отметьте, что байт пишется как дано; чтобы записать символ, который будет преобразован согласно кодировке символов значения по умолчанию платформы, используйте print(char) или println(char) методы.

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

write в class FilterOutputStream

Параметры:

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

См. Также:

print(char), println(char)

записать

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

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

Отметьте, что байты будут записаны как дано; чтобы записать символы, которые будут преобразованы согласно кодировке символов значения по умолчанию платформы, используйте print(char) или println(char) методы.

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

write в class FilterOutputStream

Параметры:

buf - Байтовый массив

off - Смещение, от которого можно начать брать байты

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

См. Также:

FilterOutputStream.write(int)

печать

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 - массив случайных работ, чтобы напечатать.

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 PrintStream 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 PrintStream 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 PrintStream format(String format,
                          Object... args)

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

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

Параметры:

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

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

Возвраты:

Этот поток вывода

Броски:

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

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

С тех пор:

1.5

формат

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

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

Параметры:

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

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

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

Возвраты:

Этот поток вывода

Броски:

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

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

С тех пор:

1.5

добавить

public PrintStream append(CharSequence csq)

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

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

     out.print(csq.toString()) 

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

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

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

Параметры:

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

Возвраты:

Этот поток вывода

С тех пор:

1.5

добавить

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

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

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

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

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

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

Параметры:

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

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

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

Возвраты:

Этот поток вывода

Броски:

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

С тех пор:

1.5

добавить

public PrintStream append(char c)

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

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

     out.print(c) 

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

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

Параметры:

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

Возвраты:

Этот поток вывода

С тех пор:

1.5