Spec-Zone.ru › OpenJDK 24

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

Поля, объявленные в классе 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()
Устанавливает состояние ошибки потока в 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.
Since:
1.2

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

PrintWriter

public PrintWriter(Writer out)
Создаёт новый PrintWriter без автоматической очистки строки.
Parameters:
out - Поток символьного вывода

PrintWriter

public PrintWriter(Writer out, boolean autoFlush)
Создаёт новый PrintWriter.
Parameters:
out - Поток символьного вывода
autoFlush - Логическое значение; если true, методы println, printf или format очистят буфер вывода

PrintWriter

public PrintWriter(OutputStream out)
Создаёт новый PrintWriter без автоматической очистки строки из существующего OutputStream. Этот конструктор-удобство создаёт необходимый промежуточный OutputStreamWriter, который будет преобразовывать символы в байты, используя кодировку по умолчанию, или, если out является PrintStream, кодировку, используемую потоком вывода.
Parameters:
out - Поток вывода
See Also:
  • OutputStreamWriter(OutputStream)
  • Charset.defaultCharset()

PrintWriter

public PrintWriter(OutputStream out, boolean autoFlush)
Создаёт новый PrintWriter из существующего OutputStream. Этот конструктор-удобство создаёт необходимый промежуточный OutputStreamWriter, который будет преобразовывать символы в байты, используя кодировку по умолчанию, или, если out является PrintStream, кодировку, используемую потоком вывода.
Parameters:
out - Поток вывода
autoFlush - Логическое значение; если true, методы println, printf или format очистят буфер вывода
See Also:
  • OutputStreamWriter(OutputStream)
  • Charset.defaultCharset()

PrintWriter

public PrintWriter(OutputStream out, boolean autoFlush, Charset charset)
Создаёт новый PrintWriter из существующего OutputStream. Этот конструктор-удобство создаёт необходимый промежуточный OutputStreamWriter, который будет преобразовывать символы в байты, используя указанную кодировку.
Parameters:
out - Поток вывода
autoFlush - Логическое значение; если true, методы println, printf или format очистят буфер вывода
charset - кодировка
Since:
10

PrintWriter

public PrintWriter(String fileName) throws FileNotFoundException
Создаёт новый PrintWriter без автоматической очистки строки с указанным именем файла. Этот конструктор-удобство создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы, используя кодировку по умолчанию для этой инстанции Java виртуальной машины.
Parameters:
fileName - Имя файла, используемого в качестве пункта назначения этого пишущего объекта. Если файл существует, он будет обнулен до нулевого размера; в противном случае будет создан новый файл. Вывод будет записываться в файл и будет буферизован.
Throws:
FileNotFoundException - Если заданная строка не обозначает существующий, доступный для записи обычный файл, и новый обычный файл с таким именем не может быть создан, или если произошла другая ошибка при открытии или создании файла
Since:
1.5
See Also:
  • Charset.defaultCharset()

PrintWriter

public PrintWriter(String fileName, String csn) throws FileNotFoundException, UnsupportedEncodingException
Создаёт новый PrintWriter без автоматической очистки строки с указанным именем файла и кодировкой. Этот конструктор-удобство создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы, используя предоставленную кодировку.
Parameters:
fileName - Имя файла, используемого в качестве пункта назначения этого пишущего объекта. Если файл существует, он будет обнулен до нулевого размера; в противном случае будет создан новый файл. Вывод будет записываться в файл и будет буферизован.
csn - Имя поддерживаемой кодировки
Throws:
FileNotFoundException - Если заданная строка не обозначает существующий, доступный для записи обычный файл, и новый обычный файл с таким именем не может быть создан, или если произошла другая ошибка при открытии или создании файла
UnsupportedEncodingException - Если указанная кодировка не поддерживается
Since:
1.5

PrintWriter

public PrintWriter(String fileName, Charset charset) throws IOException
Создаёт новый PrintWriter без автоматической очистки строки с указанным именем файла и кодировкой. Этот конструктор-удобство создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы, используя предоставленную кодировку.
Parameters:
fileName - Имя файла, используемого в качестве пункта назначения этого пишущего объекта. Если файл существует, он будет обнулен до нулевого размера; в противном случае будет создан новый файл. Вывод будет записываться в файл и будет буферизован.
charset - кодировка
Throws:
IOException - если произошла ошибка ввода-вывода при открытии или создании файла
Since:
10

PrintWriter

public PrintWriter(File file) throws FileNotFoundException
Создаёт новый PrintWriter без автоматической очистки строки с указанным файлом. Этот конструктор-удобство создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы, используя кодировку по умолчанию для этой инстанции Java виртуальной машины.
Parameters:
file - Файл, используемый в качестве пункта назначения этого пишущего объекта. Если файл существует, он будет обнулен до нулевого размера; в противном случае будет создан новый файл. Вывод будет записываться в файл и будет буферизован.
Throws:
FileNotFoundException - Если данный объект файла не обозначает существующий, доступный для записи обычный файл, и новый обычный файл с таким именем не может быть создан, или если произошла другая ошибка при открытии или создании файла
Since:
1.5
See Also:
  • Charset.defaultCharset()

PrintWriter

public PrintWriter(File file, String csn) throws FileNotFoundException, UnsupportedEncodingException
Создаёт новый PrintWriter без автоматической очистки строки с указанным файлом и кодировкой. Этот конструктор-удобство создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы, используя предоставленную кодировку.
Parameters:
file - Файл, используемый в качестве пункта назначения этого пишущего объекта. Если файл существует, он будет обнулен до нулевого размера; в противном случае будет создан новый файл. Вывод будет записываться в файл и будет буферизован.
csn - Имя поддерживаемой кодировки
Throws:
FileNotFoundException - Если данный объект файла не обозначает существующий, доступный для записи обычный файл, и новый обычный файл с таким именем не может быть создан, или если произошла другая ошибка при открытии или создании файла
UnsupportedEncodingException - Если указанная кодировка не поддерживается
Since:
1.5

PrintWriter

public PrintWriter(File file, Charset charset) throws IOException
Создаёт новый PrintWriter без автоматической очистки строки с указанным файлом и кодировкой. Этот конструктор-удобство создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы, используя предоставленную кодировку.
Parameters:
file - Файл, используемый в качестве пункта назначения этого пишущего объекта. Если файл существует, он будет обнулен до нулевого размера; в противном случае будет создан новый файл. Вывод будет записываться в файл и будет буферизован.
charset - кодировка
Throws:
IOException - если произошла ошибка ввода-вывода при открытии или создании файла
Since:
10

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

очистка

public void flush()
Очищает поток.
Указано в:
flush в интерфейсе Flushable
Указано в:
flush в классе Writer
См. также:
  • checkError()

закрыть

public void close()
Закрывает поток и освобождает любые системные ресурсы, связанные с ним. Закрытие ранее закрытого потока не оказывает никакого эффекта.
Указано в:
close в интерфейсе AutoCloseable
Указано в:
close в интерфейсе Closeable
Указано в:
close в классе Writer
См. также:
  • checkError()

checkError

public boolean checkError()
Очищает поток, если он не закрыт, и проверяет состояние ошибки.
Возвращает:
true тогда и только тогда, когда этот поток столкнулся с IOException или метод setError был вызван

установитьОшибку

protected void setError()
Устанавливает состояние ошибки потока в true.

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

очиститьОшибку

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

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

С:
1.6

записать

public void write(int c)
Записывает один символ.
Переопределяет:
write в классе Writer
Параметры:
c - целое число, определяющее символ, который нужно записать.

записать

public void write(char[] buf, int off, int len)
Записывает часть массива символов.
Указано в:
write в классе Writer
Параметры:
buf - Массив символов
off - Смещение, с которого следует начать запись символов
len - Количество символов для записи
Исключения:
IndexOutOfBoundsException - Если значения параметров off и len вызывают соответствующий метод базового Writer сброс IndexOutOfBoundsException

записать

public void write(char[] buf)
Записывает массив символов. Этот метод не может быть унаследован от класса Writer, потому что он должен подавлять исключения ввода-вывода.
Переопределяет:
write в классе Writer
Параметры:
buf - Массив символов, подлежащих записи

записать

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

записать

public void write(String s)
Записывает строку. Этот метод не может быть унаследован от класса Writer, потому что он должен подавлять исключения ввода-вывода.
Переопределяет:
write в классе Writer
Параметры:
s - Строка, подлежащая записи

вывести

public void print(boolean b)
Выводит значение типа boolean. Строка, созданная методом String.valueOf(boolean), преобразуется в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Параметры:
b - Значение boolean, подлежащее выводу
См. также:
  • Charset.defaultCharset()

вывести

public void print(char c)
Выводит символ. Символ преобразуется в один или несколько байтов в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Параметры:
c - Символ, подлежащий выводу
См. также:
  • Charset.defaultCharset()

вывести

public void print(int i)
Выводит целое число. Строка, созданная методом String.valueOf(int), преобразуется в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Параметры:
i - Целое число, подлежащее выводу
См. также:
  • Integer.toString(int)
  • Charset.defaultCharset()

вывести

public void print(long l)
Выводит целое число типа long. Строка, созданная методом String.valueOf(long), преобразуется в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Параметры:
l - Длинное целое число, подлежащее выводу
См. также:
  • Long.toString(long)
  • Charset.defaultCharset()

вывести

public void print(float f)
Выводит число с плавающей точкой. Строка, созданная методом String.valueOf(float), преобразуется в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Параметры:
f - Число с плавающей точкой, подлежащее выводу
См. также:
  • Float.toString(float)
  • Charset.defaultCharset()

вывести

public void print(double d)
Выводит число с двойной точностью. Строка, созданная методом String.valueOf(double), преобразуется в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Параметры:
d - Число с двойной точностью, подлежащее выводу
См. также:
  • Double.toString(double)
  • Charset.defaultCharset()

вывести

public void print(char[] s)
Выводит массив символов. Символы преобразуются в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Параметры:
s - Массив символов, подлежащий выводу
Исключения:
NullPointerException - Если s является null
См. также:
  • Charset.defaultCharset()

вывести

public void print(String s)
Выводит строку. Если аргумент равен null, то выводится строка "null". В противном случае символы строки преобразуются в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Параметры:
s - Строка, подлежащая выводу
См. также:
  • Charset.defaultCharset()

Вывод

public void print(Object obj)
Выводит объект. Строка, полученная методом String.valueOf(Object), преобразуется в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как в методе write(int).
Параметры:
obj - Выводимый Object
См. также:
  • Object.toString()
  • Charset.defaultCharset()

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)
Выводит целое число типа long и затем завершает строку. Данный метод работает так, как если бы он вызывал 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 - Если строка формата содержит неверный синтаксис, спецификатор формата несовместим с заданными аргументами, недостаточно аргументов для заданной строки формата или другие неверные условия. Для описания всех возможных ошибок форматирования см. раздел Подробное описание спецификации класса форматировщик.
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

форматировать

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

добавить

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

добавить

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

добавить

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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/io/PrintWriter.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API