Класс PrintStream

Все реализованные интерфейсы:
Closeable, Flushable, Appendable, AutoCloseable
Прямые известные подклассы:
LogStream
public class PrintStream
extends FilterOutputStream
implements Appendable, Closeable

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

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

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

С тех пор:
1.0

Поля

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

out

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

Конструктор Описание
PrintStream​(File file)

Создает новый поток вывода, без автоматического сброса строки, для указанного файла.
PrintStream​(File file, String csn)

Создает новый поток вывода, без автоматического сброса строки, для указанного файла и набора символов.
PrintStream​(File file, Charset charset)

Создает новый поток вывода, без автоматического сброса строки, для указанного файла и набора символов.
PrintStream​(OutputStream out)

Создает новый поток вывода.
PrintStream​(OutputStream out, boolean autoFlush)

Создает новый поток вывода.
PrintStream​(OutputStream out, boolean autoFlush, String encoding)

Создает новый поток вывода.
PrintStream​(OutputStream out, boolean autoFlush, Charset charset)

Создает новый поток вывода с указанным OutputStream, автоматическим сбросом строки и набором символов.
PrintStream​(String fileName)

Создает новый поток вывода, без автоматического сброса строки, для указанного имени файла.
PrintStream​(String fileName, String csn)

Создает новый поток вывода, без автоматического сброса строки, для указанного имени файла и набора символов.
PrintStream​(String fileName, Charset charset)

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

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

Модификатор и тип Метод Описание
PrintStream append​(char c)

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

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

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

Сбрасывает поток и проверяет его состояние ошибки.
protected void clearError()

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

Закрывает поток.
void flush()

Сбрасывает поток.
PrintStream format​(String format, Object... args)

Записывает отформатированную строку в этот поток вывода, используя указанную строку формата и аргументы.
PrintStream format​(Locale l, String format, Object... args)

Записывает отформатированную строку в этот поток вывода, используя указанную строку формата и аргументы.
void print​(boolean b)

Выводит значение булевого типа.
void print​(char c)

Выводит символ.
void print​(char[] s)

Выводит массив символов.
void print​(double d)

Выводит число с двойной точностью.
void print​(float f)

Выводит число с плавающей точкой.
void print​(int i)

Выводит целое число.
void print​(long l)

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

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

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

Удобный метод для записи отформатированной строки в этот поток вывода, используя указанную строку формата и аргументы.
PrintStream printf​(Locale l, String format, Object... args)

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

Завершает текущую строку, записав строку разделителя строк.
void println​(boolean x)

Выводит булево значение и затем завершает строку.
void println​(char x)

Выводит символ и затем завершает строку.
void println​(char[] x)

Выводит массив символов и затем завершает строку.
void println​(double x)

Выводит double и затем завершает строку.
void println​(float x)

Выводит float и затем завершает строку.
void println​(int x)

Выводит целое число и затем завершает строку.
void println​(long x)

Выводит long и затем завершает строку.
void println​(Object x)

Выводит объект и затем завершает строку.
void println​(String x)

Выводит строку и затем завершает строку.
protected void setError()

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

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

Записывает len байта из указанного массива байтов, начиная с смещения off, в этот поток.
void write​(int b)

Записывает указанный байт в этот поток.

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

write

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

nullOutputStream

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

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

Конструкторы

PrintStream

public PrintStream(OutputStream out)

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

Параметры:
out - Поток вывода, в который будут выводиться значения и объекты
См. также:
PrintWriter(java.io.OutputStream)

PrintStream

public PrintStream(OutputStream out,
                   boolean autoFlush)

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

Параметры:
out - Поток вывода, в который будут выводиться значения и объекты
autoFlush - Логическое значение; если true, буфер вывода будет сбрасываться всякий раз, когда записывается массив байтов, вызывается один из println методов, или записывается символ новой строки или байт ('\n')
См. также:
PrintWriter(java.io.OutputStream, boolean)

PrintStream

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

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

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

PrintStream

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

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

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

PrintStream

public PrintStream(String fileName)
            throws FileNotFoundException

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

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

PrintStream

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

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

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

PrintStream

public PrintStream(String fileName,
                   Charset charset)
            throws IOException

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

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

PrintStream

public PrintStream(File file)
            throws FileNotFoundException

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

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

PrintStream

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

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

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

PrintStream

public PrintStream(File file,
                   Charset charset)
            throws IOException

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

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

Методы

flush

public void flush()

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

Указано в:
flush в интерфейсе Flushable
Переопределяет:
flush в классе FilterOutputStream
См. также:
OutputStream.flush()

close

public void close()

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

Указано в:
close в интерфейсе AutoCloseable
Указано в:
close в интерфейсе Closeable
Переопределяет:
close в классе FilterOutputStream
См. также:
OutputStream.close()

checkError

public boolean checkError()

Очищает поток и проверяет состояние ошибки. Внутреннее состояние ошибки устанавливается в true при возникновении в базовом выходном потоке исключения IOException отличного от InterruptedIOException, и при вызове метода setError. Если операция над базовым выходным потоком генерирует исключение InterruptedIOException, то PrintStream преобразует это исключение обратно в прерывание, выполнив: 

Thread.currentThread().interrupt();
или эквивалентную операцию.

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

setError

protected void setError()

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

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

Since:
1.1

clearError

protected void clearError()

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

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

Since:
1.6

write

public void write(int b)

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

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

Переопределяет:
write в классе FilterOutputStream
Параметры:
b - Байты для записи
См. также:
print(char), println(char)

write

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

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

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

Переопределяет:
write в классе FilterOutputStream
Параметры:
buf - Массив байтов
off - Смещение, с которого начать чтение байтов
len - Количество байтов для записи
См. также:
FilterOutputStream.write(int)

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)

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

Параметры:
l - Целое число типа long, которое нужно вывести
См. также:
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)

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

Параметры:
x - Целое число типа long, которое необходимо вывести.

println

public void println(float x)

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

Параметры:
x - Число с плавающей точкой, которое необходимо вывести.

println

public void println(double x)

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

Параметры:
x - Двойное значение, подлежащее выводу.

println

public void println(char[] x)

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

Параметры:
x - массив символов для вывода.

println

public void println(String x)

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

Параметры:
x - Строка, подлежащая выводу.

println

public void println(Object x)

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

Параметры:
x - Объект, подлежащий выводу.

printf

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

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

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

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

printf

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

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

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

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

format

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

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

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

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

format

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

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

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

append

public PrintStream append(CharSequence csq)

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

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

out.print(csq.toString())

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

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

append

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

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

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

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

append

public PrintStream append(char c)

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

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

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

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

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