Класс PrintWriter

java.lang.Object

java.io.Writer

java.io.PrintWriter

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

public class PrintWriter extends Writer

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

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

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

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

С тех пор:: 1.1

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

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

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

lock

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

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

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

Модификатор и тип	Метод	Описание
`PrintWriter`	`append(char c)`	Добавляет указанный символ в этот writer.
`PrintWriter`	`append(CharSequence csq)`	Добавляет указанную последовательность символов в этот writer.
`PrintWriter`	`append(CharSequence csq, int start, int end)`	Добавляет подпоследовательность указанной последовательности символов в этот writer.
`boolean`	`checkError()`	Очищает поток, если он не закрыт, и проверяет состояние ошибки.
`protected void`	`clearError()`	Очищает состояние ошибки этого потока.
`void`	`close()`	Закрывает поток и освобождает любые системные ресурсы, связанные с ним.
`void`	`flush()`	Очищает поток.
`PrintWriter`	`format(String format, Object... args)`	Записывает отформатированную строку в этот writer с помощью указанной строки формата и аргументов.
`PrintWriter`	`format(Locale l, String format, Object... args)`	Записывает отформатированную строку в этот writer с помощью указанной строки формата и аргументов.
`void`	`print(boolean b)`	Печатает значение boolean.
`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(String format, Object... args)`	Удобный метод для записи отформатированной строки в этот writer с использованием указанной строки формата и аргументов.
`PrintWriter`	`printf(Locale l, String format, Object... args)`	Удобный метод для записи отформатированной строки в этот writer с использованием указанной строки формата и аргументов.
`void`	`println()`	Завершает текущую строку, записав строку разделителя строк.
`void`	`println(boolean x)`	Печатает значение boolean и затем завершает строку.
`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(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)`	Записывает часть строки.

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

nullWriter

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

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

Подробное описание полей

out

protected Writer out

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

С момента:: 1.2

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

PrintWriter

public PrintWriter(Writer out)

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

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

PrintWriter

public PrintWriter(Writer out, boolean autoFlush)

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

Параметры:: out - Поток вывода символов; autoFlush - Булево значение; если true, методы println, printf, или format будут сбрасывать буфер вывода

PrintWriter

public PrintWriter(OutputStream out)

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

Параметры:

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

См. также:

PrintWriter

public PrintWriter(OutputStream out, boolean autoFlush)

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

Параметры:

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

autoFlush - Булево значение; если true, методы println, printf, или format будут сбрасывать буфер вывода

См. также:

PrintWriter

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

Параметры:: out - Поток вывода; autoFlush - Булево значение; если true, методы println, printf, или format будут сбрасывать буфер вывода; charset - Кодировка
С момента:: 10

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

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

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

PrintWriter

public PrintWriter(File file, Charset charset) throws IOException

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

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

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

flush

public void flush()

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

Specified by:

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

Specified by:

flush в классе Writer

See Also:

close

public void close()

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

Specified by:

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

Specified by:

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

Specified by:

close в классе Writer

See Also:

checkError

public boolean checkError()

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

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

setError

protected void setError()

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

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

clearError

protected void clearError()

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

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

Since:: 1.6

write

public void write(int c)

Записывает один символ.

Overrides:: write в классе Writer
Parameters:: c - целое число, определяющее символ для записи.

write

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

Записывает часть массива символов.

Specified by:: write в классе Writer
Parameters:: buf - Массив символов; off - Смещение, с которого следует начать запись символов; len - Количество символов для записи
Throws:: IndexOutOfBoundsException - Если значения параметров off и len вызывают соответствующий метод базового Writer для выброса IndexOutOfBoundsException

write

public void write(char[] buf)

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

Overrides:: write в классе Writer
Parameters:: buf - Массив символов для записи

write

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

Записывает часть строки.

Overrides:: write в классе Writer
Parameters:: s - Строка; off - Смещение, с которого следует начать запись символов; len - Количество символов для записи
Throws:: IndexOutOfBoundsException - Если значения параметров off и len вызывают соответствующий метод базового Writer для выброса IndexOutOfBoundsException

write

public void write(String s)

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

Overrides:: write в классе Writer
Parameters:: s - Записываемая строка

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)

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

Parameters:

l - Печатаемое целое число типа long

See Also:

print

public void print(float f)

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

Parameters:

f - Печатаемое число с плавающей запятой

See Also:

print

public void print(double d)

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

Parameters:

d - Печатаемое число с двойной точностью

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()

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

println

public void println(boolean x)

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

Parameters:: x - Булево значение для вывода

println

public void println(char x)

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

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

println

public void println(int x)

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

Parameters:: x - Целое число для вывода

println

public void println(long x)

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

Parameters:: x - Значение типа long для вывода

println

public void println(float x)

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

Parameters:: x - Число с плавающей точкой для вывода

println

public void println(double x)

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

Parameters:: x - Число с двойной точностью для вывода

println

public void println(char[] x)

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

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

println

public void println(String x)

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

Parameters:: x - Строка для вывода

println

public void println(Object x)

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

Parameters:: x - Объект для вывода.

printf

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

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

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

    out.format(format, args)

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

printf

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

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

    out.format(l, format, args)

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

format

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

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

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

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

format

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

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

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

append

public PrintWriter append(CharSequence csq)

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

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

    out.write(csq.toString())

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

Specified by:: append в интерфейсе Appendable
Overrides:: append в классе Writer
Parameters:: csq - Последовательность символов для добавления. Если csq равно null, то в этот поток добавляются четыре символа "null".
Returns:: Этот поток
Since:: 1.5

append

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

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

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

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

Specified by:: append в интерфейсе Appendable
Overrides:: append в классе Writer
Parameters:: csq - Последовательность символов, из которой будет добавлена подпоследовательность. Если csq равно null, то символы будут добавлены так, как будто csq содержал четыре символа "null".; start - Индекс первого символа в подпоследовательности; end - Индекс символа, следующего за последним символом в подпоследовательности
Returns:: Этот поток
Throws:: IndexOutOfBoundsException - Если start или end отрицательны, start больше end, или end больше csq.length()
Since:: 1.5

append

public PrintWriter append(char c)

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

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

    out.write(c)

Specified by:: append в интерфейсе Appendable
Overrides:: append в классе Writer
Parameters:: c - Символ 16-разрядной кодировки для добавления
Returns:: Этот поток
Since:: 1.5

© 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/PrintWriter.html