Класс 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)

Добавляет указанный символ в этот поток вывода.
PrintWriter append​(CharSequence csq)

Добавляет указанную последовательность символов в этот поток вывода.
PrintWriter append​(CharSequence csq, int start, int end)

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

Очищает поток, если он не закрыт, и проверяет состояние ошибки.
protected void clearError()

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

Закрывает поток и освобождает все связанные с ним системные ресурсы.
void flush()

Очищает поток.
PrintWriter format​(String format, Object... args)

Записывает отформатированную строку в этот поток вывода, используя указанную строку формата и аргументы.
PrintWriter 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)

Выводит длинное целое число.
void print​(Object obj)

Выводит объект.
void print​(String s)

Выводит строку.
PrintWriter printf​(String format, Object... args)

Удобный метод для записи отформатированной строки в этот поток вывода, используя указанную строку формата и аргументы.
PrintWriter 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)

Выводит длинное целое число и затем завершает строку.
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)

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

Методы, объявленные в классе 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 - Поток вывода
См. также:
OutputStreamWriter(java.io.OutputStream)

PrintWriter

public PrintWriter(OutputStream out,
                   boolean autoFlush)

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

Параметры:
out - Поток вывода
autoFlush - Булево значение; если true, методы println, printf, или format будут очищать буфер вывода
См. также:
OutputStreamWriter(java.io.OutputStream)

PrintWriter

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

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

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

PrintWriter

public PrintWriter(String fileName)
            throws FileNotFoundException

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

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

PrintWriter

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

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

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

PrintWriter

public PrintWriter(String fileName,
                   Charset charset)
            throws IOException

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

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

PrintWriter

public PrintWriter(File file)
            throws FileNotFoundException

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

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

PrintWriter

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

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

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

PrintWriter

public PrintWriter(File file,
                   Charset charset)
            throws IOException

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

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

Методы

flush

public void flush()

Очищает поток.

Указано в:
flush в интерфейсе Flushable
Указано в:
flush в классе Writer
См. также:
checkError()

close

public void close()

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

Указано в:
close в интерфейсе AutoCloseable
Указано в:
close в интерфейсе Closeable
Указано в:
close в классе Writer
См. также:
checkError()

checkError

public boolean checkError()

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

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

setError

protected void setError()

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

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

clearError

protected void clearError()

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

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

С:
1.6

write

public void write(int c)

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

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

write

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

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

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

write

public void write(char[] buf)

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

Переопределяет:
write в классе Writer
Параметры:
buf - Массив символов для записи

write

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

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

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

write

public void write(String s)

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

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

print

public void print(boolean b)

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

Параметры:
b - Логическое значение для вывода

print

public void print(char c)

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

Параметры:
c - Символ для вывода

print

public void print(int i)

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

Параметры:
i - Целое число для вывода
См. также:
Integer.toString(int)

print

public void print(long l)

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

Параметры:
l - Длинное целое число для вывода
См. также:
Long.toString(long)

print

public void print(float f)

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

Параметры:
f - Число с плавающей точкой для вывода
См. также:
Float.toString(float)

print

public void print(double d)

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

Параметры:
d - Число двойной точности с плавающей точкой для вывода
См. также:
Double.toString(double)

print

public void print(char[] s)

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

Параметры:
s - Массив символов для вывода
Исключения:
NullPointerException - Если s является null

print

public void print(String s)

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

Параметры:
s - Строка для вывода

print

public void print(Object obj)

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

Параметры:
obj - Объект для вывода
См. также:
Object.toString()

println

public void println()

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

println

public void println(boolean x)

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

Параметры:
x - значение логического типа для вывода

println

public void println(char x)

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

Параметры:
x - значение символьного типа для вывода

println

public void println(int x)

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

Параметры:
x - значение целочисленного типа для вывода

println

public void println(long x)

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

Параметры:
x - значение длинного целочисленного типа для вывода

println

public void println(float x)

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

Параметры:
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™ Virtual Machine. Поведение с null аргументом зависит от преобразования.
Returns:
Этот поток
Throws:
IllegalFormatException - если строка формата содержит неверный синтаксис, спецификатор формата несовместим с заданными аргументами, недостаточно аргументов для строки формата или другие недопустимые условия. Для спецификации всех возможных ошибок форматирования см. раздел Подробное описание спецификации класса форматировщика.
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™ Virtual Machine. Поведение с null аргументом зависит от преобразования.
Returns:
Этот поток
Throws:
IllegalFormatException - если строка формата содержит неверный синтаксис, спецификатор формата несовместим с заданными аргументами, недостаточно аргументов для строки формата или другие недопустимые условия. Для спецификации всех возможных ошибок форматирования см. раздел Подробное описание спецификации класса форматировщика.
NullPointerException - если format является null
Since:
1.5

format

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

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

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

Parameters:
format - строка формата, как описано в синтаксисе строки формата.
args - Аргументы, на которые ссылаются спецификаторы формата в строке формата. Если аргументов больше, чем спецификаторов формата, дополнительные аргументы игнорируются. Количество аргументов переменное и может быть нулевым. Максимальное количество аргументов ограничено максимальным размером массива Java, как определено в Спецификации Java™ Virtual Machine. Поведение с 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™ Virtual Machine. Поведение с null аргументом зависит от преобразования.
Returns:
Этот поток
Throws:
IllegalFormatException - если строка формата содержит неверный синтаксис, спецификатор формата несовместим с заданными аргументами, недостаточно аргументов для строки формата или другие недопустимые условия. Для спецификации всех возможных ошибок форматирования см. раздел Подробное описание спецификации класса форматировщика.
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)
Определено:
append в интерфейсе Appendable
Переопределено:
append в классе Writer
Параметры:
c - Присоединяемый 16-битный символ
Возвращает:
Этот записыватель
С:
1.5

© 1993, 2020, 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/11/docs/api/java.base/java/io/PrintWriter.html

Spec-Zone .ru
спецификации, руководства, описания, API