Класс PrintStream

java.io.PrintStream

Все реализованные интерфейсы:: Closeable, Flushable, Appendable, AutoCloseable

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

public class PrintStream extends FilterOutputStream implements Appendable, Closeable

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

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

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

С:

1.0

См. также:

Краткое описание полей

Поля, объявленные в классе java.io.FilterOutputStream

out

Краткое описание конструкторов

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

Краткое описание методов

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

Методы, объявленные в классе java.io.OutputStream

nullOutputStream

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

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

Подробное описание конструкторов

PrintStream

public PrintStream(OutputStream out)

Создаёт новый поток вывода, без автоматической смены строки, с указанным потоком вывода. Символы, записанные в поток, преобразуются в байты с использованием кодировки по умолчанию или, где out является PrintStream, кодировка, используемая потоком вывода.

Параметры:

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

См. также:

PrintStream

public PrintStream(OutputStream out, boolean autoFlush)

Создаёт новый поток вывода с указанным потоком вывода и сбросом строки. Символы, записанные в поток, преобразуются в байты с использованием кодировки по умолчанию или, где out является PrintStream, кодировка, используемая потоком вывода.

Параметры:

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

autoFlush - Нужно ли сбрасывать буфер вывода при записи массива байтов, вызове одного из println методов или записи символа или байта новой строки ('\n')

См. также:

PrintStream

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

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

Параметры:: out - Поток вывода, в который будут выводиться значения и объекты; autoFlush - Нужно ли сбрасывать буфер вывода при записи массива байтов, вызове одного из println методов или записи символа или байта новой строки ('\n'); encoding - Имя поддерживаемой кодировки символов
Исключения:: UnsupportedEncodingException - Если указанная кодировка не поддерживается
С момента:: 1.4

PrintStream

public PrintStream(OutputStream out, boolean autoFlush, Charset charset)

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

Параметры:: out - Поток вывода, в который будут выводиться значения и объекты; autoFlush - Нужно ли сбрасывать буфер вывода при записи массива байтов, вызове одного из println методов или записи символа или байта новой строки ('\n'); charset - кодировка
С момента:: 10

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(String fileName, Charset charset) throws IOException

Параметры:: fileName - Имя файла, используемого в качестве назначения для этого потока вывода. Если файл существует, он будет обнулен; в противном случае будет создан новый файл. Вывод будет записан в файл и буферизован.; charset - кодировка
Исключения:: IOException - если при открытии или создании файла возникает ошибка ввода-вывода; SecurityException - Если присутствует менеджер безопасности и checkWrite(fileName) запрещает доступ для записи к файлу
С момента:: 10

PrintStream

public PrintStream(File file) throws FileNotFoundException

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

Параметры:

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

Исключения:

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

С момента:

1.5

См. также:

PrintStream

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

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

Параметры:: file - Файл, используемый в качестве назначения для этого потока вывода. Если файл существует, он будет обнулен; в противном случае будет создан новый файл. Вывод будет записан в файл и буферизован.; csn - Имя поддерживаемой кодировки
Исключения:: FileNotFoundException - Если заданный объект файла не обозначает существующий, записываемый обычный файл и новый обычный файл с таким именем не может быть создан, или если возникает какая-либо другая ошибка при открытии или создании файла; SecurityException - Если присутствует менеджер безопасности и checkWrite(file.getPath()) запрещает доступ для записи к файлу; UnsupportedEncodingException - Если указанная кодировка не поддерживается
С момента:: 1.5

PrintStream

public PrintStream(File file, Charset charset) throws IOException

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

Parameters:: file - Файл, используемый в качестве пункта назначения для этого потока вывода. Если файл существует, он будет обнулен до нулевого размера; в противном случае будет создан новый файл. Вывод будет записан в файл и буферизован.; charset - Кодировка
Throws:: IOException - если при открытии или создании файла произошла ошибка ввода-вывода; SecurityException - Если установлен менеджер безопасности и checkWrite(file.getPath()) запрещает доступ на запись в файл
Since:: 10

Подробные сведения о методах

flush

public void flush()

Очищает поток. Это выполняется путём записи всех буферизованных байтов вывода в базовый поток вывода, а затем очистки этого потока.

Specified by:

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

Overrides:

flush в классе FilterOutputStream

See Also:

close

public void close()

Закрывает поток. Это выполняется путём очистки потока, а затем закрытия базового потока вывода.

Specified by:

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

Specified by:

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

Overrides:

close в классе FilterOutputStream

See Also:

checkError

public boolean checkError()

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

Returns:: true тогда и только тогда, когда в этом потоке произошла IOException, или был вызван метод setError

setError

protected void setError()

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

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

Since:: 1.1

clearError

protected void clearError()

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

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

Since:: 1.6

write

public void write(int b)

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

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

Overrides:

write в классе FilterOutputStream

Parameters:

b - Байт, который нужно записать

See Also:

write

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

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

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

Overrides:

write в классе FilterOutputStream

Parameters:

buf - Массив байт

off - Смещение, с которого начинать взятие байтов

len - Количество байт для записи

Throws:

IndexOutOfBoundsException - Если off отрицательное, len отрицательное или len больше, чем b.length - off

See Also:

write

public void write(byte[] buf) throws IOException

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

Overrides:

write в классе FilterOutputStream

API Note:

Хотя объявлен для выбрасывания IOException, этот метод фактически никогда этого не делает. Вместо этого, как и другие методы, переопределённые в этом классе, он устанавливает внутренний флаг, который можно проверить с помощью метода checkError(). Чтобы записать массив байт без необходимости записи блока catch для IOException, используйте либо writeBytes(buf), либо write(buf, 0, buf.length).

Implementation Requirements:

Этот метод эквивалентен this.write(buf, 0, buf.length).

Parameters:

buf - Массив байт

Throws:

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

Since:

See Also:

writeBytes

public void writeBytes(byte[] buf)

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

Implementation Requirements:: Этот метод эквивалентен this.write(buf, 0, buf.length).
Parameters:: buf - Массив байт
Since:: 14

print

public void print(boolean b)

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

Parameters:

b - Булевое значение, подлежащее выводу

See Also:

print

public void print(char c)

Выводит символ. Символ преобразуется в один или несколько байт в соответствии с кодировкой символов, заданной в конструкторе, или по умолчанию, если не указано. Эти байты записываются точно так же, как в методе write(int).

Parameters:

c - Символ, подлежащий выводу

See Also:

print

public void print(int i)

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

Parameters:

i - Целое число, подлежащее выводу

See Also:

print

public void print(long l)

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

Parameters:

l - Длинное целое число, подлежащее выводу

See Also:

print

public void print(float f)

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

Parameters:

f - Выводимое float

See Also:

print

public void print(double d)

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

Parameters:

d - Выводимое double

See Also:

print

public void print(char[] s)

Выводит массив символов. Символы преобразуются в байты в соответствии с кодировкой символов, заданной в конструкторе, или кодировкой по умолчанию, если она не указана. Эти байты записываются точно так же, как и методом write(int).

Parameters:

s - Массив символов для вывода

Throws:

NullPointerException - Если s null

See Also:

print

public void print(String s)

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

Parameters:

s - Выводимая String

See Also:

print

public void print(Object obj)

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

Parameters:

obj - Выводимый Object

See Also:

println

public void println()

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

println

public void println(boolean x)

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

Parameters:: x - Выводимое boolean

println

public void println(char x)

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

Parameters:: x - Выводимый char.

println

public void println(int x)

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

Parameters:: x - Выводимое int.

println

public void println(long x)

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

Parameters:: x - a Выводимое long.

println

public void println(float x)

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

Parameters:: x - Выводимое float.

println

public void println(double x)

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

Parameters:: x - Выводимое double.

println

public void println(char[] x)

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

Parameters:: x - массив символов для вывода.

println

public void println(String x)

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

Parameters:: x - Выводимая String.

println

public void println(Object x)

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

Parameters:: x - Выводимый Object.

printf

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

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

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

    out.format(format, args)

Parameters:: format - Строка формата, как описано в синтаксисе строк формата; args - Аргументы, на которые ссылаются спецификаторы формата в строке формата. Если аргументов больше, чем спецификаторов формата, дополнительные аргументы игнорируются. Количество аргументов переменное и может быть нулевым. Максимальное количество аргументов ограничено максимальным размером массива Java, определённым в Спецификации виртуальной машины Java. Поведение для null аргумента зависит от преобразования.
Returns:: Этот поток вывода
Throws:: IllegalFormatException - Если строка формата содержит некорректный синтаксис, спецификатор формата несовместим с заданными аргументами, недостаточно аргументов для заданной строки формата или другие некорректные условия. Для описания всех возможных ошибок форматирования см. раздел Подробности в спецификации класса форматировщика.; NullPointerException - Если format null
Since:: 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 - Если строка формата содержит неверный синтаксис, спецификатор формата несовместим с заданными аргументами, недостаточно аргументов для строки формата или другие неверные условия. Для спецификации всех возможных ошибок форматирования см. раздел Подробности спецификации класса форматировщик.; NullPointerException - Если format равен null
С:: 1.5

format

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

Записывает отформатированную строку в этот поток вывода с использованием указанной строки формата и аргументов.

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

Параметры:: format - Строка формата, как описано в синтаксисе строки формата; args - Аргументы, на которые ссылаются спецификаторы формата в строке формата. Если аргументов больше, чем спецификаторов формата, лишние аргументы игнорируются. Количество аргументов может быть переменным и равным нулю. Максимальное количество аргументов ограничено максимальным размером массива Java, как определено в Спецификации виртуальной машины Java. Поведение с null аргументом зависит от преобразования.
Возвращает:: Этот поток вывода
Исключения:: IllegalFormatException - Если строка формата содержит неверный синтаксис, спецификатор формата несовместим с заданными аргументами, недостаточно аргументов для строки формата или другие неверные условия. Для спецификации всех возможных ошибок форматирования см. раздел Подробности спецификации класса форматировщик.; NullPointerException - Если format равен null
С:: 1.5

format

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

Параметры:: l - Язык локализации, применяемый при форматировании. Если l равен null, то локализация не применяется.; format - Строка формата, как описано в синтаксисе строки формата; args - Аргументы, на которые ссылаются спецификаторы формата в строке формата. Если аргументов больше, чем спецификаторов формата, лишние аргументы игнорируются. Количество аргументов может быть переменным и равным нулю. Максимальное количество аргументов ограничено максимальным размером массива Java, как определено в Спецификации виртуальной машины Java. Поведение с null аргументом зависит от преобразования.
Возвращает:: Этот поток вывода
Исключения:: IllegalFormatException - Если строка формата содержит неверный синтаксис, спецификатор формата несовместим с заданными аргументами, недостаточно аргументов для строки формата или другие неверные условия. Для спецификации всех возможных ошибок форматирования см. раздел Подробности спецификации класса форматировщик.; NullPointerException - Если format равен null
С:: 1.5

append

public PrintStream append(CharSequence csq)

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

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

    out.print(csq.toString())

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

Установлено для:: append в интерфейсе Appendable
Параметры:: csq - Последовательность символов для добавления. Если csq равно null, то четыре символа "null" добавляются в этот поток вывода.
Возвращает:: Этот поток вывода
С:: 1.5

append

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

append

public PrintStream append(char c)

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

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

    out.print(c)

Установлено для:: append в интерфейсе Appendable
Параметры:: c - Символ 16-битной длины для добавления
Возвращает:: Этот поток вывода
С:: 1.5

charset

public Charset charset()

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

Возвращает:: кодировка символов, используемая в этом экземпляре PrintStream
С:: 18

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/PrintStream.html