Класс 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, если он включён, а не при каждом выводе символа новой строки. Эти методы используют системный разделитель строк платформы, а не символ новой строки.

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

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

Начиная с версии:: 1.1

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

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

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

lock

Модификатор и тип	Поле	Описание
`protected Object`	`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)`	Выводит объект Object и завершает строку.
`void`	`println(String x)`	Выводит строку String и завершает строку.
`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)`	Записывает часть строки.

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

nullWriter

Модификатор и тип	Метод	Описание
`static Writer`	`nullWriter()`	Возвращает новый `Writer`, отбрасывающий все символы.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Определяет, является ли другой объект равным этому.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного времени.

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

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 — если указанная строка не обозначает существующий доступный для записи обычный файл и невозможно создать новый обычный файл с таким именем либо при открытии или создании файла возникает другая ошибка

Начиная с:

1.5

См. также:

PrintWriter

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

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

Параметры:: fileName — имя файла, используемого в качестве назначения для этого средства записи. Если файл существует, его размер будет усечен до нуля; в противном случае будет создан новый файл. Вывод записывается в файл и буферизуется.; csn — имя поддерживаемой кодировки
Выбрасывает:: FileNotFoundException — если указанная строка не обозначает существующий доступный для записи обычный файл и невозможно создать новый обычный файл с таким именем либо при открытии или создании файла возникает другая ошибка; UnsupportedEncodingException — если указанная кодировка не поддерживается
Начиная с:: 1.5

PrintWriter

public PrintWriter(String fileName, Charset charset) throws IOException

Параметры:: fileName — имя файла, используемого в качестве назначения для этого средства записи. Если файл существует, его размер будет усечен до нуля; в противном случае будет создан новый файл. Вывод записывается в файл и буферизуется.; charset — кодировка
Выбрасывает:: IOException — если при открытии или создании файла возникает ошибка ввода-вывода
Начиная с:: 10

PrintWriter

public PrintWriter(File file) throws FileNotFoundException

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

Параметры:

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

Выбрасывает:

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

Начиная с:

1.5

См. также:

PrintWriter

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

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

Параметры:: file — файл, используемый в качестве назначения для этого средства записи. Если файл существует, его размер будет усечен до нуля; в противном случае будет создан новый файл. Вывод записывается в файл и буферизуется.; csn — имя поддерживаемой кодировки
Выбрасывает:: FileNotFoundException — если указанный объект файла не обозначает существующий доступный для записи обычный файл и невозможно создать новый обычный файл с таким именем либо при открытии или создании файла возникает другая ошибка; UnsupportedEncodingException — если указанная кодировка не поддерживается
Начиная с:: 1.5

PrintWriter

public PrintWriter(File file, Charset charset) throws IOException

Параметры:: file — файл, используемый в качестве назначения для этого средства записи. Если файл существует, его размер будет усечен до нуля; в противном случае будет создан новый файл. Вывод записывается в файл и буферизуется.; charset — кодировка
Выбрасывает:: IOException — если при открытии или создании файла возникает ошибка ввода-вывода
Начиная с:: 10

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

flush

public void flush()

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

Определено в:

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

Определено в:

flush в классе Writer

См. также:

close

public void close()

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

Определено в:

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

Определено в:

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

Определено в:

close в классе Writer

См. также:

checkError

public boolean checkError()

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

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

setError

protected void setError()

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

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

clearError

protected void clearError()

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

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

Начиная с:: 1.6

write

public void write(int c)

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

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

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 — boolean для вывода

См. также:

print

public void print(char c)

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

Параметры:

c — char для вывода

См. также:

print

public void print(int i)

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

Параметры:

i — int для вывода

См. также:

print

public void print(long l)

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

Параметры:

l — long для вывода

См. также:

print

public void print(float f)

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

Параметры:

f — float для вывода

См. также:

print

public void print(double d)

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

Параметры:

d — double для вывода

См. также:

print

public void print(char[] s)

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

Параметры:

s — массив символов для вывода

Выбрасывает:

NullPointerException — если s равен null

См. также:

print

public void print(String s)

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

Параметры:

s — String для вывода

См. также:

print

public void print(Object obj)

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

Параметры:

obj — Object для вывода

См. также:

println

public void println()

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

println

public void println(boolean x)

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

Параметры:: x — значение типа boolean для вывода

println

public void println(char x)

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

Параметры:: x — значение типа char для вывода

println

public void println(int x)

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

Параметры:: x — значение типа int для вывода

println

public void println(long x)

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

Параметры:: x — значение типа long для вывода

println

public void println(float x)

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

Параметры:: x — значение типа float для вывода

println

public void println(double x)

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

Параметры:: x — значение типа double для вывода

println

public void println(char[] x)

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

Параметры:: x — массив значений типа char для вывода

println

public void println(String x)

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

Параметры:: x — значение типа String для вывода

println

public void println(Object x)

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

Параметры:: x — Object для вывода.

printf

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

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

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

    out.format(format, args)

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

printf

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

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

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

    out.format(l, format, args)

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

format

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

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

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

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

format

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

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

append

public PrintWriter append(CharSequence csq)

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

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

    out.write(csq.toString())

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

Определено в:: append в интерфейсе Appendable
Переопределяет:: append в классе Writer
Параметры:: csq — последовательность символов для добавления. Если csq имеет значение null, в этот поток вывода добавляются четыре символа "null".
Возвращает:: Этот поток вывода
С версии:: 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())

Определено в:: append в интерфейсе Appendable
Переопределяет:: append в классе Writer
Параметры:: csq — последовательность символов, из которой будет добавлена подпоследовательность. Если csq имеет значение null, символы будут добавлены так, как если бы csq содержал четыре символа "null".; start — индекс первого символа в подпоследовательности; end — индекс символа, следующего за последним символом в подпоследовательности
Возвращает:: Этот поток вывода
Вызывает:: IndexOutOfBoundsException — если start или end отрицательны, start больше end или end больше csq.length()
С версии:: 1.5

append

public PrintWriter append(char c)

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

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

    out.write(c)

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

© 1993, 2025, 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.